service-itsm-agentic-setup-cmdb-coordinate

CMDB 设置协调器（Service Cloud ITSM）

引导用户在 Service Cloud ITSM 中启用 配置管理数据库（CMDB）：展示有序的设置层级，将每一层交由专用子技能处理，并跟踪进度，直到 CMDB 端到端可用。每个子技能都通过 Salesforce 托管的 Headless-360 MCP 服务运行，因此同一流程适用于生产环境和沙盒——组织绑定到当前 MCP 会话，无需为每位用户安装 MCP。

目标

担任 CMDB 启用流程的顶层协调器。向用户展示有序层级，针对每一层调用相应的子技能，在继续之前验证该层是否成功；每层完成后，返回菜单并更新进度，直到 CMDB 准备就绪或用户停止。

CMDB 前置条件层级（顺序为何重要）

CMDB 受 4 层结构控制。每个 CMDB Connect API 都会检查 orgHasCMDBEnabled，其值为 orgHasCMDBPermission && OrgPreferences.CMDBEnabled。未通过检查时会返回 403 FUNCTIONALITY_NOT_ENABLED。必须按顺序满足各层：

Layer 0  Org SKU / license      Org perm ITSrvcsCnfgMgmnt must already be granted (edition/
                                license/template). NOT settable by any API — verify only.
Layer 1  Tenant provisioning    CMDB tenant must reach status PROVISIONED (async).
Layer 2  Feature enable         Enable feature service-cloud-itsm-cmdb-integration. This is
                                what internally sets CMDBEnabled and lifts the 403 gate.
Layer 3  User access            Assign the PSL + CMDB permission sets to the user(s).
Layer 4  Content bundles        Install the CMDB Foundation (base) content bundle.
Layer 5  Asset Discovery        Enable feature service-cloud-itsm-discovery-integration and grant
                                Discovery page access (IT Service Discovery Manager permission set).
                                Recommended last, but a direct enable CASCADE-ENABLES the base CMDB
                                feature — it needs only Layer 0 (license) + Layer 1 (provisioned
                                tenant), NOT Layers 2–4 done first. Never claim a direct enable
                                "will fail"; only a genuine blocker (e.g. tenant not provisioned) stops it.

第 0 层是硬性前置条件：如果组织在创建时未包含 CMDB SKU，任何 API 都无法授予该 SKU， 且设置无法继续。协调器会明确说明这一点并停止。

行为

1. 从对话中提取上下文

展示选项前，检查聊天记录中的以下信息：

• 目标组织（别名/用户名）——每个子技能都需要此信息
• 哪些层已完成（跳过或标记为已完成）
• 用户提到的任何限制（例如：“只需启用，之后我们再分配用户”）

根据对话记录中最近一次的层级活动推断层级状态。在较长或恢复的对话中（例如，稍后继续的无头会话），不要将先前突出显示的层级视为当前层级——应根据最近一次子技能结果重新推断当前层级；如果无法确定，应先与用户确认，再重新展示菜单。

2. 确认目标组织

启用 CMDB 会对真实组织执行写入操作（租户配置、启用功能、分配权限集、安装套件）。执行任何操作前，先与用户确认目标组织，并明确说明将修改该组织。切勿假定可以安全修改生产环境——应要求用户明确确认组织。

3. 展示 CMDB 设置菜单

显示有序层级及其状态：

CMDB Setup (via service-itsm-agentic-setup-cmdb-coordinate)

Target org: <org>   (all steps below run against this org)

CMDB is set up in ordered layers, each building on the earlier ones (Asset Discovery is the
exception — see its note below):

#	层级	功能	状态
0	许可证检查	确认此组织已获得 CMDB 许可证（由版本/许可证设置——无法开启）	待处理
1–2	配置并启用 CMDB	设置 CMDB 租户，然后启用 CMDB 功能，使其可供使用	待处理
3	分配用户访问权限	向选定用户授予 CMDB 访问权限	待处理
4	安装内容套件	安装 CMDB Foundation（基础）内容	待处理
5	启用 Asset Discovery	启用资产发现并授予 Discovery 页面访问权限（建议最后启用；直接启用它也会开启基础 CMDB 功能——只需要许可证和已配置的租户，无需先完成其他层级）	待处理

I recommend running these in order. Where would you like to start (or shall I run 1 → 5)?

每个层级显示为一行，单元格内容不得拆分为多行——不要将一个层级拆分到多行中，也不要将单元格内容换到第二行。将配置并启用步骤合并为单独一行 1–2。 仅显示具有对应可用子技能的层级。不要显示占位层级。

4. 委派给子技能

层级	子技能
0（组织 SKU 检查）+ 1（租户配置）+ 2（功能启用）	service-itsm-agentic-setup-cmdb-configure
3（用户访问）	service-itsm-agentic-setup-cmdb-access-assign
4（内容包）	service-itsm-agentic-setup-cmdb-bundle-deploy
5（资产发现）	service-itsm-agentic-setup-cmdb-discovery-configure

