用途:通过 Salesforce CLI(sf)从 ITSM Employee 模板的 Agent Script 创建并激活“IT 服务员工智能体”,使其作为 Next-Gen Authoring(NGA)原生智能体出现在 Agentforce Studio 的 Agents 列表中。不调用旧的 /connect/service-itsm/createAgent 路由,而是复用模板的 agentScript 字段走 NGA bundle 流程:POST /nextgen-authoring/bundles → POST /nextgen-authoring/bundle-versions/{id}/publish → POST /nextgen-authoring/bundle-versions/{id}/activate。
主要能力:读取 agent-templates(agentType=AgentforceEmployeeAgent),返回广义模板及约 47 个 svc_emp_intelligence__ 命名空间下的专用 Employee 模板;提取模板 Agent Script;以 createBundleWithVersion→publish→activate 创建 NGA 原生智能体;用 SOQL 幂等检查与创建后验证;重复 developer name 时优雅跳过;对已存在但未激活的版本提供重新激活选项。辅助脚本 classify-preflight.mjs、classify-agent-existence.mjs、build-create-body.mjs、render-report.mjs 负责解析与决策。
使用方式:需要已认证的 sf CLI(sf org display -o <alias>)、API v67.0+、已配置 ITSM 功能与模板、node ≥ 18。所有调用使用 --target-org <alias>,命令如 sf api request rest 与 sf data query。分类流程:Phase 0 建立临时目录,Phase 1 预检 Studio 访问与模板,Phase 2 幂等检查(主键 botDefinitionId,回退 AgentTemplate 再回退 developerName),Phase 2b 重新激活询问,Phase 3 写前必须明确确认,之后创建、发布、激活、验证。
限制:不负责 Fulfiller 智能体、不启用组织级功能开关、不做低级主题/动作编写、权限集分配、内容包部署、CMDB 操作、Discovery/Service Graph,也不处理 svc_emp_intelligence__ 之外的 data[] 条目。未满足前置条件时按原始错误停止,不编造状态。禁止手动提取访问令牌。具体命令形状见 references/cli-invocation.md、reactivation.md、error-taxonomy.md、workflow-detail.md、specialized-templates.md(资料未提供这些文件内容)。