用途:从已交付的 ITSM Fulfiller 模板(svc_itsm_intelligence__ITSrvcMgmtFulfiller,masterLabel "IT Service Fulfiller")的 Agent Script 创建并激活 IT Service Fulfiller 智能体,作为 NGA(Next-Gen Authoring)原生智能体,会原生出现在 Agentforce Studio 的 Agents 列表中。该智能体面向 IT 技术人员,用于事件分诊、案例摘要、字段更新与相关记录自动化;员工自助侧由另一技能 service-itsm-agentic-setup-employee-agent-configure 处理。不使用旧的 /connect/service-itsm/createAgent 路由。
主要能力与流程:全部通过 Salesforce CLI(sf)完成。先用 GET /services/data/v67.0/agentforce-studio/access/Agents 确认 Studio 访问权限,并用 GET /services/data/v67.0/connect/service-itsm/agent-templates?agentType=AgentforceEmployeeAgent 读取模板与 agentScript。随后以 SOQL 查询 BotDefinition/BotVersions 判定幂等(主键为模板 botDefinitionId,回退 AgentTemplate 与 developerName):已存在且最新版本 Active 则跳过;最新版本 Inactive 则提供重新激活选项。创建路径依次为 POST /nextgen-authoring/bundles(createBundleWithVersion)、POST .../bundle-versions/{id}/publish、POST .../bundle-versions/{id}/activate;重新激活路径为 POST /connect/bot-versions/{latestVersionId}/activation,请求体 {"status":"Active"}。最后用 sf data query 校验 BotDefinition 存在且最新版本 Active。
必要用法与规则:需 sf CLI 已认证到目标组织(sf org display -o <alias> 显示 Connected)、API v67.0+、已开通 ITSM 功能并预置 Fulfiller 模板、PATH 中 node ≥ 18。所有调用使用 --target-org <alias>;禁止手工提取 access token,直接使用 sf api request rest / sf data query。sf data query 需加 --json(结果在 .result.records[]),sf api request rest 不加 --json。写操作前必须通过 AskUserQuestion 展示 developerName 与 label 并要求明确 "yes";默认 developerName 为 IT_Service_Fulfiller_Agent,默认 label 为 IT Service Fulfiller Agent。
适用场景:在已具备 ITSM 与 Agentforce for IT Service 的组织中,用 CLI 快速创建、发布并激活技术人员侧 Fulfiller 智能体,并支持重复运行时的幂等跳过或重新激活。
限制:不覆盖 Employee 智能体、组织级功能开关启用(由 service-itsm-agentic-setup-agentforce-studio-validate 校验)、底层 topic/action 编写、权限集分配、content-bundle 部署、CMDB CRUD、Discovery / Service Graph,也不使用旧的 createAgent 路由。前置条件不满足时会出现认证或 401/403/404 错误,应原样呈现并停止,不得编造状态。