composio.dev • Documentation • Quickstart • Changelog

Composio

Composio 为您的 AI 代理提供每用户会话预认证的 1000 个工具包、认证、触发器和沙箱，因此您可以发布将意图转化为行动的代理。

这是 Composio SDK 的单一仓库。它包含：

• @composio/core：TypeScript SDK
• composio：Python SDK
• composio CLI：从您的终端搜索、执行和编写脚本工具
• 提供者适配器 用于 OpenAI 代理、Claude Agent SDK、Vercel AI SDK、LangChain 以及 更多

快速开始

为用户创建一个会话，将其工具交给您的代理，让代理在 1000 个应用中执行操作。首先从 仪表板 获取 COMPOSIO_API_KEY。

TypeScript

npm install @composio/core @composio/openai-agents @openai/agents

@composio/core 有意将其 TypeScript 源代码和 SDK 文档打包，以便安装的包可以被编码代理检查。如果您想要一个具有相同 API 的更小安装包，请使用 @composio/slim。

import { Composio } from "@composio/core";
import { OpenAIAgentsProvider } from "@composio/openai-agents";
import { Agent, run } from "@openai/agents";

const composio = new Composio({ provider: new OpenAIAgentsProvider() });

// Each session is scoped to one of your users
const session = await composio.create("user_123");
const tools = await session.tools();

const agent = new Agent({
  name: "Personal Assistant",
  instructions: "You are a helpful assistant. Use Composio tools to take action.",
  tools,
});

const result = await run(agent, "Summarize my emails from today");
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())

# Each session is scoped to one of your users
session = composio.create(user_id="user_123")
tools = session.tools()

agent = Agent(
    name="Personal Assistant",
    instructions="You are a helpful assistant. Use Composio tools to take action.",
    tools=tools,
)

result = Runner.run_sync(starting_agent=agent, input="Summarize my emails from today")
print(result.final_output)

默认情况下，会话会获得在运行时发现、认证和执行应用工具的元工具，因此您无需将数百个工具定义加载到上下文中。在回合之间存储 session.session_id 并与 composio.use() 共享使用。请参阅 什么是会话 和 配置会话 以限制工具包、认证配置和已连接的账户。

更喜欢 MCP？ 每个会话还暴露一个托管的 MCP 端点。将 mcp: true 传递给 composio.create()，并将 Claude、Cursor 或任何 MCP 客户端指向 session.mcp.url。请参阅 通过 MCP 的会话。

命令行界面

composio CLI 可以从您的 shell 运行 Composio，并为像 Claude Code 这样的编码代理提供本地工具界面。

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

安装程序会将 composio 放到你的 PATH 上，以便将来在终端使用。打开一个新终端，然后运行 composio login。有关 shell 设置覆盖的详细信息，请参见 INSTALL.md，包括用于仅安装运行的 COMPOSIO_INSTALL_SHELL=none。

使用 composio search 来查找工具，composio execute 来运行它们，composio link 来连接账户，以及 composio run 来在 TypeScript 中编写工作流脚本。详情请参阅 CLI 文档。

提供者

提供者将 Composio 工具适配到你的代理框架的本地工具格式：

* Pi提供者处于实验阶段，从@composio/experimental发货。

没看到你的框架？构建自定义提供商，或者完全跳过供应商，通过[MCP]连接(https://docs.composio.dev/docs/sessions-via-mcp)。

所有包

本仓库发布的所有内容：

仓库布局

ts/                TypeScript SDK workspace
  packages/core/       @composio/core
  packages/providers/  Provider adapters
  packages/cli/        Composio CLI
python/            Python SDK and provider packages
docs/              Documentation site (docs.composio.dev)

TypeScript SDK 已针对 Node 22 进行测试；Python SDK 支持 Python 3.10。

开发

mise install    # pinned toolchain (Node, Python, pnpm)
pnpm install
pnpm build
pnpm test

Python 命令从 python/ 运行；请参见 python/README.md。我们欢迎对两个 SDK 的贡献；在提交拉取请求前，请阅读 contribution guidelines。

支持

• 文档
• Discord 社区
• 提出问题
• support@composio.dev

许可

MIT。请参见 LICENSE。