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 ／組み込みエージェント）、Slack
5	統合カタログ	service-catalog-template-coordinate	Unified Catalog Service Process テンプレートの検索とデプロイ（検索／順位付け後、インストール／有効化）

従業員のプロビジョニングなど、その他の ITSM セットアップトラックは、サブオーケストレーターの準備が整い次第、ここに追加されます。

動作

1. 会話からコンテキストを抽出する

トラックを提示する前に、チャット履歴を確認して、次の情報を把握してください。

• ユーザーがインシデント管理機能をすでに設定しているかどうか（進行中または完了として表示）
• 組織レベルのインシデント管理マスタースイッチがオンであることをすでに確認済みかどうか
• 言及された希望や制約（例：「優先度マトリックスだけ必要です」「CMDB だけを希望します」）
• 対象の組織（言及されている場合）
• 対象範囲を絞り込む、具体的な機能についての言及

各トラックのステータスは、最後に表示されたメニューではなく、トランスクリプト内の最新のサブオーケストレーターのアクティビティから判断してください。実際に作業中の最新トラックだけを「アクティブ」とします。長時間にわたる会話や、後から再開された会話（例：後日続行されたヘッドレスセッション）では、以前のトラックがトランスクリプト内で目立って表示されたままの場合があります。最後に強調表示された行を現在のトラックとみなさないでください。どのトラックがアクティブか曖昧な場合は、古いハイライトをそのまま引き継いでメニューを表示するのではなく、表示前にユーザーに再確認してください（AskUserQuestion）。

2. 利用可能なトラックをページ分けされた複数選択として提示する

examples/output-templates.md にあるトラックメニューの表（利用可能なすべてのトラックと Full guided setup のビジュアルマップ）を出力します。同じ応答内で、複数選択の AskUserQuestion の1ページ目を表示します。Full guided setup は、別個のモード選択ではなく、複数選択で選べる独立した選択肢です。ユーザーは1つのフローで任意の組み合わせのトラックを選択します。

AskUserQuestion で指定できる選択肢は、呼び出しごとに最大4つです。 現在はトラックが5つ、Full guided setup を加えると選択肢は6つになるため、メニューはページ分けします。後続の内容がある場合、各ページには最大で3つのトラック（1ページ目は Full guided setup と2つのトラック）に加え、4つ目の選択肢として Show more tracks → を表示します。選択内容はページをまたいで蓄積されます。1ページ目で選んだ項目は、ユーザーが2ページ目に進んでも選択済みのままです。ユーザーが Show more tracks → を選ばずにページを送信した場合、または最後のページを表示した場合は、ページ分けを終了します（最後のページでは Show more tracks → は不要です）。委任する前に、最終的に蓄積された選択内容から Show more tracks → を取り除きます。

選択内容の解決。 蓄積された選択に Full guided setup が含まれる場合は、利用可能なすべてのトラックを依存関係の順に実行します（手順3のトラックごとの確認は引き続き適用され、ユーザーは任意の2つのトラックの間で停止できます）。それ以外の場合は、選択されたトラックのみを依存関係の順（順序が指定されていない場合はトラック番号順）に実行します。

このレベルでは、組織レベルの前提条件を実行しないでください。前提条件は各サブオーケストレーターが独自に処理します（例：インシデント管理のサブオーケストレーターは、マスタースイッチの確認を内部で行います）。事前確認なしで委任することで、このオーケストレーターがドメイン固有の依存関係に左右されるのを避け、ユーザーが選択していないトラックのために組織の状態を変更するよう求めることも防げます。

3. 選択されたサブオーケストレーターに順番に委任する

選択内容は、ユーザーが指定した順序（順序が示されていない場合はトラック番号順）で順次処理します。各トラックについて、対応するサブオーケストレーターを呼び出します。そのスキルが独自の内部メニュー、前提条件、機能選択を処理します。処理が戻ったら、追跡中のステータスを更新し、次に選択されたトラックへ進みます。手順2でユーザーは選択内容をすでに確定しているため、選択されたトラックの間にトラックメニュー全体を再提示しないでください。

4. 各サブオーケストレーターの完了後

ユーザーがサブオーケストレーターから戻ったら、次の処理を行います。

1. トラックのステータスを更新する — ステータスを「完了」にします
2. 次に選択されたトラックに進む — 残っている場合

5. 選択されたトラックの処理後に、追加のトラックを提示する

ユーザーが選択した最後のトラックの処理が完了したら、残りのトラックも設定するかどうかを尋ねます。「はい」の場合は、残りのトラックのみを対象に手順2を再度実行します。「いいえ」の場合は手順6に進みます。

6. 完了の概要

ユーザーが終了したと伝えた場合（または利用可能なすべてのトラックが「完了」になった場合）は、examples/output-templates.md にある完了の概要テンプレートを提示します。

---

ルール

• セットアップヘッダーには必ず「(via service-itsm-agentic-setup-configure)」を表示してください
• トラックメニューは必ずページ分割された複数選択として表示してください。各ページにつき multiSelect: true を指定した AskUserQuestion を1つだけ使用します。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のトラックごとの確認は引き続き行い、ユーザーが任意の2つのトラックの間で停止できるようにします）。それ以外の場合は、選択されたトラックだけを実行してください。Full guided setup と個別のトラックが一緒に選択された場合は、「すべて実行」を意味します。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 が1つでもある場合は Finished）
• このレベルでは組織レベルの前提条件を実行していない — 選択したサブオーケストレーターが独自の前提条件を処理する
• 次のアクションではサブオーケストレーターに委任し、機能の子スキルには直接委任していない
• 出力に Salesforce レコード ID を含めず、人が読める名前のみを使用している

---

参照ファイル一覧

ファイル	読み込むタイミング
examples/output-templates.md	動作手順2および6 — トラックメニュー（複数選択）と完了概要のテキストブロック