Composio: как дать агенту руки и подключить 1000+ сервисов без боли

Ваш AI-агент умеет думать, но не умеет ничего делать. Может написать письмо — но не отправить. Создать задачу — но не положить её в Jira. Проанализировать PR — но не оставить комментарий в GitHub. Composio даёт агенту «руки» для работы с реальными сервисами.

Что это

Composio — developer-first платформа, которая подключает AI-агента к внешним сервисам: Gmail, Slack, GitHub, Notion, Linear, Jira, Salesforce и ещё более 1 000 тулкитов из коробки. Вместо того чтобы писать интеграции для каждого API вручную, вы подключаете Composio и получаете единый интерфейс. Агент сам находит нужные инструменты, авторизует пользователя и выполняет действия — всё через один SDK.

Зачем нужно

• Подключить агента к 1000+ сервисам без написания отдельной интеграции под каждый API.
• Управлять авторизацией централизованно: OAuth 2.0, API-ключи, Bearer-токены с refresh — без ручной возни.
• Использовать мета-инструменты вместо загрузки сотен tool-определений в контекст — экономия контекстного окна.
• Работать с любым AI-фреймворком: OpenAI, Anthropic, Gemini, LangChain, CrewAI, Vercel AI SDK, Mastra.
• Реагировать на события (новый email, новый PR, сообщение в Slack) через триггеры.

Как устроено

Архитектура Composio строится вокруг трёх концепций: сессии, мета-инструменты и авторизация.

Сессии

Каждый вызов composio.create(user_id) создаёт сессию — контекст, привязанный к конкретному пользователю. Сессия хранит:

• User ID — чьи credentials использовать.
• Доступные тулкиты — все по умолчанию или ограниченный набор.
• Auth-конфигурацию — какие connected accounts задействовать.

Сессии иммутабельны: если контекст меняется — создавайте новую.

Мета-инструменты

Вместо загрузки сотен tool-схем в контекст, Composio предоставляет набор мета-инструментов:

• COMPOSIO_SEARCH_TOOLS — поиск инструментов по описанию задачи.
• COMPOSIO_GET_TOOL_SCHEMAS — получение схем найденных инструментов.
• COMPOSIO_MANAGE_CONNECTIONS — управление авторизацией.
• COMPOSIO_MULTI_EXECUTE_TOOL — выполнение инструментов с credentials пользователя.
• COMPOSIO_REMOTE_WORKBENCH — Python-песочница для обработки данных.

Агент не получает сотни определений разом — он сначала ищет нужный инструмент, потом запрашивает его схему и только потом вызывает. Это экономит контекстное окно и снижает вероятность ошибок.

Авторизация

Когда инструменту нужен доступ к сервису, агент генерирует Connect Link — страницу, где пользователь подтверждает авторизацию. После этого credentials сохраняются и работают во всех будущих сессиях.

На практике: вы просите агента создать issue в GitHub, он отвечает «нужно подключить GitHub, авторизуйтесь здесь», вы кликаете — и дальше всё работает без дополнительных шагов.

Когда использовать

Таблица «ситуация → подходит / не подходит»:

Пример

Быстрый старт: Native Tools (Python + OpenAI Agents).

pip install python-dotenv composio composio-openai-agents openai-agents

API-ключи: COMPOSIO_API_KEY в настройках Composio, OPENAI_API_KEY в OpenAI.

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

load_dotenv()

composio = Composio(provider=OpenAIAgentsProvider())
session = composio.create(user_id="user_123")
tools = session.tools()

agent = Agent(
    name="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)

Быстрый старт через MCP — для Claude Desktop, Cursor и других MCP-клиентов.

from composio import Composio

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

mcp_url = session.mcp.url
mcp_headers = session.mcp.headers

Достаточно передать session.mcp.url и session.mcp.headers — никаких дополнительных пакетов не нужно.

Поддерживаемые фреймворки