service-itsm-agentic-setup-cmdb-coordinate

CMDB セットアップオーケストレーター（Service Cloud ITSM）

順序付けられたセットアップレイヤーを提示し、それぞれを専門の子スキルに委任して進捗を追跡しながら、CMDB がエンドツーエンドで使用可能になるまで、Service Cloud ITSM で Configuration Management Database（CMDB） を有効にする手順をユーザーに案内します。各子スキルは Salesforce-hosted Headless-360 MCP server を通じて実行されるため、同じフローを 本番環境 とサンドボックスの両方で利用できます。組織は現在の 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 でも付与できず、セットアップを続行できません。オーケストレーターはこのことを明確に伝えて停止します。

動作

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 行目に折り返したりしないでください。プロビジョニングと有効化を組み合わせたステップは、1–2 の 1 行として表示してください。対応する、動作する子スキルがあるレイヤーのみを表示してください。プレースホルダーのレイヤーは表示しないでください。

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. ステータスを更新 — 完了したレイヤーを「完了」とします。
3. 次のステップを提案 — 依存関係の順序に従って提案します。
4. メニューを再表示 — ステータスを更新したメニューを表示します。

6. 完了の概要

利用可能なすべてのレイヤーが完了したとき（またはユーザーが停止したとき）、最終的な概要を提示します。

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

Target org: <org>

#	レイヤー	ステータス
0	ライセンス確認	完了
1–2	CMDB のプロビジョニングと有効化	完了
3	ユーザーアクセス	完了
4	コンテンツバンドル（基本）	完了
5	アセット検出＋アクセス	完了

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 は、レイヤー 1 が PROVISIONED になるまでレイヤー 2 が成功しないため、service-itsm-agentic-setup-cmdb-configure がまとめて処理します。1 つのステップとして提示してください。

---

ルール

• スキルが有効であることをユーザーに知らせるため、ヘッダーに必ず「(via service-itsm-agentic-setup-cmdb-coordinate)」を表示します
• いずれかのレイヤーを実行する前に、必ず対象の組織を確認し、その組織が変更されることを伝えます
• 操作を行う前に、必ずメニューを提示します。ユーザーが希望するレイヤーを推測してはいけません
• ユーザーがレイヤーを選択するか、「すべて実行」と確認するまで、レイヤーを実行してはいけません
• レイヤーが失敗した場合、次のレイヤーに進んではいけません。停止して、平易な言葉で説明し、次の手順を案内します
• レイヤー 0 が失敗した場合（組織に ITSrvcsCnfgMgmnt がない場合）、処理をすべて停止し、これはライセンス／エディションの前提条件であり、API では付与できないことを説明します
• 子スキルが前提条件の不足や失敗を報告した場合、親しみやすく、次の行動につながる形でユーザーに伝えます。エラーを隠してはいけません
• ユーザーが レイヤー 5（アセットディスカバリー）を直接実行するよう求めた場合、前のレイヤーを実行していないと「失敗する」または「エラーになる」と警告してはいけません。また、前提条件として「フロー全体の実行」を強要してはいけません。ディスカバリーを有効にすると、基本 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 子スキル（任意のアドオンバンドル、ディスカバリー、識別ルールなど）が作成された場合は、それらを次の箇所に追加します。（1）ステップ 3 のメニューテーブル、（2）ステップ 4 の委任テーブル、（3）上記の依存関係の順序。順序付きレイヤーモデルを維持してください。