SuperAPI AI 工具集

docyrus-integrations-and-connectors

编程与开发

查看项目

更新于 10-16 05:06

技能介绍

用途:在终端通过 docyrus connect 使用第三方集成。连接器(数据提供方)由平台定义,以 slug 标识(如 msgraph、twilio、meta),打包托管鉴权、可调用动作与数据源。先发现连接器及其动作,再运行动作或经连接器鉴权发起原始请求,无需自行处理令牌。

主要能力:list-connectors 查找连接器;get-connector 查看其 actions[] 与 dataSources[];list-connections 查看租户/用户连接;get-action 查看输入输出 JSON Schema 与请求方法;run-action 执行动作;curl 发起原始鉴权请求。连接账户(子账户,如邮箱、广告账户)通过 docyrus curl "/v1/connectors/{slug}/connection-accounts" 列出,其 id 用作 --connectionAccountId。

使用方式:先确认会话 docyrus auth who --json;再发现连接器与动作;确认连接存在(tenantScope 非空或 userScope.connected 为 true),否则需先在 Docyrus UI 完成连接;有子账户时先列出账户;调用前查看输入 Schema,先 --dryRun 预览再执行。run-action 的 -p 必须是匹配 inputJsonSchema 的 JSON 对象,服务端用 AJV 校验,不匹配返回 400。

限制:本 CLI 不创建连接,无 create-connection 命令,凭据/OAuth 需在 Docyrus UI 或原始 API 设置。连接器用 slug、动作用 slug+key,无 id。run-action 需 Automations.Run 权限,读命令需 Connectors.Read.All。curl 是 RPC 透传,外部方法用 -X 指定。不要臆造 connectionAccountId。有真实副作用(发邮件/短信、写数据)时务必先 --dryRun。动作须存在且启用(status=1),否则 404。账户由租户账户抓取写入,未刷新则无账户,归档账户不返回;可见性随连接而定。