Claude Info
AI-инструменты

Composio

ComposioHQ/composio

Composio — платформа для разработчиков AI-агентов: 1000+ готовых интеграций, поиск инструментов, управление контекстом и аутентификацией. Поддерживает Python и TypeScript, совместима с OpenAI, Anthropic, LangChain, LlamaIndex и другими фреймворками.

Подключение

terminal
bash
npm install @composio/openai-agents @openai/agents

README

Composio SDK

Навыки, которые развиваются вместе с вашими агентами

🌐 Сайт📚 Документация

GitHub Stars PyPI Downloads NPM Downloads Discord

Этот репозиторий содержит официальные SDK для Composio, обеспечивающие бесшовную интеграцию с Python и TypeScript фреймворками и библиотеками для разработки агентов.

Начало работы

Установка TypeScript SDK

bash
# Через npm
npm install @composio/core

# Через yarn
yarn add @composio/core

# Через pnpm
pnpm add @composio/core

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

ts
import { Composio } from '@composio/core';
// Инициализация SDK
const composio = new Composio({
  // apiKey: 'your-api-key',
});

Простой агент с OpenAI Agents

npm install @composio/openai-agents @openai/agents
ts
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

bash
# Через pip
pip install composio

# Через poetry
poetry add composio

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

py
from composio import Composio

composio = Composio(
  # api_key="your-api-key",
)

Простой агент с OpenAI Agents

pip install composio_openai_agents openai-agents
py
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:

bash
# Получить актуальные спецификации 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:

ПровайдерTypeScriptPython
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/corenpm version
Python
composioPyPI version

Пакеты провайдеров

ПакетВерсия
TypeScript
@composio/openainpm version
@composio/openai-agentsnpm version
@composio/anthropicnpm version

Похожие MCP-серверы