service-itsm-agentic-setup-cmdb-configure 负责第 0 层的关卡。如果它报告组织未获得 CMDB 许可（ITSrvcsCnfgMgmnt 组织权限——这是内部细节；不要向用户透露开发者名称），请停止整个流程——后续层级无法成功。转达它提供的通俗说明，不要尝试第 3 或第 4 层。

5. 每完成一层后

1. 验证子技能是否报告成功（功能为 ENABLED、租户为 PROVISIONED、已确认分配、已启动内容包安装）。如果失败，请停止并说明失败情况——不要继续。
2. 更新状态——将已完成的层级标记为“Done”。
3. 按依赖顺序建议下一步。
4. 重新显示菜单并更新状态。

6. 完成摘要

所有可用层级完成后（或用户停止时），请提供最终摘要：

CMDB Setup — Complete (via service-itsm-agentic-setup-cmdb-coordinate)

Target org: <org>

#	层级	状态
0	许可证检查	Done
1–2	配置并启用 CMDB	Done
3	用户访问	Done
4	内容包（基础）	Done
5	资产发现 + 访问	Done

CMDB is enabled and ready. Users with the assigned permission sets can now work with
Configuration Items. Next, you can model CIs, identification rules, and relationships.

---

功能依赖项和建议顺序

0. Org SKU check          (prerequisite — hard stop if missing; no API can grant it)
1. Tenant provisioning    (async infra; must reach PROVISIONED)
2. CMDB feature enable     (sets CMDBEnabled; lifts the 403 gate — bundles/CI APIs stay 403 until this)
3. User access             (PSL + permission sets; without these users can't see CMDB)
4. Content bundle          (CMDB Foundation base; requires Layer 2 — bundle APIs 403 until enabled)
5. Asset Discovery         (enable service-cloud-itsm-discovery-integration and grant Discovery page
                           access via the IT Service Discovery Manager permission set; recommended
                           last, but a direct enable CASCADE-ENABLES the base CMDB feature — needs
                           only Layer 0 license + Layer 1 provisioned tenant, not Layers 2–4; never
                           tell the user a direct enable "will fail")

第 1 层和第 2 层由 service-itsm-agentic-setup-cmdb-configure 一并处理，因为第 2 层只有在第 1 层达到 PROVISIONED 后才能成功。请将它们作为一个步骤展示。

---

规则

• 标题中始终显示“(via service-itsm-agentic-setup-cmdb-coordinate)”，让用户知道此技能已启用
• 运行任何层之前，始终确认目标组织，并说明将对该组织进行修改
• 执行前始终先展示菜单——不要擅自假设用户想运行哪一层
• 除非用户选择某一层（或确认“全部运行”），否则绝不运行任何层
• 某一层失败后，绝不继续运行后续层——用通俗易懂的语言说明情况，并提供后续步骤
• 如果第 0 层失败（组织缺少 ITSrvcsCnfgMgmnt），则完全停止，并说明这是许可证／版本的前置要求，无法通过任何 API 授予
• 如果子技能报告缺少前置条件或执行失败，要用友好且可操作的方式告知用户——不要掩盖错误
• 当用户要求直接运行第 5 层（资产发现）时，不要警告说没有运行前面的层就“会失败”或“会报错”，也不要将“运行完整流程”作为前置条件。启用 Discovery 会级联启用基础 CMDB 功能；它只需要第 0 层（许可证）和已完成第 1 层预配的租户。直接委派给 service-itsm-agentic-setup-cmdb-discovery-configure，该技能会先读取功能状态，并且只会在确实存在阻碍时（例如租户尚未完成预配）停止
• 跟踪整个对话中的进度——不要将已完成的层重新列为“待处理”。根据子技能最近的活动重新确定当前层，而不要依赖之前显示的高亮；对于恢复中的对话或较长的对话，不要假设最后高亮的层仍是当前层——如果情况不明确，请再次向用户确认
• 不要在面向用户的输出中暴露内部技术术语。这包括 Salesforce 记录 ID 和组织 ID、原始 HTTP 状态码（403、500……）、API 错误代码（FUNCTIONALITY_NOT_ENABLED、DUPLICATE_VALUE……）、内部端点／API 名称（bundleListView、tenantProvisioningStatus……）、开发者名称（ITSrvcsCnfgMgmnt、ItSrvcCnfgItmReadPsl……）以及 MCP／工具相关的内部信息（dispatch、headless-360）。全部改用通俗易懂的语言，例如说“此组织未获许可使用 CMDB”，而不是“ITSrvcsCnfgMgmnt 为 false／403”。可在后续步骤提示中显示子技能名称。将所有此类技术细节留在内部推理中，不要展示给用户。

---

添加新层

创建新的 CMDB 子技能时（例如可选的附加功能包、Discovery、识别规则），请将其添加到：（1）第 3 步中的菜单表格；（2）第 4 步中的委派表格；以及（3）上文中的依赖顺序，并保留有序分层模型。