SuperAPI AI 工具集

circleci-automation

智能体与模型

查看项目

更新于 10-15 20:25

技能介绍

用途:通过 Composio 的 CircleCI 工具包,经 Rube MCP 自动化 CircleCI 的 CI/CD 操作,包括触发流水线、监控工作流与作业、获取构建产物和测试元数据。工具包文档见 composio.dev/toolkits/circleci。

前提条件:需连接 Rube MCP(RUBE_SEARCH_TOOLS 可用);通过 RUBE_MANAGE_CONNECTIONS 建立并激活 toolkit 为 circleci 的连接;每次操作前应先调用 RUBE_SEARCH_TOOLS 获取当前工具结构。

设置:在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器,无需 API 密钥;确认 RUBE_SEARCH_TOOLS 有响应;调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit circleci;若连接非 ACTIVE,按返回的授权链接完成 CircleCI 认证;确认状态为 ACTIVE 后再运行工作流。

主要能力与用法:触发流水线用 CIRCLECI_TRIGGER_PIPELINE,参数含 project_slug(格式 gh/org/repo 或 bb/org/repo)、branch 或 tag(二者互斥)、parameters;监控用 CIRCLECI_LIST_PIPELINES_FOR_PROJECT 与 CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID,可选 CIRCLECI_GET_PIPELINE_CONFIG;查看作业用 CIRCLECI_GET_JOB_DETAILS,参数为 project_slug 与 job_number;获取产物用 CIRCLECI_GET_JOB_ARTIFACTS;查看测试结果用 CIRCLECI_GET_TEST_METADATA。层级为流水线→工作流→作业。

限制与注意:流水线和工作流 ID 为 UUID,作业号为整数,不可混用;project_slug 必须含 VCS 前缀且大小写敏感,格式错误会返回 404;branch 与 tag 互斥;流水线参数须与 .circleci/config.yml 中定义一致;产物仅在作业完成后可用,下载可能需认证头且有大小限制;测试元数据需作业上传 JUnit XML 结果,否则为空;API 有速率限制,遇 429 应指数退避,避免快速轮询,建议间隔 5-10 秒;分页用 page_token,直到 next_page_token 缺失或为 null。