service-itsm-agentic-setup-agentforce-coordinate

ITSM 的 Agentforce 设置协调器

通过展示可用功能、委派给专用子技能并跟踪进度，引导用户在 Salesforce Service Cloud ITSM 中设置 Agentforce Studio、IT Service Fulfiller Agent、IT Service Employee Agent、专用员工 Agent，以及员工 Agent 向人工升级的流程。

目标

担任 ITSM 中 Agentforce 功能配置的协调者。向用户展示可配置功能菜单，为用户选择的每项功能调用相应的子技能。每项功能完成后，返回菜单并更新进度，直到用户完成设置。

行为

1. 提取对话上下文

展示选项前，扫描聊天记录，了解：

• 用户已设置的功能（跳过或标记为已完成）
• 用户提及的偏好或限制（例如：“只启用 Agentforce Studio”“我们已经启用了 Studio”）
• 目标组织（如果有提及）
• 有助于判断哪些功能适用的业务背景

2. 确认目标组织

Agentforce 设置会对真实组织执行写入操作（启用功能开关、创建并激活 Agent）。委派给任何子技能之前，先向用户确认目标组织，并明确说明将修改该组织。绝不要假设可以安全地修改生产环境——必须征得用户对该组织的明确确认。

3. 将 Agentforce 功能菜单设为多选

向用户展示可选项和已完成项，并按两个依次进行的设置阶段整理—— 阶段 1：启用平台功能（启用 Agentforce Studio）和阶段 2：安装并激活 Agent 模板（Fulfiller 和 Employee Agent）。这种区分至关重要： 阶段 1 启用组织级平台开关和偏好设置，而阶段 2 则根据模板安装并激活 Agent。它们属于不同类型的操作，必须明确显示为不同阶段，而不是合并成一个不加区分的列表。菜单中只显示具有可用子技能的功能——使用 examples/output-templates.md 中的 Feature menu 模板。通过一个多选提示收集用户选择（工具支持时使用 AskUserQuestion 并设置 multiSelect: true，否则请用户用数字列表回复，例如 1, 2）。多选选项标签必须使用 Feature menu 表格中的确切 Item 名称，逐字保留，包括每项的括号备注、单词“Agent”及其大小写（Agentforce Studio enablement (Foundation for all agents)、IT Service Fulfiller Agent、IT Service Employee Agent、Specialized Agents for Employee、Employee Agent escalation），确保选择器选项与表格始终一致。每项的 Description 列必须与 Salesforce Setup → Agentforce for IT Service 页面上的措辞一致（Fulfiller 和 Employee Agent 模板说明以及 Specialized Agents for Employee 文本均须逐字保留），以便用户评估要安装哪个模板时，在此处读到的用途和范围与 Setup 中相同——不得改写或缩短这些产品文案。对于三项阶段 2 Agent 项目，须在逐字保留的产品文案后附上一行简短的 Setup:，说明安装会执行什么操作（Fulfiller 和 Employee Agent 使用 Setup: creates the agent from this template and activates a version.；Specialized Agents for Employee 使用 Setup: pick one specialized template (e.g. Password Manager, Onboarding), then create and activate that standalone agent. Re-run this item to add more.；对于 Specialized Agents for Employee，须先询问用户想要哪个专用模板，并将其名称传递给子技能），让单行同时包含用途、范围和安装操作。阶段 1 的行（Agentforce Studio enablement）是平台启用开关，而不是模板安装，因此不添加 Setup: 行。调用 AskUserQuestion 时，每个选项的 description 字段都要填入同样的 Description 文本（产品文案 + Setup: 行），以便选择器也展示详细信息。不要显示无法执行的占位功能。

报告文件（harness / 非交互运行）。 如果提供了 ${outputDir}（通过 harness 生成文件位置指令提供），则须在调用 AskUserQuestion 之前将菜单输出（署名标头 + 含状态的功能表 + 委派目标 + 依赖信号 + 多选提示本身）写入 ${outputDir}/report.md——这样即使 harness 停在确认关卡，报告文件也始终存在。每项功能完成后，使用更新后的状态表覆盖同一文件。通过聊天界面与用户交互运行时跳过这些写入；仅当 ${outputDir} 作为显式目标传入时才写入。

4. 按依赖顺序委派给子技能

Studio 优先规则（无条件）。 如果用户的选择中包含 Agentforce Studio 启用（#1），且尚未完成，则始终先执行该步骤——无论用户列出编号的顺序如何。Fulfiller Agent（#2）、Employee Agent（#3）和 Specialized Agents for Employee（#4）都依赖 Studio 已启用，若先尝试这些步骤，则会失败。请在队列中静默调整顺序，确保先运行 Studio，再运行任何 Agent。此规则不可协商，无论用户选择的是两个功能（Studio + 一个 Agent）还是全部功能，均适用。Employee Agent 升级（#5）是设置后的操作，同样绝不会在 Studio 之前运行。

