技能介绍

要解决什么问题

如果你在 Agent 里需要对接 Altoviz，又不想手写每一版工具参数、或在连接未就绪时盲目调用接口，这个技能把路径收敛到 Rube MCP 与 Composio 的 Altoviz toolkit：先发现当前可用工具与 schema，再确认账号连接为 ACTIVE，再按 schema 执行。

技能如何工作

前置条件是客户端已接入 Rube MCP（能响应 RUBE_SEARCH_TOOLS），并通过 RUBE_MANAGE_CONNECTIONS 为 toolkit altoviz 完成授权。

推荐工作流可以概括为三步：

发现工具：始终先调用 RUBE_SEARCH_TOOLS，获取 tool slug、输入 schema、推荐执行计划与已知坑点；不要硬编码 slug 或参数。
检查连接：用 RUBE_MANAGE_CONNECTIONS 查看 Altoviz 是否为 ACTIVE；若不是，按返回的授权链接完成配置后再继续。
执行工具：用 RUBE_MULTI_EXECUTE_TOOL 执行已发现的工具；调用时需带上 memory 参数（可为空对象 {}）；同一工作流内复用 session ID，新工作流再生成新 session。

批量或脚本化场景可走 RUBE_REMOTE_WORKBENCH 里的 run_composio_tool()；需要完整 schema 时可查 RUBE_GET_TOOL_SCHEMAS（含 schemaRef 的工具）。工具包文档见 composio.dev/toolkits/altoviz。

适用边界与注意点

Schema 会变更：每次执行前都应 search，字段名与类型必须与搜索结果一致。
分页：响应里若有分页 token，应继续拉取直到结束。
本技能描述的是 Rube + Composio Altoviz 的自动化编排方式，不包含 Altoviz 产品本身的业务语义说明；具体能做什么以 search 返回的工具列表为准。

截图预览

使用场景

在 Agent 客户端已接 Rube 时，对话里先 `RUBE_SEARCH_TOOLS` 再按返回 schema 执行 Altoviz 工具，避免硬编码 slug。
新环境或 token 过期后，通过 `RUBE_MANAGE_CONNECTIONS` 拿到授权链接，把 altoviz 连接确认为 ACTIVE 再跑流程。
同一业务流内连续多次 Altoviz 调用，用 `RUBE_MULTI_EXECUTE_TOOL` 并复用 session ID，且每次带上 `memory` 参数。
分页结果未一次返回完时，根据响应中的 pagination token 循环拉取，直到 Altoviz 侧数据取全。

适合人员

负责在 IDE 里配置 MCP 端点、要把 Altoviz 纳入 agent 可调用工具清单的后端或平台工程师
编写 Composio/Rube 集成说明或技能包、需要落实「先 search、再连、再执行」约束的文档或技能维护者
在对话式环境中替业务方触发 Altoviz 操作、且必须每次核对连接状态与字段类型的自动化编排实施人员
用 `RUBE_REMOTE_WORKBENCH` 做批量 `run_composio_tool()`、需要与单次 MULTI_EXECUTE 分工清晰的脚本化集成开发者