@ever-works/composio-plugin (英语)
Composio 集成管插件 - 执行 Composio 工具在工作生成期间跨越500+第三方应用.
插件元数据
| 外地 | 数值 |
|---|---|
| 身份证 | composio |
| 类别 | pipeline |
| 能力 | pipeline, (中文(简体) ), form-schema-provider |
| 作者 | 永远工作团队 |
| 许可证 | AGPL-3.0 导弹 |
| 内建 | 对 |
| 可自动启用 | 没有 |
作曲插件是做什么的?
此插件允许 Ever Works 调用任何 组合'500+第三方集成(Gmail, Slack, GitHub, Notion, Linear, Salesforce, HubSpot, Frede, Shopify, Airtable,.)在工作生成期间. 作曲经纪 OAuth 代表您——每个用户一次通过作曲经纪主机流量连接一个应用,平台再利用该连接执行工具.
与其为用户想要整合的每一项服务写出每个应用程序的连接器,不如将一个插件(这个)传送给用户,用户则得到整个Composio目录. 插件通过官方引用工具 @composio/core SDK(每个工作空间AGENTS.md NN #22 ——总是使用官方供应商SDK),并将结果作为管道输出返回到三种形状之一:结构 { items: [...] },带有场地映射的原生记录,或只具有副作用(火与遗忘).
为什么用它?
- 获得500+集成而不写入连接器代码.
- OAuth 为您处理 : Composio 管理符、 刷新、 范围、 和利率限制 .
- 用户账户:每个用户在不共享证书的情况下连接自己的Gmail / Slack / GitHub.
- 三种执行形状——结构化项目,通过场地映射的本土记录,或副作用——来匹配不同的使用案例.
- 与原生 Ever Works 插件(github,概念-extractor,.)共存——在存在时使用专用插件,作曲用于其他一切.
怎样在永生工作
当选择此插件为活动管道时, 平台驱动 a Composio 客户端来自 @composio/core 通过6个相继步骤:
- 验证组合连接 —— 说
composio.toolkits.get(...)确认接受 API 密钥,然后composio.connectedAccounts.list({ userIds, toolkitSlugs })确认用户对请求的工具包有ACTIE连接账户. - 准备工具有效载荷 - 建设
arguments对象带有工作元数据、可选的现有项目摘要、可选的 GitHub 数据存储器以及任何用户提供的工具参数. - 执行计算工具 —— 说
composio.tools.execute(toolSlug, { userId, arguments })SDK解开v3响应信封({ successful, data, error, log_id }为了我们. - 收集验证结果( V) ——对响应进行解析,必要时将项目记录到工作项目上,与现有项目相去相去.
- 抓取屏幕截图 (可选) — 使用已配置的截图插件来获取没有它们的项目的图像 .
- 清理 ——释放资源.
插件处理 工具键 作为某一行动的独特标识符(GMAIL_SEND_EMAIL, (中文(简体) ), GITHUB_CREATE_ISSUE(中文(简体) ). 工具包的弹片是信息化的,用于连接账户的验证.
开始
- 报名到 composio.dev (英语) 并抓取您的 API 密钥从 设置 ~ API 密钥。 。 。 .
- 在您的混编下连接至少一个工具包( Gmail, GitHub, Slack,...)
user_id透过作曲仪表板. - 在 Ever Works 中打开 Composio 插件设置并粘贴 API 密钥 。 如果上游账户在不同的标识符(通常是电子邮件)下连接,则设置 默认组合用户 ID 对这个价值.
- 在那个 生成 流程,设置工具包(例如:.
GMAIL),工具弹(例如.GMAIL_SEND_EMAIL),结果形状,任何自定义工具参数,然后触发运行.
设置
apiKey(单位:千美元)隐藏—— 作曲 API 密钥, 传递给@composio/core施工时间为SDK.baseUrl—— 覆盖 Composio API 基础 URL( 默认留空)https://backend.composio.dev/api/v3) (中文(简体) ).defaultUserId——作曲user_id以运行工具对抗。 默认为您的 Ever Works 用户 ID .defaultToolkit——默认工具包弹(例如.GMAIL) (中文(简体) ).defaultToolSlug– 默认作曲工具 slump(例如.GMAIL_SEND_EMAIL) (中文(简体) ).
生成器还额外暴露了每个运行的选项,包括工具包、工具流、Composio用户ID覆盖、结果形状、本地记录的实地映射、自定义工具参数和工具超时.
结果模式
- 结构化项目 ——当工具返回时使用
items匹配工作项目形状的矩阵. - 土著记录 ——当工具返回原始记录(Gmail messages,Notion pages, GitHub Issues,.)时使用,并且您想要映射诸如名称,URL,描述,类别,标签,图像,品牌,或内容等字段.
- 仅副作用 ——当工具应当发送消息,创建任务,更新另一个系统,或者触发另一个工作流程而不添加工作项目时使用.
作曲对本地 Ever 工程插件
Ever Works 运送一些本地插件(github, (中文(简体) ), notion-extractor直接与具体服务相结合。 作曲给你剩下的目录. 它们并存:为其覆盖的应用程序保留原生插件,并使用作曲来做其他一切. 本地插件通常提供更紧凑的集成(ricer distruction,自定义的UI提示,OAuth通过Ever Works自己的回调;Composio提供宽度.
解决问题
| 症状 | 可能的原因是 | 修补 |
|---|---|---|
世代从不开始/留在 0% | composio 未选择此工程的运行中的管道插件 | 打开工作 插件 → pipeline 能力和设置 composio 作为活动管道;或 设置为全球管道默认 设置 — 插件 |
Composio rejected the API key (HTTP 401/403) | API 密钥丢失或无效 | 于 https://app.composio.dev/ settings/api-keys 页面存档备份,存于互联网档案馆 粘贴到插件设置中 |
No active Composio connected account found for user "..." on toolkit "..." | 用户未连接请求的工具包, 或连接为 EXPIRED 编号 : REVOKED | 打开 https://app.composio.dev/connections 互联网档案馆的存檔,存档日期2014-10-02 并完成(或重新启动)工具包的OAuth流 |
Composio returned 404 for /tools/execute/... | 工具弹片错误或已重命名 | 浏览 https://app.composio.dev/tools (英语) 以查找当前 sattle; 工具 sattle 是大写和工具包前缀 |
| 工具成功但未返回项目 | 工具返回本地记录, 不是结构化项目 | 切换 结果形状 到“国内记录”并设置实地绘图(至少) name_field(中文(简体) ) |
地方发展
这个插件船与Ever Works平台一起内置. 从单列波根进行本地研究:
pnpm install
pnpm --filter @ever-works/composio-plugin build
pnpm --filter @ever-works/composio-plugin test
文档
许可证
AGPL-3.0 导弹