用户顺序规则（仅适用于 #2、#3 和 #4）。 Fulfiller Agent（#2）、Employee Agent（#3）和 Specialized Agents for Employee（#4）彼此独立——互不依赖。如果选择了多个，则按用户列出的顺序运行（未指定时默认为 2 → 3 → 4）。此规则仅适用于 #2、#3 和 #4 之间的排序；绝不会覆盖上述 Studio 优先规则。

先完成 Employee 再执行升级的规则（#5 依赖 #3）。 Employee Agent 升级（#5）用于配置 Employee Agent 移交给人工处理，因此要求 Employee Agent（#3）已存在且处于 Active 状态。如果选择了 #5，请确保本次运行中 #3 已成功完成（或之前已完成），然后再委派给它；否则将 #3 排在 #5 之前。#5 同样绝不会在 Studio（#1）之前运行。

创建后授予运行时访问权限规则（无条件）。 每当任何 Stage 2 Agent（#2、#3、#4）在本次会话中返回有效判定（CREATED/ALREADY-CREATED/ACTIVATED）时，请在队列末尾追加一个自动的 Stage 3 运行时访问权限步骤——这是与 Studio 优先规则这一前置条件相对应的后置条件：始终追加，绝不作为菜单选项——并在最后一个 Stage 2 Agent 之后委派一次给 service-itsm-agentic-setup-agent-runtime-access-assign，涵盖所有刚刚变为有效状态的 Agent（其目标用户 + 写入前确认门槛决定授权；Stage 3 确保的是提供授权选项，而非静默授予权限）。此规则不可协商：如果未设置这些权限，有效 Agent 的操作会因用户权限缺失而失败。仅运行 Studio 或没有 Agent 变为有效状态（FAILED/PARTIAL/PENDING CONFIRMATION/DECLINED，或者 Stage 2 验证导致队列停止）时，不要追加该步骤。叙述 + 状态映射：见 examples/output-templates.md 中的 运行时访问权限移交。

#	功能	阶段	子技能
1	启用 Agentforce Studio（所有 Agent 的基础）	1	service-itsm-agentic-setup-agentforce-studio-configure
2	IT Service Fulfiller Agent	2	service-itsm-agentic-setup-fulfiller-agent-configure
3	IT Service Employee Agent	2	service-itsm-agentic-setup-employee-agent-configure
4	Specialized Agents for Employee	2	service-itsm-agentic-setup-employee-agent-configure
5	Employee Agent 升级	后置	service-agentforce-human-escalation-configure（传入 IT 场景输入：Agent IT_Service_Employee_Agent、队列 General_IT_Queue、CONTEXT_OBJECT=MessagingSession）
—	运行时访问权限（任何 Stage 2 创建/激活后自动执行；绝不作为用户选项）	3	service-itsm-agentic-setup-agent-runtime-access-assign
IT Service Employee Agent 与 Specialized Agents for Employee。 二者都会委派给同一个子技能
service-itsm-agentic-setup-employee-agent-configure——区别在于它安装的模板。IT Service Employee Agent 会安装功能广泛、开箱即用的员工 Agent（未指定专门类型时，子技能默认选择此项）。Specialized Agents for Employee 则会安装专门类型；但只有在指定专门模板名称时，子技能才会采用专门类型的路径。如果没有提供名称，它会悄悄回退到功能广泛的 Agent，从而重新创建 IT Service Employee Agent。因此，委派给 Specialized Agents for Employee 之前，先询问用户想要哪种专门的员工 Agent——提供常见示例（Password Manager、Certificate Management、Onboarding、Hardware Request），说明还有更多选项，并让子技能消除名称不完整或含糊之处；然后使用指定的专门类型进行委派（所选模板会命名该 Agent）。绝不要在未指定专门类型的情况下委派给 Specialized Agents for Employee——这是唯一会导致重复创建功能广泛 Agent 的情况。专门模板本身会在 Stage 1 中启用；此项负责基于其中一个模板构建并激活 Agent。

service-itsm-agentic-setup-agentforce-studio-configure 会自行执行读取并分类的预检（写入前读取实时切换状态），而不会委派给 service-itsm-agentic-setup-agentforce-studio-validate——该技能是独立的只读入口，用户可直接调用，以便在不进行写入的情况下检查就绪状态。此编排器无需在上述委派流程中调用它。

5. 每项功能完成后

子技能完成后：

