Composio
ComposioHQ/composioComposio — платформа для разработчиков AI-агентов: 1000+ готовых интеграций, поиск инструментов, управление контекстом и аутентификацией. Поддерживает Python и TypeScript, совместима с OpenAI, Anthropic, LangChain, LlamaIndex и другими фреймворками.
Подключение
npm install @composio/openai-agents @openai/agentsREADME
Composio SDK
Навыки, которые развиваются вместе с вашими агентами
Этот репозиторий содержит официальные SDK для Composio, обеспечивающие бесшовную интеграцию с Python и TypeScript фреймворками и библиотеками для разработки агентов.
Начало работы
Установка TypeScript SDK
# Через npm
npm install @composio/core
# Через yarn
yarn add @composio/core
# Через pnpm
pnpm add @composio/coreБыстрый старт:
import { Composio } from '@composio/core';
// Инициализация SDK
const composio = new Composio({
// apiKey: 'your-api-key',
});Простой агент с OpenAI Agents
npm install @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 userId = 'user@acme.org';
const tools = await composio.tools.get(userId, {
toolkits: ['HACKERNEWS'],
});
const agent = new Agent({
name: 'Hackernews assistant',
tools: tools,
});
const result = await run(agent, 'What is the latest hackernews post about?');
console.log(JSON.stringify(result.finalOutput, null, 2));
// вернёт ответ агента с данными из HACKERNEWS API.Установка Python SDK
# Через pip
pip install composio
# Через poetry
poetry add composioБыстрый старт:
from composio import Composio
composio = Composio(
# api_key="your-api-key",
)Простой агент с OpenAI Agents
pip install composio_openai_agents openai-agents
import asyncio
from agents import Agent, Runner
from composio import Composio
from composio_openai_agents import OpenAIAgentsProvider
# Инициализация клиента Composio с провайдером OpenAI Agents
composio = Composio(provider=OpenAIAgentsProvider())
user_id = "user@acme.org"
tools = composio.tools.get(user_id=user_id, toolkits=["HACKERNEWS"])
# Создание агента с инструментами
agent = Agent(
name="Hackernews Agent",
instructions="You are a helpful assistant.",
tools=tools,
)
# Запуск агента
async def main():
result = await Runner.run(
starting_agent=agent,
input="What's the latest Hackernews post about?",
)
print(result.final_output)
asyncio.run(main())
# вернёт ответ агента с данными из HACKERNEWS API.Для получения подробных инструкций и примеров обратитесь к документации каждого SDK.
Спецификация OpenAPI
Для обновления спецификаций OpenAPI, используемых при генерации документации SDK:
# Получить актуальные спецификации API с бэкенда
pnpm api:pullЭта команда загружает спецификацию OpenAPI с https://backend.composio.dev/api/v3/openapi.json и обновляет локальные файлы документации API.
Спецификация загружается автоматически на этапе сборки.
Доступные SDK
TypeScript SDK (/ts)
TypeScript SDK предоставляет современный, типобезопасный способ взаимодействия с сервисами Composio. Разработан для сред Node.js и браузера, предлагает полную поддержку TypeScript с исчерпывающими определениями типов.
Подробная информация — в документации TypeScript SDK.
Python SDK (/python)
Python SDK предоставляет питоничный интерфейс к сервисам Composio, упрощая интеграцию в Python-приложения. Поддерживает Python 3.10+ и следует современным практикам разработки на Python.
Подробная информация — в документации Python SDK.
Поддержка провайдеров
В таблице ниже указано, какие AI-фреймворки и платформы поддерживаются в каждом SDK:
| Провайдер | TypeScript | Python |
|---|---|---|
| OpenAI | ✅ | ✅ |
| OpenAI Agents | ✅ | ✅ |
| Anthropic | ✅ | ✅ |
| LangChain | ✅ | ✅ |
| LangGraph | ✅* | ✅ |
| LlamaIndex | ✅ | ✅ |
| Vercel AI SDK | ✅ | ❌ |
| Google Gemini | ✅ | ✅ |
| Google ADK | ❌ | ✅ |
| Mastra | ✅ | ❌ |
| Cloudflare Workers AI | ✅ | ❌ |
| CrewAI | ❌ | ✅ |
| AutoGen | ❌ | ✅ |
* LangGraph в TypeScript поддерживается через пакет @composio/langchain.
Не нашли своего провайдера? Узнайте, как создать кастомный провайдер для интеграции с любым AI-фреймворком.
Пакеты
Основные пакеты
| Пакет | Версия |
|---|---|
| TypeScript | |
| @composio/core | |
| Python | |
| composio |
Пакеты провайдеров
| Пакет | Версия |
|---|---|
| TypeScript | |
| @composio/openai | |
| @composio/openai-agents | |
| @composio/anthropic |