Composio — интеграционная платформа для AI-агентов

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

Что это такое

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

Вместо того чтобы писать интеграции для каждого API вручную, вы подключаете Composio и получаете единый интерфейс. Агент сам находит нужные инструменты, авторизует пользователя и выполняет действия — всё через один SDK.

Основные возможности

Как это работает

Архитектура 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, авторизуйтесь здесь», вы кликаете — и дальше всё работает без дополнительных шагов.

Подключение и интеграция

Composio поддерживает два режима:

Быстрый старт: 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

from composio import Composio

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

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

Для Claude Desktop, Cursor и других MCP-клиентов достаточно передать session.mcp.url и session.mcp.headers — никаких дополнительных пакетов не нужно.

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

API

• Base URL: https://backend.composio.dev/api/v3
• Авторизация: заголовок x-api-key (project) или x-org-api-key (organization)
• CLI: curl -fsSL https://composio.dev/install | bash

Практические сценарии

Агент-ассистент с доступом к рабочим инструментам

Агент подключается к Gmail, Slack и Notion. Пользователь просит «покажи непрочитанные письма и создай задачу в Notion по каждому» — агент находит тулкиты, авторизует пользователя и выполняет цепочку действий.

CI/CD-ассистент

Агент подключён к GitHub и Linear. При появлении нового PR через триггер агент проводит code review, создаёт задачу в Linear с результатами и отправляет саммари в Slack.

MCP-сервер для Claude Desktop

Composio разворачивается как MCP-сервер. Пользователь работает в Claude Desktop и прямо из чата управляет GitHub-репозиториями, пишет в Slack и создаёт страницы в Notion — без единой строки кода на своей стороне.

Тарифы и лимиты

Бесплатного плана (20K вызовов/мес) хватает для прототипирования и тестирования. Для production-нагрузок имеет смысл начинать с Ridiculously Cheap ($29/мес). Rate limits: Free — 1 000 вызовов/час, Paid — до 100 000 вызовов/час.

Сравнение с альтернативами

Глоссарий

Ссылки

• 🌐 Сайт: composio.dev
• 📖 Документация: docs.composio.dev
• 💰 Тарифы: composio.dev/pricing
• 🔧 Тулкиты: composio.dev/toolkits
• 🐙 GitHub: github.com/composiohq
• 📋 API Reference: docs.composio.dev/reference
• 🤖 Playground: composio.dev/playground — попробовать без кода

По теме

• Статья: Почему готовые ИИ-агенты не работают — и что делать вместо
• Блог: Notion MCP теперь умеет работать с записями встреч
• База знаний: OpenAI Codex — облачный coding-агент для параллельной разработки

Если вы строите AI-агентов и хотите подключить их к рабочим инструментам без боли с авторизацией — давайте обсудим, как это сделать эффективно.