1. 验证子技能自身的确定性判定：运行 node "<skill_dir>/scripts/verify-child-verdict.mjs" <studio|fulfiller|employee|escalation|runtime> <verdict>——绝不要在说明文字中重新推导成功或失败的比较结果。将 Studio 的 overall 字段（来自 classify-final-report.mjs）、Fulfiller/Employee Agent 的 Phase 8 汇总判定、escalation 叶节点的 status（CONFIGURED/ALREADY-CONFIGURED），或 runtime-access 技能的 Phase-7 汇总判定作为 <verdict> 传入。退出代码 0 表示继续；退出代码 1 表示停止并用通俗语言说明失败——不要继续处理队列中的下一项功能。 Studio 部分启用（例如，Einstein GenAI 已开启，但上级总开关仍被阻止，overall: PARTIAL）也会导致 Fulfiller/Employee Agent 创建失败，因此该脚本在判定是否继续时会将 PARTIAL 与 FAILED 同等处理。
2. 更新状态——将已完成的功能标记为“Done”
3. 建议下一步——如果还有其他可用功能，根据依赖顺序提出建议
4. 重新显示菜单并更新状态——使用 examples/output-templates.md 中的 Post-feature progress 模板
5. Stage 2 队列处理完毕后执行 Stage 3。 当 Stage 2 队列中已没有 Agent，且本次会话中至少有一个 Agent 已上线时，按上述规则委派一次追加的 Stage 3，并使用 verify-child-verdict.mjs runtime <verdict> 进行验证——退出代码 0 ⇒ Stage 3 Done → 完成摘要；退出代码 1 ⇒ 停止并用通俗语言说明。

6. 完成摘要

用户表示已完成（或所有可用功能均已配置）时，使用 examples/output-templates.md 中的 Completion summary 模板提供最终摘要。

---

设置阶段和推荐顺序

设置分为 两个连续的设置阶段，之后可选择进行升级操作。必须先完成阶段 1（启用平台功能），再进行阶段 2（安装并激活 Agent 模板）。 只有在 Employee Agent 激活后，才能进行升级操作。

Stage 1 — Foundation: enable platform features
  1. Agentforce Studio enablement (Foundation for all agents)   (turn ON org-level Agentforce + Einstein GenAI feature toggles)

Stage 2 — Agent templates: install & activate   (only after Stage 1)
  2. IT Service Fulfiller Agent          (install from template, commit, and activate the agent)
  3. IT Service Employee Agent           (install the broad employee agent from its template and activate it)
  4. Specialized Agents for Employee     (install a specialized employee agent — user picks the template — and activate it)

Stage 3 — Runtime access   (AUTO — after any Stage 2 agent goes live, not a menu pick)
  •  Grant the live agent(s)' runtime feature permissions + an Agent Access permission set

Post-setup — Human escalation   (only after item 3 is active)
  5. Employee Agent escalation           (configure canEscalate, outbound routing, a staffed General IT queue, and failure-threshold directives)

阶段 1（启用 Agentforce Studio）是基础——它会开启组织级别的 Agentforce 和 Einstein GenAI 开关，所有 Agent（包括专用员工模板）都基于这些功能构建，因此必须先启用；在此之前尝试安装或激活任何 Agent 都会失败。阶段 2 的三个项目彼此独立，完成阶段 1 后可自由安排顺序；Specialized Agents for Employee 紧接在 IT Service Employee Agent 之后，因为二者都基于同一个子技能构建员工 Agent（前者是通用默认模板，后者是用户选择的专用模板）。Employee Agent 升级操作（针对已运行的 Employee Agent 进行的设置后操作）和阶段 3（运行时访问）（任何阶段 2 Agent 上线后自动进行，并非菜单选项）均按上述规则执行。

规则

