composio

<p> <a href="https://github.com/composiohq/composio/blob/master/README.md">EN</a> | <a href="https://github.com/composiohq/composio/blob/master/README-CN.md">CN</a> | <a href="https://github.com/composiohq/composio/blob/master/README-JP.md">JP</a> </p> <p align="center"> <a href="https://composio.dev//#gh-dark-mode-only"> <img src="https://yellow-cdn.veclightyear.com/2b54e442/f5211e2b-631a-4172-bad0-a2f2447ae438.svg" width="318px" alt="Composio logo" /> </a> <a href="https://composio.dev//#gh-light-mode-only"> <img src="https://yellow-cdn.veclightyear.com/2b54e442/8e3c67b3-8b9d-4e3a-88b2-cbc53bdd6fa1.svg" width="318px" alt="Composio Logo" /> </a> </p> <p align="center"> <a href="https://github.com/composiodev/composio/actions/workflows/common.yml"> <img alt="Tests" src="https://img.shields.io/github/actions/workflow/status/composiodev/composio/common.yml?label=Tests&style=plastic&logo=github&color=blue&cacheSeconds=60"> </a> <a href="https://pypi.org/project/composio-core/"> <img alt="PyPI" src="https://img.shields.io/pypi/v/composio_core?label=Latest&style=plastic&logo=pypi&color=blue&cacheSeconds=60&logoColor=white"> </a> <a href="https://www.npmjs.com/package/composio-core"> <img alt="NPM" src="https://img.shields.io/npm/v/composio-core?style=plastic&logo=npm&logoColor=white&label=latest&color=blue&cacheSeconds=60"> </a> <a href="https://pypi.org/project/composio-core/"> <img alt="Downloads" src="https://img.shields.io/pypi/dm/composio-core?label=Downloads&style=plastic&logo=github&color=blue&cacheSeconds=60"> </a> </p> <h2 align="center"><i> 面向生产的AI代理工具集 </i></h2> <h4 align="center">为您的代理配备高质量的工具和集成，无需担心身份验证、准确性和可靠性，只需一行代码即可完成！</h4> <div align="center"> <p> <a href="https://docs.composio.dev" rel="dofollow"><strong>探索文档 »</strong></a> </p> <p> <a href="https://app.composio.dev">试用控制面板</a> <b>|</b> <a href="https://www.composio.dev">主页</a> <b>|</b> <!-- <a href="https://docs.composio.dev/guides/examples">Examples</a> | <a href="https://docs.composio.dev/chat-with-docs">Chat with Docs</a> | --> <a href="https://docs.composio.dev/sdk">SDK</a> <b>|</b> <a href="https://docs.composio.dev/api-reference/">APIs</a> </p> </div> <hr> <div align="center"> <p > <b>✨ 社交媒体 >></b> <a href="https://dub.composio.dev/JoinHQ">Discord</a> <b>|</b> <a href="https://www.youtube.com/@Composio">Youtube</a> <b>|</b> <a href="https://twitter.com/composiohq">Twitter</a> <b>|</b> <a href="https://www.linkedin.com/company/composio-dev"> Linkedin </a> </p> <p align="center"> <b>⛏️ 贡献 >></b> <a href="https://github.com/composiodev/composio/issues/new?assignees=&labels=type%3A+bug&template=bug_report.yml&title=%F0%9F%90%9B+Bug+Report%3A+">报告错误</a> <b>|</b> <a href="https://github.com/composiodev/composio/issues/new?assignees=&labels=feature&template=feature_request.yml&title=%F0%9F%9A%80+Feature%3A+">请求功能</a> <b>|</b> <a href="https://github.com/composiodev/composio/blob/master/CONTRIBUTING.md">贡献</a> </p> </div>

📋 目录

• 📋 目录
• 🤔 为什么选择Composio？
• 🔥 主要功能
• 🚀 Python入门指南
  • 1. 安装
  • 2. 测试Composio的实际应用
• 🚀 Javascript入门指南
  • 1. 安装Composio SDK:
  • 2. 设置OpenAI和Composio工具集:
  • 3. 运行您的脚本:
• 💡 示例
  • Python示例
  • Javascript示例
• Star历史
• 📋 阅读我们的行为准则
• 🤗 贡献
• 🔗 链接
• 🛡️ 许可证
• 💪 感谢所有贡献者

🤔 为什么选择Composio？

我们相信基于AI的代理/工作流是未来的发展方向。 Composio是将AI代理集成到最佳代理工具并使用它们来完成任务的最佳工具集。

<img alt="Illustration" src="https://raw.githubusercontent.com/ComposioHQ/composio/master/docs/imgs/banner.gif" style="border-radius: 5px"/>

🔥 主要功能

• 100+ 工具：支持多种不同类别

• 软件：在 GitHub、Notion、Linear、Gmail、Slack、Hubspot、Salesforce 等 90 多个平台上执行任何操作。

• 操作系统：点击任意位置，输入任意内容，复制到剪贴板等功能。

• 浏览器：智能搜索、截图、MultiOn、下载、上传等功能。

• 搜索：Google 搜索、Perplexity 搜索、Tavily、Exa 等。

