Composio: SDK для создания AI-агентов с преднастроенными инструментами

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

Это монорепозиторий SDK Composio, который включает в себя:

• @composio/core: SDK для TypeScript
• composio: SDK для Python
• composio CLI: инструменты для поиска, выполнения и скрипта из командной строки
• Адаптеры для различных провайдеров, таких как OpenAI, Claude, Vercel AI и другие.

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

Чтобы начать, создайте сессию для пользователя, передайте её инструменты вашему агенту и дайте ему возможность выполнять действия в более чем 1000 приложениях. Сначала получите COMPOSIO_API_KEY на панели управления.

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: "Личный помощник",
  instructions: "Ты — полезный помощник. Используй инструменты Composio для выполнения действий.",
  tools,
});

const result = await run(agent, "Подведи итоги моим письмам за сегодня");
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="Личный помощник",
    instructions="Ты — полезный помощник. Используй инструменты Composio для выполнения действий.",
    tools=tools,
)

result = Runner.run_sync(starting_agent=agent, input="Подведи итоги моим письмам за сегодня")
print(result.final_output)

По умолчанию сессия получает специальные инструменты, которые помогают находить, аутентифицировать и выполнять действия в приложениях во время работы, что позволяет избежать загрузки множества определений инструментов. Храни session.session_id и повторно используй его с composio.use() в проеме сессии.

CLI

CLI composio позволяет запускать Composio из командной строки и предоставляет локальные инструменты для кодирующих агентов.

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

Инсталлятор добавляет composio в системный путь для последующих терминалов. Открой новый терминал и запусти composio login. В документации можно найти информацию по настройке и использованию CLI.

Провайдеры

Провайдер адаптирует инструменты Composio к нативному формату инструментов в вашей среде.

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

Ограничения и требуемые версии

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

С проектом можно ознакомиться на официальном сайте, в документации и сообществе в Discord. Проект доступен под лицензией MIT.