• 设置标题中始终显示“(via service-itsm-agentic-setup-agentforce-coordinate)”
• 执行任何操作前始终先展示功能菜单；不要假设用户想要哪个功能
• 始终以多选形式展示功能菜单；允许用户在一次交互中选择一个或多个功能
• 绝不在用户选择功能前设置该功能。（明确选择可确保用户确认意图，并避免用户在流程中途取消时产生不完整配置；对于批量请求，请使用“设置所有功能”规则中的逐项确认循环。）
• 绝不展示没有可用子技能的功能
• 如果用户说“设置所有功能”或“全部”，按建议顺序逐个处理所有可用功能，并在每个步骤之间进行确认
• 跟踪整个对话中的进度；不要将已完成的功能重新显示为“未完成”
• 员工专用 Agent（#4）可重复选择——每次运行都会根据用户选择的模板构建一个不同的专用员工 Agent。将刚构建的 Agent 标记为已完成，但仍保留 #4 供用户再次运行，以便构建其他专用 Agent；不要像一次性项目那样将已完成的 #4 视为永久结束。如果用户再次选择 #4，请询问接下来要使用哪个专用模板
• 员工 Agent 升级（#5）是一个设置后的操作，要求 IT 服务员工 Agent（#3）先处于活动状态——只有在本次运行中 #3 已成功完成或此前已完成后，才能委派 #5
• 如果当前功能失败或仅部分 成功，绝不继续处理队列中的下一个功能——停止并用通俗语言说明失败情况
• 如果 Agentforce Studio 启用检查报告组织缺少 Agentforce 许可证（accessCheck），则停止 整个流程——这是许可证／版本要求，无法通过任何 API 授予；没有该许可证，履行人员或员工 Agent 都无法成功运行
• 委派任何子技能前，始终确认目标组织，并说明将修改该组织
• 不要在面向用户的输出中暴露内部技术术语。这包括 Salesforce 记录 ID 和组织 ID、原始 HTTP 状态码（403、500 等）、API 错误代码（FUNCTIONALITY_NOT_ENABLED、 DUPLICATE_VALUE 等）、内部端点／API 名称、开发者名称（如功能 apiName sales-cloud-agent-studio）以及 CLI／工具内部细节。将所有内容转化为通俗易懂的语言。作为后续步骤指引展示的子技能名称除外
• 绝不在面向用户的文本中仅用数字命名功能。#1–#5 标签（以及菜单中的 # 列）只是本技能排序／委派规则中的内部简写，也是菜单选择标识——用户可回复 1, 2——并非功能名称。在用户看到的每条消息中——包括退出／跳过、前置条件／受阻、进度、后续步骤和完成摘要——都必须写出每项功能的完整名称，绝不只写数字或类似 #4、#1–#3 的范围。阶段 1 开关被跳过时尤其要注意：写出受阻和仍可用的功能名称，不要说“#4 受阻，#1–#3 可以继续”。请参阅 examples/output-templates.md 中的在文本中命名功能
• 如果用户询问尚未提供的 Agentforce 功能（例如 Requester Agent、自定义主题包、Agent 指标仪表板），请告知用户这些功能目前尚未在此编排器中提供，待其子技能合并后将会加入

---

验证清单

在此技能输出任何菜单或摘要前，请在心中确认以下每一项。如果有任何一项未勾选，请先调整输出再发送。

• 标题行以 (via service-itsm-agentic-setup-agentforce-coordinate) 结尾
• 在运行任何子技能前，已与用户确认目标组织，并告知用户该组织将被修改
• 在继续处理下一个排队功能前，已确认当前功能的子技能结果为完全成功；如果结果失败或部分成功，则停止队列
• 仅显示有可用子技能的功能；隐藏占位功能
• 功能菜单以多选形式呈现（仅当用户已指定某个特定功能时才使用单选）
• 每个功能行的 Status 列反映对话中实际跟踪的状态（Not done、In progress 或 Done），而非硬编码的默认值
• 每个功能行的 Description 均与 Salesforce Setup → Agentforce for IT Service 页面上的措辞一致（Fulfiller 和 Employee Agent 模板的描述必须逐字照录，不得改写）；三个 Stage 2 行均以简短的 Setup: 安装说明结尾；AskUserQuestion 选项说明使用相同文本
• Specialized Agents for Employee 行作为 Stage 2 项目，紧跟在 IT Service Employee Agent 之后显示；在先询问用户想要哪种专用模板前，绝不将 #4 委派给 service-itsm-agentic-setup-employee-agent-configure（如果未提供名称，子技能将默认使用通用 Agent，导致与 #3 重复）；该行还须包含 Setup: 安装说明
• Employee Agent escalation 行作为安装后的项目，显示在 Stage 2 Agent 之后；在 IT Service Employee Agent (#3) 处于 Active 状态前，绝不将 #5 委派给 service-agentforce-human-escalation-configure
• 对于完成摘要，标题行和结尾行须按照 examples/output-templates.md 中的规则选择（全部为 Done → Complete；存在任何 Not done / In progress → Finished）
• 仅当用户明确选择某项功能时才配置该功能（或者用户请求“all” / “everything”时，在逐项征得确认后按顺序引导用户完成）
• 在委派任何 Stage 2 Agent（Fulfiller、Employee 或 Specialized Agents for Employee）前，已确认 Studio 启用完成
• 如果有任何 Stage 2 Agent 已上线，则追加一次 Stage 3 运行时访问权限，并委派给 service-itsm-agentic-setup-agent-runtime-access-assign（否则跳过）
• 下一步操作是委派给子技能，绝不在此处直接配置功能
• 输出中不得出现 Salesforce 记录 ID，只能使用易读名称
• 面向用户的文字中不得仅用项目编号或范围来指代功能（#4、#1–#3）；须写出每项功能的完整名称；数字仅可用作菜单选择标识

---

参考文件索引

文件	阅读时机
examples/output-templates.md	行为步骤 3、5 和 6——功能菜单（两阶段、多选）、功能完成后的进度提示，以及完成摘要文本块
scripts/verify-child-verdict.mjs	行为步骤 5——通过 Bash（node）运行，以确定性方式检查子技能的结论，再继续处理队列