用途:管理 Cargo CLI 中的连接器(Connector)与集成(Integration),即把 Cargo 连接到外部系统并查看其可用能力。集成指外部服务类型(如 HubSpot、Clearbit、Salesforce),定义可用动作;连接器是某个集成的已认证实例,一个集成可有多个连接器,工作流节点中引用的是连接器。
主要能力:列出与筛选集成、创建/更新/删除连接器、获取单个集成的动作与输入 schema、获取 Cargo 内置动作(native-integration get 不含第三方动作)、通过 connector autocomplete 动态获取动作字段的候选值。获取 autocomplete slug 需查看动作 config 的 uiSchema 中 ui:widget 为 IntegrationAutocompleteWidget 的 ui:options.slug;带依赖字段时把 $this.$parent 表达式替换为实际值。响应 results 中 label 为显示名,value 用于节点配置。
使用方式:需已登录或先执行 npm install -g @cargo-ai/cli,再 cargo-ai login --email you@company.com(也支持 --oauth、--token <api-token>),用 cargo-ai whoami 确认工作区。常见命令如 cargo-ai connection connector list、connection connector create(需 --slug、--name、--integration-slug)、connection integration list/get、connection connector autocomplete。所有命令输出 JSON,失败非零退出并返回 errorMessage。
适用场景:为工作流节点查找并解析连接器与动作、检索动作输入 schema、获取动作字段候选值、判断集成是否已弃用(isDeprecated: true)。
限制:第三方连接器存在速率限制与重试配置问题,原生集成无速率限制;集成弃用不影响既有连接器,但不应将新工作流接到弃用集成。创建/运行/批处理等异步命令需 --wait-until-finished 或轮询。动作的输入字段位置在 actions.<slug>.config.schema;顶层动作 execute/execute-batch 的输入须放在 --data 而非 config,工作流节点内则放节点 config。字段要求 autocomplete 时必须先解析,LinkedIn 相关动作需 identityIds。OAuth 流程通过 connection integration complete-oauth 完成。具体认证字段、版本要求(如 action list 需 CLI ≥ 1.0.66,action search 需 ≥ 1.0.36)与管理员权限以官方文档为准,资料未提供定价信息。