• SWE：Ngrok、数据库、Redis、Vercel、Git 等等。

• RAG：为任何类型的数据提供实时 Agentic RAG！

• 框架：使用工具与代理框架，如 OpenAI、Claude、LlamaIndex、Langchain、CrewAI、Autogen、Gemini、Julep、Lyzr 等，仅需一行代码即可。

• 托管授权：支持六种不同的授权协议。_访问令牌、刷新令牌、OAuth、API 密钥、JWT 等_已被抽象化，因此你可以专注于构建代理。

• 准确性：由于更好的工具设计，工具调用的 代理准确性提高多达 40%。

• 可嵌入：在应用程序的后台进行白标化管理，为所有用户和代理管理授权和集成，保持一致的体验。

• 可插拔：设计为可轻松扩展的工具、框架和授权协议。

🚀 Python 入门

1. 安装

要开始，首先在终端输入以下命令。

pip install composio-core

如果你想安装带有 openai 插件的 'composio' 包，请输入：pip install composio-openai。

2. 测试 Composio 的使用

让我们使用 Composio 创建一个可以为 GitHub 仓库加星的 AI 代理。

composio add github # 连接你的 GitHub - 在终端运行此命令

from openai import OpenAI
from composio_openai import ComposioToolSet, App, Action

openai_client = OpenAI(
    api_key="{{OPENAIKEY}}"
)

# 初始化 Composio 工具集

composio_tool_set = ComposioToolSet()

# 获取预配置的 GitHub 工具
actions = composio_tool_set.get_actions(
    actions=[Action.GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER]
)

my_task = "在 GitHub 上为仓库 composiodev/composio 加星"

# 设置 openai 助手
assistant_instruction = "你是一个超级智能的个人助手"

assistant = openai_client.beta.assistants.create(
    name="Personal Assistant",
    instructions=assistant_instruction,
    model="gpt-4-turbo",
    tools=actions,
)

# 创建一个线程
thread = openai_client.beta.threads.create()

message = openai_client.beta.threads.messages.create(
    thread_id=thread.id,
    role="user",
    content=my_task
)

# 执行带有集成的代理
run = openai_client.beta.threads.runs.create(
    thread_id=thread.id,
    assistant_id=assistant.id
)


# 执行功能调用
response_after_tool_calls = composio_tool_set.wait_and_handle_assistant_tool_calls(
    client=openai_client,
    run=run,
    thread=thread,
)

print(response_after_tool_calls)

🚀 Javascript 入门

要开始使用 Javascript 中的 Composio SDK，请按照以下步骤操作：

1. 安装 Composio SDK：

npm install composio-core

2. 设置 OpenAI 和 Composio 工具集：

import { OpenAI } from "openai";
import { OpenAIToolSet } from "composio-core";

const toolset = new OpenAIToolSet({
    apiKey: process.env.COMPOSIO_API_KEY,
});

async function setupUserConnectionIfNotExists(entityId) {
    const entity = await toolset.client.getEntity(entityId);
    const connection = await entity.getConnection('github');

    if (!connection) {
        // 如果该实体/用户尚未连接账户
        const connection = await entity.initiateConnection(appName);
        console.log("通过以下链接登录：", connection.redirectUrl);
        return connection.waitUntilActive(60);
    }

    return connection;
}

async function executeAgent(entityName) {
    const entity = await toolset.client.getEntity(entityName)
    await setupUserConnectionIfNotExists(entity.id);

    const tools = await toolset.get_actions({ actions: ["github_issues_create"] }, entity.id);
    const instruction = "在 repo - himanshu-dixit/custom-repo-breaking 中创建一个标题为 sample 的 issue"

    const client = new OpenAI({ apiKey: process.env.OPEN_AI_API_KEY })
    const response = await client.chat.completions.create({
        model: "gpt-4-turbo",
        messages: [{
            role: "user",
            content: instruction,
        }],
        tools: tools,
        tool_choice: "auto",
    })

    console.log(response.choices[0].message.tool_calls);
    await toolset.handle_tool_call(response, entity.id);
}

executeAgent("your-entity-name");

3. 运行你的脚本：

node your_script.js

这将设置 Composio SDK，并使用提供的指令执行一个在 GitHub 上创建 issue 的代理。

欲了解更多详情，请参考 Composio SDK 文档。

💡 示例

Python 示例

Javascript 示例

Star 历史

📋 阅读我们的行为准则

作为我们开源社区的一部分，我们对沟通的标准要求很高。作为本项目的参与者和贡献者，你同意遵守我们的 行为准则。

🤗 贡献

Composio 是开源的，我们欢迎任何贡献。请 fork 仓库，为你的功能创建一个新分支，添加你的功能或改进，然后发送 pull request。

在开始之前，请务必阅读我们的 贡献指南 和 行为准则。

🔗 链接

• 主页
• 贡献指南
• 文档

🛡️ 许可证

Composio 采用 Elastic 许可证，详情请参阅 LICENSE 文件。

💪 感谢所有贡献者

<a href="https://github.com/composiohq/composio/graphs/contributors"> <img src="https://contributors-img.web.app/image?repo=composiodev/composio" alt="贡献者列表"/> </a>