SuperAPI AI 工具集

service-itsm-agentic-setup-cmdb-configure

智能体与模型

查看项目

更新于 10-15 21:43

技能介绍

用途:把组织从“CMDB 关闭”推进到“CMDB 功能已启用”,按顺序走完 CMDB 前置栈的前三层。所有调用经 Salesforce 托管的 Headless-360 MCP 服务器(server key headless-360)的四个元工具(discover、describe、dispatch_readonly、dispatch)执行;组织由绑定当前 MCP 会话的 OAuth JWT 推导,技能本身不处理组织 ID、别名或凭据,因此生产与沙箱行为一致。

主要能力与流程: 第 0 层(只读硬门槛)校验组织是否具备 CMDB 许可,通过查询 PermissionSetLicense 中 DeveloperName = 'ItSrvcCnfgItmReadPsl' 判断,totalSize == 1 表示已许可,为 0 则停止并提示该组织未获 CMDB 许可,需在预配组织时包含。 第 1 层预配 CMDB 租户:先读取 /services/data/v67.0/connect/tenantProvisioningStatus,按状态分支;UNPROVISIONED 时经用户确认后 POST 触发,随后轮询至 PROVISIONED。轮询以响应中的 triggeredAt 为锚点(按 UTC 纪元解析,elapsed = max(0, now − triggeredAt)),约 2 分钟下限后每 30 秒一次,总预算 10 分钟;FAILED 时不通过 API 重试,而是给出失败原因与 Setup 页面链接请用户手动重试。 第 2 层启用功能:功能 api 名为 service-cloud-itsm-cmdb-integration,先读取状态,NOT_ENABLED 且 enableBlockedReasons 为空时经确认后 POST enable,再读取状态确认 ENABLED。

使用方式:通过 headless-360 MCP 的 dispatch_readonly(GET)与 dispatch(POST/PATCH)发起原始 HTTP 调用,参数为 url、method、body、queryParams。每次写入前先读、写入后验证;需与用户确认目标组织及每次写入。

适用场景:生产或沙箱组织中启用 Service Cloud ITSM 的 CMDB 功能。

限制:不覆盖权限集分配(第 3 层)、内容包安装(第 4 层)、CMDB 记录 CRUD、Discovery/Service Graph Connector 与识别规则。CMDBEnabled 不能直接设置,只能作为第 2 层启用的副作用翻转。功能状态为 ENABLED 是本技能唯一成功判据,不用 CMDB 数据读取确认。若 dispatch 调用返回认证错误,应提示用户重新认证 headless-360 MCP 连接并停止。面向用户的输出不得暴露内部术语、记录 ID、HTTP 状态码、错误码、端点或开发者名称。