service-itsm-agentic-setup-configure

ITSM 设置协调器

用于在 Salesforce Service Cloud 中设置 IT 服务管理的顶层协调器。通过委派给专门的领域子协调器，引导用户完成可用的 ITSM 设置流程。

目标

向用户展示可用的 ITSM 设置流程，帮助他们了解各流程涵盖的内容，调用相应的子协调器，并跟踪整体进度，直到环境配置完成。

设置流程

菜单中仅显示具有可用子协调器的流程——使用 examples/output-templates.md 中的 Track menu 模板。

子协调器

#	流程	子协调器技能	功能
1	事件管理	service-itsm-agentic-setup-incident-management	SLA 和里程碑
2	ITSM 的 Agentforce	service-itsm-agentic-setup-agentforce-coordinate	启用 Agentforce Studio、Fulfiller Agent、Employee Agent
3	CMDB（配置管理数据库）	service-itsm-agentic-setup-cmdb-coordinate	启用 CMDB 功能、CMDB Foundation 套件、用户 CMDB 访问权限
4	渠道	service-itsm-channels-coordinate	员工服务渠道设置——门户、通知、Microsoft Teams（IT Desk / IT Service / 嵌入式 Agent）和 Slack
5	统一目录	service-catalog-template-coordinate	查找并部署统一目录服务流程模板（搜索 / 排序，然后安装 / 激活）

随着相应子协调器陆续可用，后续将在此处添加其他 ITSM 设置流程（例如员工配置）。

行为

1. 从对话中提取上下文

展示流程之前，先扫描聊天记录，了解：

• 用户是否已配置任何事件管理功能（标记为进行中或已完成）
• 是否已确认组织级事件管理总开关已开启
• 用户提及的任何偏好或限制条件（例如，“我们只需要优先级矩阵”“我们只想设置 CMDB”）
• 目标组织（如果有提及）
• 任何可缩小范围的特定功能

应根据对话记录中最近一次子协调器活动来确定各流程的状态，而不是依据上次显示的菜单——只有实际处理时间最近的流程才是“当前”活动流程。在较长或恢复的对话中（例如，稍后继续的无头会话），较早的对话记录仍可能突出显示之前的流程：不要将最后一个高亮行视为当前流程。如果无法确定哪个流程处于活动状态，应在呈现菜单前通过 AskUserQuestion 向用户重新确认，而不是沿用过时的高亮状态。

2. 将可用轨道显示为分页多选菜单

输出 examples/output-templates.md 中的 Track menu 表格（可视化地图 — 每个可用轨道和 Full guided setup）。在同一条回复中，发起多选 AskUserQuestion 的第一页。Full guided setup 是可直接选择的选项，与其他选项位于同一个多选菜单中 — 不是单独的模式选择器。用户在一个流程中选择任意组合的轨道。

每次调用 AskUserQuestion 最多接受 4 个选项。 目前有 5 个轨道 + Full guided setup，共 6 个选项，因此菜单需要分页。每页最多包含 3 个轨道（或第 1 页包含 Full guided setup + 2 个轨道）+ Show more tracks → 作为第 4 个选项（仅当后面还有内容时）。各页的选择会累积 — 用户在第 1 页的选择会在转到第 2 页时保留。如果用户提交某页时未选择 Show more tracks →，或已显示最后一页（最后一页不需要 Show more tracks → 标记），则停止分页。在委派之前，从最终累积的选择中移除 Show more tracks →。

选择解析。 如果累积的选择中包含 Full guided setup，则按依赖顺序运行所有可用轨道（仍需按步骤 3 对每个轨道进行确认 — 用户可在任意两个轨道之间停止）。否则，仅按依赖顺序（若未指定，则按轨道编号顺序）运行选中的轨道。

此层级不要运行任何组织级前置条件 — 每个子编排器负责自己的前置条件（例如，Incident Management 子编排器会在内部处理主开关确认）。未经预先检查便直接委派，可使此编排器不必了解特定领域的依赖关系，也能避免提示用户更改其未选择轨道的组织状态。

3. 按顺序委派给选定的子编排器

按照用户列出的顺序依次处理选择项（如果用户未指定顺序，则按轨道编号顺序处理）。对于每个轨道，调用对应的子编排器；该技能负责自己的内部菜单、前置条件和功能选择。子编排器返回后，更新已跟踪的状态并转到下一个选定的轨道。不要在选定轨道之间重新显示完整的轨道菜单 — 用户已在步骤 2 中确认了这些选择。

4. 每个子编排器完成后

用户从子编排器返回时：

1. 更新轨道状态 — 将其标记为“Done”
2. 转到下一个选定的轨道（如果还有）

5. 完成已选轨道后，提供其他轨道选项

用户选择的最后一个轨道完成后，询问用户是否要配置剩余轨道。如果是，则仅使用剩余轨道再次执行步骤 2。如果否，则转到步骤 6。

6. 完成摘要

用户表示已完成（或所有可用轨道都已标记为 Done）时，输出 examples/output-templates.md 中的 Completion summary 模板。

---

规则

