零售运营助手

零售运营里，订单、库存、商品数据散落在 Brightpearl 里，脚本和人工操作容易因为工具接口变动而失效——工具名改了、字段类型变了，写死的代码第二天就跑不通。这个技能的思路是把调用 Brightpearl 这件事交给 Rube MCP 动态发现，而不是预先硬编码。

它解决什么问题

直接对接 Brightpearl API 需要自己处理鉴权、分页、字段命名，而且 Brightpearl 的接口能力通过 Composio toolkit 暴露时，可用工具集合是会变化的。这个技能用 Rube MCP 作为中间层，让你在运行时先搜索工具、拿到当前 schema，再执行，避免把接口细节写死在流程里。

核心能力与工作步骤

• 工具发现：每次执行工作流前先调用 RUBE_SEARCH_TOOLS，拿到可用的 tool slug、输入 schema、推荐执行计划和已知坑点。
• 连接管理：通过 RUBE_MANAGE_CONNECTIONS 并指定 toolkit brightpearl，确认连接状态为 ACTIVE；未激活时按返回的授权链接完成配置。
• 执行与批量操作：用 RUBE_MULTI_EXECUTE_TOOL 执行已发现的工具；批量场景走 RUBE_REMOTE_WORKBENCH 里的 run_composio_tool()。
• 完整 schema 获取：对带 schemaRef 的工具，用 RUBE_GET_TOOL_SCHEMAS 拉取全量定义。

标准流程是三步：先发现工具，再检查连接，最后执行。Rube MCP 的接入本身不需要 API key，只要在客户端配置里加上 https://rube.app/mcp 这个 endpoint 即可。

适用边界与注意点

• 不要硬编码：tool slug 和参数必须来自 RUBE_SEARCH_TOOLS 的结果，字段名和类型要严格照抄，否则调用会失败。
• 必须先查连接：执行任何工作流之前，确认 RUBE_MANAGE_CONNECTIONS 返回 ACTIVE。
• memory 参数必填：调用 RUBE_MULTI_EXECUTE_TOOL 时即使没有上下文也要传空对象 {}。
• 会话复用：同一个工作流内复用 session ID，新工作流才生成新的。
• 注意分页：响应里出现分页 token 就要继续拉取，直到数据完整。

它适合需要频繁操作 Brightpearl、且希望流程对接口变化有韧性的场景；如果你的流程完全固定、不关心 schema 漂移，动态发现的开销可能并不划算。