Caspian SDK
에이전트를 슬랙·텔레그램·메일에 한 handler 로 붙이는 통신 계층
pip install caspian-sdk에이전트 통신 SDK 입니다. 에이전트의 추론이 무엇을 말할지 정한다면 이쪽은 그 말이 어디에 어떻게 존재할지를 맡습니다. 슬랙과 디스코드, 텔레그램, 메일, 왓츠앱, X 같은 통로마다 어댑터를 따로 짜는 대신 통로 하나당 채널 추가 호출 한 번으로 끝냅니다. 저장소는 큰 오픈소스 에이전트 뼈대들이 각각 25개 넘는 채널 어댑터를 직접 만들었고 이슈 트래커의 8에서 15퍼센트를 채널 배관에 쓰고 있다고 지적합니다. 그 배관을 한 처리기로 줄이는 것이 목표입니다. 방식은 두 갈래입니다. 호스팅 방식은 게이트웨이가 들어오는 요청을 받고 내 프로세스가 사건을 받아 갑니다. 자체 호스팅 방식은 내 프로세스와 내 토큰만 씁니다. 디스코드와 슬랙은 공개 웹훅 대신 열린 소켓으로 받을 수도 있습니다. 1.0 판은 전면 재작성이라 공개 표면이 0.6 대와 다릅니다. 라이선스가 AGPL-3.0 이라는 점도 도입 전에 확인해야 합니다.
판단
이럴 때 씁니다
- 에이전트를 사람이 쓰는 채널에 붙일 때
- 채널마다 어댑터를 짜기 싫을 때
- 웹훅 검증과 스레드 처리를 맡기고 싶을 때
이럴 땐 쓰지 마세요
- AGPL-3.0 이 부담이면 피해야 합니다
- 에이전트 사이 통신용이 아닙니다
- 1.0 이 전면 재작성이라 예전 코드가 안 맞습니다
차별점
- 채널마다 처리기를 나누지 않고 하나로 받습니다.
- 웹훅 검증과 스레드 처리, 플랫폼별 특성을 감춥니다.
- 게이트웨이 없이 자체 호스팅으로도 돌릴 수 있습니다.
- 파이썬과 타입스크립트가 같은 계약을 씁니다.
워크플로
- 01파이썬이나 타입스크립트로 설치합니다.
- 02호스팅과 자체 호스팅 중 방식을 고릅니다.
- 03채널 추가 호출로 통로를 붙입니다.
- 04메시지 처리기 하나를 씁니다.
- 05겹침 처리와 확인 응답 같은 규칙을 선언합니다.
주요 명령
| 명령 | 설명 |
|---|---|
pip install caspian-sdk | 파이썬 3.10 이상에 설치합니다. |
npm install caspian-sdk | 타입스크립트 쪽 설치입니다. |
cx.channels.add("telegram", bot_token="...") | 통로를 하나 붙입니다. |
함정
설치 전에 확인하세요
- 라이선스가 AGPL-3.0 입니다. 서비스로 제공할 때 조건을 먼저 확인해야 합니다.
- 1.0 은 전면 재작성이라 0.6 대의 공개 표면과 다릅니다. 문서의 이전 안내를 봐야 합니다.
- 저장소 태그는 0.1 대인데 실제 패키지 판은 1.0 대입니다. 태그만 보면 헷갈립니다.
- 텔레그램 같은 일부 통로는 봇 토큰을 직접 준비해야 합니다.
비교
에이전트 사이 연결을 다루는 규약은 이미 여럿 있습니다. 하지만 실제 통신 대부분은 에이전트와 사람 사이에서 일어납니다. 이쪽은 그 구간을 맡습니다. 대신 라이선스 조건이 상업적 도입에 영향을 줍니다.
최근 변경
첫 공개 판에 슬랙과 디스코드, 텔레그램, 인스타그램, 메신저, X, 메일, 문자까지 채널 어댑터가 들어갔습니다. 공급과 발송, 응답, 웹훅 해석이라는 작은 인터페이스 하나로 통일했습니다.