Composio: 1000+ готовых инструментов для ИИ-агентов

Даже сильная LLM сама по себе может только говорить. Чтобы агент проверил почту, завёл задачу в таск-трекере или выгрузил отчёт, ему нужен доступ к внешним сервисам. И тут начинается рутина: у каждого сервиса свой API, своя аутентификация, свои токены и свои ошибки. Composio закрывает эту проблему целиком.

Composio — платформа с более чем 1000 готовых наборов инструментов (toolkits) для ИИ-агентов. Она берёт на себя поиск инструментов, аутентификацию, управление контекстом и запуск кода в песочнице. Агенту остаётся только выбрать действие — платформа превращает намерение в реальный вызов API.

Что внутри

Репозиторий — это монорепозиторий SDK. В него входят:

• @composio/core — основной TypeScript SDK;
• composio — Python SDK;
• composio CLI — утилита командной строки для поиска, запуска и сценарной работы с инструментами;
• адаптеры провайдеров для OpenAI Agents, Claude Agent SDK, Vercel AI SDK, LangChain и других фреймворков.

Ключевые возможности платформы:

• 1000+ toolkits — готовые интеграции с популярными сервисами: почта, календари, таск-трекеры, CRM, базы данных, облака и т.д.
• Сессии для каждого пользователя — инструменты привязываются к конкретному пользователю, а не к приложению целиком.
• Аутентификация из коробки — OAuth, API-ключи и токены управляются платформой, агенту не нужно разбираться в деталях.
• Триггеры — события из внешних сервисов запускают агента сами, без опроса по расписанию.
• Песочница — код агента исполняется в изолированном окружении.

Быстрый старт

Идея простая: создать сессию для пользователя, передать её инструменты агенту и позволить ему действовать. Понадобится API-ключ из панели управления.

TypeScript

npm install @composio/core @composio/openai-agents @openai/agents

import { Composio } from "@composio/core";
import { OpenAIAgentsProvider } from "@composio/openai-agents";
import { Agent, run } from "@openai/agents";

const composio = new Composio({ provider: new OpenAIAgentsProvider() });

// Каждая сессия привязана к одному из ваших пользователей
const session = await composio.create("user_123");
const tools = await session.tools();

const agent = new Agent({
  name: "Personal Assistant",
  instructions: "You are a helpful assistant. Use Composio tools to take action.",
  tools,
});

const result = await run(agent, "Summarize my emails from today");
console.log(result.finalOutput);

Python

pip install composio composio-openai-agents openai-agents

from composio import Composio
from composio_openai_agents import OpenAIAgentsProvider
from agents import Agent, Runner

composio = Composio(provider=OpenAIAgentsProvider())

session = composio.create(user_id="user_123")
tools = session.tools()

agent = Agent(
    name="Personal Assistant",
    instructions="You are a helpful assistant. Use Composio tools to take action.",
    tools=tools,
)

result = Runner.run_sync(starting_agent=agent, input="Summarize my emails from today")
print(result.final_output)

Пара практических деталей. По умолчанию сессия получает мета-инструменты: через них агент сам находит нужные приложения, проходит аутентификацию и выполняет действия. Это экономит контекст — не нужно загружать сотни описаний инструментов в промпт. Идентификатор сессии стоит сохранить и переиспользовать между ходами диалога через composio.use(). Подробнее об этом — в документации: как это работает и настройка сессий.

CLI для терминала и coding-агентов

Платформу можно использовать и без написания кода. Установка одной командой:

curl -fsSL https://composio.dev/install | sh

После установки достаточно выполнить composio login. Основные команды:

• composio search — найти нужный инструмент;
• composio execute — выполнить его;
• composio link — подключить внешний аккаунт;
• composio run — запустить сценарий на TypeScript.

Главная особенность CLI в том, что он даёт локальную поверхность инструментов coding-агентам вроде Claude Code. То есть агент в терминале получает доступ к тем же 1000+ интеграций. Тонкости установки для разных оболочек описаны в INSTALL.md, а подробный справочник — в документации CLI.

MCP-доступ

Каждая сессия может выдать хостинг-MCP-эндпоинт. Для этого достаточно передать mcp: true при создании сессии и указать адрес session.mcp.url в любом MCP-клиенте — Claude, Cursor или другом. Отдельный код адаптера не нужен. Описание подхода — в разделе сессии через MCP.

Адаптеры провайдеров

Провайдер — это прослойка, которая переводит инструменты Composio в родной формат выбранного фреймворка. Поддержка широкая:

Если своего фреймворка в списке нет, можно написать свой провайдер или вообще обойтись без провайдеров — через MCP.

Структура репозитория

ts/                TypeScript-часть
  packages/core/       @composio/core
  packages/providers/  адаптеры провайдеров
  packages/cli/        Composio CLI
python/            Python SDK и пакеты провайдеров
docs/              сайт документации (docs.composio.dev)

Есть любопытная деталь: пакет @composio/core специально поставляется вместе с исходниками и документацией SDK. Благодаря этому установленный пакет можно «читать» прямо из node_modules — это удобно coding-агентам, которые изучают код перед использованием. Тем, кому важен размер установки, подойдёт @composio/slim: тот же API, но без лишних файлов.

TypeScript SDK протестирован на Node 22+, Python SDK поддерживает версии 3.10+.

Итог

Composio решает скучную, но критичную задачу: соединяет агентов с внешним миром. Вместо недель на ручную интеграцию каждого сервиса вы получаете готовый слой инструментов, аутентификации и сессий. Особенно хорошо это ложится на сценарий «агент действует от имени пользователя» — сессии изолируют данные каждого клиента.

Проект открыт под лицензией MIT. Разработке приветствуют: перед пулл-реквестом стоит прочитать CONTRIBUTING.md. Вопросы и предложения — через issues, Discord-сообщество или почту support@composio.dev.

Быстрее всего начать с официальной документации и руководства быстрого старта.