• 设置标题中始终显示“(via service-itsm-agentic-setup-configure)”
• 始终将轨道菜单呈现为分页多选——每页只使用一个 AskUserQuestion，并设置 multiSelect: true。Full guided setup 是多选中的一等选项（第 1 页，第 1 项）——绝不能将其拆分为单独的模式选择阶段。单个 AskUserQuestion 中绝不能呈现超过 4 个选项——工具架构将 options 的上限设为 4，超出时会在用户看到菜单前因“invalid parameter”错误而失败
• 当选项总数（轨道 + Full guided setup）超过 4 个时，分页显示菜单。该算法可扩展至任意规模——轨道越多，自动生成的页面就越多，结构保持不变：第 1 页 = Full guided setup + 最多 2 个轨道 + Show more tracks →（4 个选项）；每个中间页 = 最多 3 个轨道 + Show more tracks →（4 个选项），按需重复，直到剩余轨道数 ≤ 4；最后一页 = 剩余的 ≤ 4 个轨道，不带哨兵项。具体页数：4 个轨道 → 2 页，7 个轨道 → 3 页，10 个轨道 → 4 页（每增加约 3 个轨道，页数就增加 1 页）。跨页累积所选项——用户在第 1 页的选择在翻页后仍保持选中。委派前，从最终累积的选择中移除 Show more tracks →
• 始终在同一条回复中同时输出 ASCII 表格和第 1 页的 AskUserQuestion——表格是可视化总览（包括所有轨道和 Full guided setup）；多选菜单是选择渠道。只输出表格会破坏选择渠道；只输出多选菜单则会隐藏可视化总览
• 当累积的选择中包含 Full guided setup 时，按依赖顺序展开为所有可用轨道（第 3 步仍会逐轨道确认，以便用户可在任意两个轨道之间停止）。否则，只运行用户选中的轨道。如果用户同时选择了 Full guided setup 和个别轨道，表示“全部运行”——按完整引导设置处理，并忽略个别轨道的选择
• 绝不能在此层级运行领域级前置条件（例如 Incident Management 主开关）——每个子编排器负责自身的前置条件，因此未选择相关轨道的用户不会被要求进行无关的组织级更改
• 绝不能显示没有可正常工作的子编排器的轨道
• 绝不能直接配置功能——始终委派给子编排器（通过领域编排器进行委派，可确保应用其菜单、进度跟踪和逐功能确认；直接配置会绕过这些状态，导致设置不一致）
• 在整个对话中跟踪轨道进度——根据对话记录中子编排器的最新活动重新判断每个轨道的状态，而不是沿用之前显示的高亮状态。对于恢复的对话或较长的对话，不要假设最后高亮的轨道仍是当前轨道；如果状态不明确，在呈现菜单前先向用户确认当前轨道
• 任何输出中都不得显示 Salesforce 记录 ID——只使用易读名称
• 如果用户直接询问特定功能（例如“设置优先级矩阵”“只启用 CMDB”），可以跳过 Behavior 第 2 步的轨道菜单，直接委派给相应的子编排器；子编排器会按需处理自身的前置条件
• 如果用户要求设置的区域尚不可用（例如员工配置、重大事件管理），告知他们该功能目前尚未在此编排器中提供，并将在相应子编排器合并后添加

---

验证清单

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

• 标题行以 (via service-itsm-agentic-setup-configure) 结尾
• 仅显示具有可正常运行的子编排器的跟踪；隐藏占位跟踪
• 跟踪菜单以单阶段分页多选的形式输出 — Full guided setup 是多选中的一级选项（第 1 页的第一个选项），而不是单独的模式选择阶段
• ASCII 表格和第 1 页的 AskUserQuestion 在同一条回复中输出 — 不能只输出其中一个
• 当选项总数（跟踪 + Full guided setup）> 4 时，页面遵循以下结构：第 1 页 = Full guided setup + 最多 2 个跟踪 + Show more tracks →；中间页 = 最多 3 个跟踪 + Show more tracks →；最后一页 = 剩余的 ≤ 4 个跟踪，不含哨兵项。跨页累积所选项，并从最终选择中移除 Show more tracks →
• 如果累积的选择中包含 Full guided setup，则按依赖顺序将所有可用跟踪加入队列，并在每个跟踪之间进行确认（如果包含 Full guided setup，则忽略单个跟踪的选择）
• 每个跟踪行的 Status 列反映对话中实际跟踪的状态（Not done、In progress 或 Done），而不是硬编码的默认值
• 对于完成摘要，标题行和结束行根据 examples/output-templates.md 中的规则选择（全部为 Done → Complete；有任何 Not done/In progress → Finished）
• 此层级不运行任何组织级前置条件 — 所选的子编排器会自行处理前置条件
• 下一步操作委派给子编排器，绝不能直接委派给功能子技能
• 输出中不出现 Salesforce 记录 ID — 仅使用易于识别的名称

---

参考文件索引

文件	阅读时机
examples/output-templates.md	行为步骤 2 和 6 — 跟踪菜单（多选）和完成摘要文本块