网页信息助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/agentql-automation
技能介绍
当工作流需要动态连接外部服务时
手动管理多个工具的连接状态与参数传递,往往让自动化脚本变得脆弱。尤其是在工具schema频繁变更的环境下,硬编码参数容易导致执行中断,而反复检查连接状态又浪费大量时间。
工具发现与连接管理
该技能通过Rube MCP统一编排Composio的Agentql工具包,核心能力包括:
- 动态工具发现:每次执行前调用
RUBE_SEARCH_TOOLS获取最新工具列表与输入规范,避免硬编码参数失效 - 连接状态监控:通过
RUBE_MANAGE_CONNECTIONS检查Agentql连接是否为ACTIVE状态,自动触发授权流程 - 批量操作支持:利用
RUBE_MULTI_EXECUTE_TOOL实现多工具串联执行,会话ID在流程内复用提升效率 - 分页自动续传:响应中包含分页令牌时,自动继续抓取数据直到完整
执行与复用
标准执行流程分为三步:
- 搜索工具:用自然语言描述需求,获取匹配的工具slug与推荐执行计划
- 确认连接:检查当前Agentql连接状态,若未激活则跳转授权页
- 执行任务:按发现的参数规范调用工具,支持单次执行与批量操作
工程实践要点
- 禁止在代码中硬编码工具参数,必须动态获取schema
- 执行前必须验证连接状态,避免因授权过期导致失败
- 会话ID仅在流程内复用,新任务必须生成新ID
- 处理分页响应时需检查
next_page_token字段,持续抓取直到字段为空 - 批量操作优先使用
RUBE_REMOTE_WORKBENCH,其内部封装的run_composio_tool()方法已优化执行链路
使用场景
- 需要通过 Agentql 工具包执行多步骤任务时,先调用 RUBE_SEARCH_TOOLS 发现可用工具再执行
- 外部服务连接状态可能过期,执行前需用 RUBE_MANAGE_CONNECTIONS 确认 Agentql 连接为 ACTIVE
- 批量操作多个 Agentql 工具时,用 RUBE_MULTI_EXECUTE_TOOL 串联执行并复用会话 ID
- 抓取分页数据时,需检查响应中的 next_page_token 并持续请求直到为空
适合人员
- 需要构建自动化工作流的后端工程师,关注工具参数动态获取与连接管理
- 集成外部 API 的平台工程师,需要通过 MCP 协议统一管理多个服务连接
- 处理多步骤任务的自动化工程师,关注会话复用与批量执行链路优化
- 维护 Agentql 工具包的开发者,需要跟踪 schema 变更并动态适配执行逻辑