Интеграция Composio для подключения AI-агентов к внешним сервисам
Представьте: вам нужно, чтобы AI-агент автоматически создавал задачи в Jira на основе новых PR в GitHub, уведомлял команду в Slack и обновлял статус в Trello. Без готовой платформы вы пишете OAuth-обработчики, парсите REST API каждого сервиса, обрабатываете ошибки и масштабируете подключения. На это уходят дни. Мы используем Composio — платформу с 250+ готовыми коннекторами, которая берёт на себя всю интеграционную рутину. Наш опыт показывает: типовую связку из 3–4 сервисов можно настроить за пару часов, экономя существенные средства на разработке.
Какие проблемы решаем
- Ручное управление OAuth и токенами. Каждый сервис имеет свой OAuth-flow. Composio предоставляет единый интерфейс авторизации с поддержкой refresh-токенов и multi-tenant. Больше никаких write-only callback'ов.
- Совместимость схем с LLM. Инструменты должны быть описаны в формате, понятном для GPT-4o, Claude и других моделей. Composio автоматически генерирует OpenAPI-спецификации в виде JSON Schema, которые можно передать в LangChain или LlamaIndex.
- Масштабирование подключений. При тысячах пользователей каждый со своим набором сервисов ручная реализация становится узким местом. Composio решает это за счёт entity-модели и централизованного управления.
- Ограничение прав доступа. Агенту можно дать только read-действия (например, список репозиториев) или частичный write (только комментарии). Это критично для production-сценариев.
Как мы это делаем: стек и кейс из практики
В одном из проектов наш клиент — компания с DevOps-командой из 20 человек — хотел автоматизировать ежедневную проверку CI/CD. Агент должен был каждое утро проверять статус сборок в GitHub Actions, открытые PR, ошибки в Sentry и создавать Jira-задачи для критических проблем. Раньше это делал дежурный инженер за 2–3 часа. Мы подключили Composio, настроили multi-tenant OAuth для каждого участника команды и написали агента на LangGraph. В итоге время проверки сократилось до 10 минут (на 90%), а число упущенных инцидентов снизилось на 40%.
# pip install composio-langchain from composio_langchain import ComposioToolSet, App from langchain_openai import ChatOpenAI from langgraph.prebuilt import create_react_agent toolset = ComposioToolSet(api_key="composio-api-key") # Получить инструменты для конкретного приложения github_tools = toolset.get_tools(apps=[App.GITHUB]) jira_tools = toolset.get_tools(apps=[App.JIRA]) slack_tools = toolset.get_tools(apps=[App.SLACK]) llm = ChatOpenAI(model="gpt-4o") # ReAct агент с доступом к GitHub + Jira + Slack agent = create_react_agent( llm, tools=[*github_tools, *jira_tools, *slack_tools], ) result = agent.invoke({ "messages": [{ "role": "user", "content": "Найди все open PR в репозитории company/backend, " "создай Jira-задачи для каждого и уведоми в #dev-reviews" }] }) Как настроить multi-tenant OAuth в Composio?
Multi-tenant решает задачу, когда каждый пользователь системы авторизуется под своим аккаунтом (например, личный GitHub). Composio предоставляет метод initiate_connection, который возвращает URL для редиректа. После успешной авторизации вы используете entity_id, чтобы агент работал от имени конкретного пользователя. Всё управление токенами берёт на себя платформа — вам не нужно хранить refresh-токены и обрабатывать их истечение. Подробнее о протоколе OAuth 2.0.
# Composio поддерживает разные аккаунты для разных пользователей toolset = ComposioToolSet(api_key="composio-api-key") # Инициация OAuth для нового пользователя connection = toolset.initiate_connection( app=App.GITHUB, entity_id="user_12345", # ID пользователя в вашей системе redirect_url="https://yourapp.com/auth/callback", ) print(f"Redirect user to: {connection.redirectUrl}") # После авторизации — агент работает от имени этого пользователя user_toolset = ComposioToolSet( api_key="composio-api-key", entity_id="user_12345", ) user_tools = user_toolset.get_tools(apps=[App.GITHUB]) Фильтрация инструментов
from composio import Action # Только конкретные действия (ограничение permissions) read_only_tools = toolset.get_tools( actions=[ Action.GITHUB_LIST_REPOSITORIES, Action.GITHUB_GET_PULL_REQUEST, Action.JIRA_GET_ISSUE, Action.JIRA_LIST_ISSUES, ] ) # Запрет на write-операции в production write_tools = toolset.get_tools( actions=[ Action.GITHUB_CREATE_ISSUE_COMMENT, Action.JIRA_UPDATE_ISSUE, ] ) Почему Composio лучше кастомной разработки?
| Критерий | Composio | Ручная реализация |
|---|---|---|
| Время настройки 3–4 сервисов | 1–2 дня | 2–3 недели |
| Поддержка OAuth | Готовый flow с refresh | Писать с нуля |
| Multi-tenant | Встроенная entity-модель | Сложно масштабировать |
| Совместимость с LLM | Автоматические JSON Schema | Ручное описание tools |
| Актуальность API | Обновляется платформой | Поддержка своими силами |
Топ-5 интегрируемых сервисов
| Сервис | Типовые сценарии | Количество действий |
|---|---|---|
| GitHub | PR, issues, actions | 80+ |
| Jira | Задачи, спринты, пользователи | 60+ |
| Slack | Сообщения, каналы, реакции | 40+ |
| Salesforce | Контакты, сделки, отчёты | 100+ |
| Gmail | Письма, метки, фильтры | 50+ |
Процесс работы: от задачи до деплоя
- Аналитика — обсуждаем, какие сервисы нужно подключить, какие действия должен выполнять агент, какой уровень доступа требуется.
- Проектирование — выбираем архитектуру (LangChain, LlamaIndex или кастом), проектируем multi-tenant модель.
- Интеграция — подключаем Composio, настраиваем OAuth, пишем код агента.
- Тестирование — запускаем агента в изолированной среде, проверяем граничные случаи (отзыв токена, лимиты API).
- Деплой и мониторинг — разворачиваем в production, настраиваем логирование и алерты.
Что вы получите в результате?
- Готовый AI-агент с доступом к вашим сервисам.
- Документацию по архитектуре и подключению новых интеграций.
- Инструкцию для пользователей по OAuth-авторизации.
- Код с комментариями и примерами.
- Поддержку на этапе эксплуатации (опционально).
Ориентировочные сроки: от 2 дней для типовых решений до 2 недель для сложных multi-tenant архитектур. Стоимость рассчитывается индивидуально. Пишите — оценим ваш проект.
Какие гарантии мы даём?
Мы внедрили Composio для 15+ проектов — от стартапов до enterprise. Гарантируем, что интеграции будут работать стабильно, а агент корректно обрабатывает ошибки API. Если возникают проблемы с нестандартными сценариями, дорабатываем решение. Итоговый код передаём клиенту с полной документацией. OAuth 2.0 Authorization Framework, RFC 6749
Свяжитесь с нами, чтобы обсудить интеграцию AI-агентов в вашу инфраструктуру — мы подготовим смету и сроки за 1 рабочий день.







