SuperAPI AI 工具集

cargo-cli-connection

通用与其它

查看项目

更新于 10-15 21:51

技能介绍

用途:通过 Cargo CLI 管理连接器(Connector)与集成(Integration),包括列出连接器、发现可用集成、管理已认证的连接器实例,并在工作流节点中引用连接器动作。

主要概念:集成是外部服务类型(如 HubSpot、Clearbit、Salesforce),定义可用动作;连接器是某个集成的已认证实例,一个集成可有多个连接器,工作流节点图中引用的是连接器。

必要准备:先执行 npm install -g @cargo-ai/cli,再用 cargo-ai login --token <your-api-token> 登录,登录时可用 --workspace-uuid <uuid> 指定工作区,最后用 cargo-ai whoami 验证。未全局安装时,所有命令前加 npx @cargo-ai/cli 代替 cargo-ai。命令失败以非零退出并返回 {"errorMessage": "..."}。

主要能力:

  • 连接器管理:cargo-ai connection connector list、connector create(需 --integration-slug、--slug、--name)、connector update、connector remove、connector get、connector exists-by-slug。
  • 集成发现:cargo-ai connection integration list(支持 --category、--search、--slug、--has-actions、--has-extractors 过滤)、integration get <slug>、integration get-documentation <slug>、native-integration get。
  • 注意:integration get <slug> 返回第三方服务专属动作,native-integration get 只返回 Cargo 内置通用动作,两者不可互换。
  • OAuth 集成的认证流程通过 connection integration complete-oauth 单独完成。

在流程中使用:先 connector list 找到 connector UUID,再用 integration get <slug> 发现 actionSlug 及 config.jsonSchema,然后在节点图中引用连接器与动作。第三方连接器有速率限制,可通过 cargo-cli-orchestration 的 polling.md 和 troubleshooting.md 处理;原生集成无速率限制。

限制:本资料未提供具体收费、价格信息,也未提供 OAuth 流程的具体参数与完整节点语法,相关细节需参考对应引用文档。每个命令均支持 --help 查看帮助。