Composio SDK

あなたのエージェント向けに進化するスキル

🌐 ウェブサイト • 📚 ドキュメント

このリポジトリは Composio の公式 Software Development Kits (SDKs) を含んでおり、Python および Typescript Agentic Frameworks and Libraries に対して、シームレスな統合機能を提供しています。

# Using npm
npm install @composio/core

# Using yarn
yarn add @composio/core

# Using pnpm
pnpm add @composio/core

import { Composio } from '@composio/core';
// SDK の初期化
const composio = new Composio({
  // apiKey: 'your-api-key',
});

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 のデータを含むエージェントからの応答を返します。

# pip を使用する場合
pip install composio

# poetry を使用する場合
poetry add composio

from composio import Composio

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

pip install composio_openai_agents openai-agents

import asyncio
from agents import Agent, Runner
from composio import Composio
from composio_openai_agents import OpenAIAgentsProvider

# OpenAI Agents Provider を使用して Composio クライアントを初期化
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 の詳細な使用方法と例については、各 SDK の特定のドキュメントを参照してください。

SDK ドキュメント生成に使用する OpenAPI 仕様を更新するには：

# バックエンドから最新の API 仕様をプル
pnpm api:pull

このコマンドは https://backend.composio.dev/api/v3/openapi.json から OpenAPI 仕様をプルし、ローカル API ドキュメントファイルを更新します。

これはビルドステップで自動的にプルされます。

TypeScript SDK は、Composio のサービスと相互作用するための最新的で型安全な方法を提供します。Node.js とブラウザ環境の両方向けに設計されており、包括的な型定義を備えた完全な TypeScript サポートを提供します。

TypeScript SDK の詳細については、TypeScript SDK ドキュメントをご参照ください。

Python SDK は、Composio のサービスに対して Python らしいインターフェースを提供し、Composio を Python アプリケーションに簡単に統合できるようにしています。Python 3.10 以上をサポートしており、最新的な Python 開発実践に従っています。

Python SDK の詳細については、Python SDK ドキュメントをご参照ください。

以下の表は、各 SDK でサポートされている AI フレームワークおよびプラットフォームを示しています：

* TypeScript の LangGraph は、@composio/langchain パッケージを介してサポートされています。

プロバイダが見つかりませんか？カスタム プロバイダを構築して、任意の AI フレームワークと統合する方法を学びます。

パッケージ	バージョン
TypeScript
@composio/core
Python
composio

パッケージ	バージョン
TypeScript
@composio/openai
@composio/openai-agents
@composio/anthropic
@composio/langchain
@composio/llamaindex
@composio/vercel
@composio/google
@composio/mastra
@composio/cloudflare
Python
composio-openai

Composio SDK

Skills that evolve for your Agents

🌐 Website • 📚 Documentation

This repository contains the official Software Development Kits (SDKs) for Composio, providing seamless integration capabilities for Python and Typescript Agentic Frameworks and Libraries.

# Using npm
npm install @composio/core

# Using yarn
yarn add @composio/core

# Using pnpm
pnpm add @composio/core

import { Composio } from '@composio/core';
// Initialize the SDK
const composio = new Composio({
  // apiKey: 'your-api-key',
});

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));
// will return the response from the agent with data from HACKERNEWS API.

# Using pip
pip install composio

# Using poetry
poetry add composio

from composio import Composio

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

pip install composio_openai_agents openai-agents

import asyncio
from agents import Agent, Runner
from composio import Composio
from composio_openai_agents import OpenAIAgentsProvider

# Initialize Composio client with OpenAI Agents Provider
composio = Composio(provider=OpenAIAgentsProvider())

user_id = "user@acme.org"
tools = composio.tools.get(user_id=user_id, toolkits=["HACKERNEWS"])

# Create an agent with the tools
agent = Agent(
    name="Hackernews Agent",
    instructions="You are a helpful assistant.",
    tools=tools,
)

# Run the agent
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())
# will return the response from the agent with data from HACKERNEWS API.

For more detailed usage instructions and examples, please refer to each SDK's specific documentation.

To update the OpenAPI specifications used for generating SDK documentation:

# Pull the latest API specifications from the backend
pnpm api:pull

This command pulls the OpenAPI specification from https://backend.composio.dev/api/v3/openapi.json and updates the local API documentation files.

This is pulled automatically with build step.

The TypeScript SDK provides a modern, type-safe way to interact with Composio's services. It's designed for both Node.js and browser environments, offering full TypeScript support with comprehensive type definitions.

For detailed information about the TypeScript SDK, please refer to the TypeScript SDK Documentation.

The Python SDK offers a Pythonic interface to Composio's services, making it easy to integrate Composio into your Python applications. It supports Python 3.10+ and follows modern Python development practices.

For detailed information about the Python SDK, please refer to the Python SDK Documentation.

The following table shows which AI frameworks and platforms are supported in each SDK:

* LangGraph in TypeScript is supported via the @composio/langchain package.

Don't see your provider? Learn how to build a custom provider to integrate with any AI framework.

Package	Version
TypeScript
@composio/core
Python
composio

Package	Version
TypeScript
@composio/openai
@composio/openai-agents
@composio/anthropic
@composio/langchain
@composio/llamaindex
@composio/vercel
@composio/google
@composio/mastra
@composio/cloudflare
Python
composio-openai