Як інтегрувати Composio для підключення AI-агентів до зовнішніх сервісів

Як інтегрувати Composio для підключення AI-агентів до зовнішніх сервісів

Уявіть: вам потрібно, щоб AI-агент автоматично створював завдання в Jira на основі нових PR у GitHub, сповіщав команду в Slack і оновлював статус у Trello. Без готової платформи ви пишете OAuth-обробники, парсите REST API кожного сервісу, обробляєте помилки та масштабуєте підключення. На це йдуть дні. Composio пришвидшує інтеграцію в 7–10 разів порівняно з написанням кастомних обгорток. Ми використовуємо Composio — платформу з 250+ готовими конекторами, яка бере на себе всю інтеграційну рутину. Наш досвід показує: типову зв'язку з 3–4 сервісів можна налаштувати за кілька годин, заощаджуючи суттєві кошти на розробці (економія до 80% бюджету на розробку).

Які проблеми вирішуємо

• Ручне управління 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://docs.composio.dev/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 краще кастомної розробки?

Вартість типових інтеграцій — від $1000, включаючи налаштування OAuth та тестування.

Топ-5 інтегрованих сервісів

Що входить в роботу?

• Готовий AI-агент з доступом до ваших сервісів.
• Документація з архітектури та підключення нових інтеграцій.
• Інструкція для користувачів з OAuth-авторизації.
• Код з коментарями та прикладами.
• Підтримка на етапі експлуатації (опціонально).

Процес роботи: від задачі до деплою

1. Аналітика — обговорюємо, які сервіси потрібно підключити, які дії має виконувати агент, який рівень доступу потрібен.
2. Проектування — вибираємо архітектуру (LangChain, LlamaIndex або кастом), проектуємо multi-tenant модель.
3. Інтеграція — підключаємо Composio, налаштовуємо OAuth, пишемо код агента.
4. Тестування — запускаємо агента в ізольованому середовищі, перевіряємо граничні випадки (відкликання токена, ліміти API).
5. Деплой та моніторинг — розгортаємо в production, налаштовуємо логування та алерти.

Що ви отримаєте в результаті?

• Готовий AI-агент з доступом до ваших сервісів.
• Документацію з архітектури та підключення нових інтеграцій.
• Інструкцію для користувачів з OAuth-авторизації.
• Код з коментарями та прикладами.
• Підтримку на етапі експлуатації (опціонально).

Орієнтовні терміни: від 2 днів для типових рішень до 2 тижнів для складних multi-tenant архітектур. Вартість розраховується індивідуально. Пропонуємо впровадження Composio під ключ. Пишіть — оцінимо ваш проєкт безкоштовно за 1 робочий день.

Які гарантії ми даємо?

Ми на ринку AI-інтеграцій понад 5 років, реалізували 15+ проєктів — від стартапів до enterprise. Гарантуємо, що інтеграції працюватимуть стабільно, а агент коректно обробляє помилки API. Якщо виникають проблеми з нестандартними сценаріями, доопрацьовуємо рішення. Підсумковий код передаємо клієнту з повною документацією. OAuth 2.0 Authorization Framework, RFC 6749

Зв'яжіться з нами, щоб обговорити інтеграцію AI-агентів у вашу інфраструктуру — ми підготуємо кошторис і терміни за 1 робочий день.