ONEDEV

composio

AI Agent FrameworksCLITypeScript

★ 30,148주당 +112조회 5

무엇인가

Composio는 AI 에이전트가 외부 서비스의 도구를 실제로 호출하도록 연결하는 계층이다. 도구 호출, 사용자별 인증, 세션 상태 관리가 필요한 자리에 들어간다. 저장소는 TypeScript SDK인 `@composio/core`, Python SDK인 `composio`, `composio` CLI, 그리고 여러 에이전트 프레임워크용 provider 어댑터를 한 모노레포에 담는다.

어떻게 동작하나

동작의 중심은 세션이다. 사용자별 세션을 만들면 도구 검색·인증·실행을 담당하는 메타 도구가 그 세션에 붙고, 에이전트는 런타임에 필요한 앱 도구를 찾아 실행한다. `session.session_id`를 저장해 두고 다음 턴에 `composio.use()`로 재사용한다. 인증은 auth config와 connected account로 관리하고, 트리거로 외부 이벤트를 받는다. `composio.create()`에 `mcp: true`를 넘기면 `session.mcp.url`에 호스팅 MCP 엔드포인트가 생겨 Claude나 Cursor 같은 MCP 클라이언트가 직접 연결한다.

무엇과 다른가

수백 개 도구 정의를 프롬프트에 적재하는 대신 메타 도구로 런타임에 검색하는 구조라 컨텍스트를 도구 목록으로 채우지 않는다. provider 어댑터는 Composio 도구를 각 프레임워크의 네이티브 tool 포맷으로 변환하므로 에이전트 프레임워크를 바꿔도 도구 계층은 그대로 쓴다. provider를 아예 건너뛰고 MCP로 연결하는 경로도 있다. `@composio/core`는 TypeScript 소스와 SDK 문서를 패키지에 함께 넣어 설치본을 코딩 에이전트가 읽을 수 있게 했고, 같은 API의 작은 설치본이 `@composio/slim`이다.

어떻게 쓰나

대시보드에서 `COMPOSIO_API_KEY`를 발급받고 세션을 만든 뒤 그 세션의 도구를 에이전트에 넘긴다. CLI는 설치 프로그램이 `composio`를 `PATH`에 넣고, 새 터미널에서 `composio login`으로 로그인한 뒤 `composio search`로 도구를 찾고 `composio execute`로 실행하며 `composio link`로 계정을 연결하고 `composio run`으로 TypeScript 워크플로를 스크립트한다.

전제와 한계

TypeScript SDK는 Node 22 이상, Python SDK는 Python 3.10 이상에서 테스트된다. Pi provider는 실험 단계이며 `@composio/experimental`에서 배포된다. 라이선스는 MIT이고, 세션 생성과 도구 실행에는 API 키가 필요하다.

관련 논문 2

유사 도구