SuperAPI AI 工具集

stackbone-integrations

通用与其它

查看项目

更新于 10-16 04:31

技能介绍

用途:当 Stackbone 智能体或工作流需要与外部系统互通(接收事件或向外写入)时,用本技能了解接线步骤、各操作面能做什么,以及每步的约束。

事实来源:文档通过 MCP 的 stackbone-docs 服务器提供(https://docs.stackbone.ai/mcp,公开,工具 search_docs、get_doc、list_docs)。先 list_docs,再按标题取 Integrations、Trigger events、Destinations 三页,不要凭记忆输入路径。连接器目录不在文档里,而在 box 上,通过提供方自己的 OpenAPI 文档实时读取。若会话中没有 stackbone-docs 工具,可抓取 https://docs.stackbone.ai/llms.txt 获取同一索引。

接入 box:连接、触发器链接与绑定属于 box 状态,需先把客户端指向 box,例如本地 box:claude mcp add --transport http my-box http://127.0.0.1:4242/mcp。随后按名称操作,不要全量扫描:list_operations 有上限,超过会返回 catalog_too_large,因此要传 tag(connect、trigger-subscriptions、destinations),读取返回的 id,再 describe_operation。读走 call_read_operation,写走 call_write_operation,用错会在执行前被拒绝。

各操作面能力:CLI 无法完成接线,它没有 connectors 命令,只能以事件本应携带的输入启动工作流。注册连接器与凭据、给出授权链接、武装触发器、绘制或试运行映射、绑定输出、排空滞留输出需通过 box MCP 或 Studio;完成提供方登录必须由人在浏览器中操作;声明工作流输出只能由代码完成。

入站顺序:注册连接器并配置凭据(需 owner 或 admin);OAuth 提供方需连接账号,授权链接一次性且几分钟内过期;创建触发器链接(事件、工作流、轮询凭据、作用域值);映射事件到工作流输入并保存;最后开启。开启时游标从当下开始。

出站:工作流导出 declaredOutputs(字面名称与 kind),操作员把 (工作流, 输出名) 绑定到连接器、账号及文件夹。

关键限制:先保存映射再开启链接,否则事件被拒且游标仍前进,不会重试;空白映射画布不等于空映射,保存会覆盖;重命名输出会使绑定孤立;不要写入正在监视的文件夹,否则会循环触发;连接器作用域在注册时冻结,加作用域需重新注册并重连。

本技能不涵盖:API 密钥、编写智能体或工作流本身、选择购买哪个连接器。