mcpField
P
platform-agenticsetup-categories-get

platform-agenticsetup-categories-get

github.com/forcedotcomエージェントワークフロー1.1k179 回インストール1 日前に更新
リポジトリ

platform-agenticsetup-categories-get について

接続済みの Salesforce 組織から Agentic Setup のプロンプトカテゴリを取得する Agent スキルです。必要に応じて入れ子のプロンプトも含め、読み取り専用の結果表示と一般的な API エラーへの対処を行います。

主な機能

  1. 01プロンプトカテゴリの取得
  2. 02入れ子のプロンプトを任意で取得
  3. 03カテゴリとプロンプトの解析・表示
  4. 04機能設定や認証エラーへの対処

活用シーン

  1. 01組織内のプロンプトカテゴリの確認
  2. 02カテゴリ内プロンプトの一覧表示
  3. 03カテゴリ取得エラーの原因調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/forcedotcom/sf-skills --skill platform-agenticsetup-categories-get

インストール後、Claude Code で/platform-agenticsetup-categories-getを入力して読み込まれたか確認します。

同梱ファイルreferences/api-response-schema.md

詳細

platform-agenticsetup-categories-get

接続済みの Salesforce 組織で、Agentic Setup Categories Connect API からプロンプトカテゴリを取得します。

範囲

対象範囲：

  • SF CLI を使って GET /services/data/{apiVersion}/agenticsetup/categories を呼び出す
  • ネストされたプロンプトを含めるために fetchPrompts クエリパラメーターを渡す
  • JSON レスポンス（カテゴリ、ラベル、プロンプト）を解析して提示する
  • エラー（機能が無効な場合の 403、認証エラー）に対処する

対象範囲外 — 別の手段に委任：

  • プロンプトカテゴリの作成または変更 → この API ではサポートされていません（読み取り専用）
  • 組織の認証設定 → 別途 sf org login を使用してください
  • 権限セットの割り当て → assigning-permission-set

必須入力

エージェントには以下が必要です。

  • 接続済みの組織（すでに sf org login で認証済み）
  • 任意：ネストされたプロンプトを含めるかどうか（fetchPrompts=true）
  • 任意：対象の API バージョン（デフォルト：v67.0）。指定されたバージョンがある場合は、URL の v67.0 をそのバージョンに置き換えてください。

ワークフロー

1. 組織への接続を確認する
sf org display --json

組織が認証済みであることを確認し、インスタンス URL を取得します。デフォルトの組織が設定されていない場合は、--target-org で対象にする組織をユーザーに確認してください。

2. Categories API を呼び出す

基本の呼び出し（カテゴリのみ）：

sf api request rest /services/data/v67.0/agenticsetup/categories --method GET

ネストされたプロンプトを含める場合：

sf api request rest "/services/data/v67.0/agenticsetup/categories?fetchPrompts=true" --method GET
3. レスポンスを解析して提示する

API は categories 配列を含む JSON オブジェクトを返します。各カテゴリには name、label、prompts フィールドがあります。レスポンスの完全な構造と、fetchPrompts=true および fetchPrompts=false の両方の例については、references/api-response-schema.md を参照してください。

結果はわかりやすく提示してください。

  • カテゴリの名前とラベルを一覧表示する
  • fetchPrompts=true を使用した場合は、各カテゴリの下にネストされたプロンプトを表示する
  • prompts 配列が空のカテゴリがあれば、そのカテゴリにはプロンプトが存在しないことを示す
4. エラーに対処する
エラー意味対応
Success (exit 0)200 OK結果を解析して表示する
FUNCTIONALITY_NOT_ENABLEDこの組織またはユーザーで機能が有効になっていないAgentic Setup Categories 機能を有効にする必要があることをユーザーに伝え、Setup > Einstein/Agentforce を確認するよう案内する
INVALID_SESSION_IDセッションの有効期限が切れているsf org login で再認証する
NOT_FOUNDエンドポイントが見つからないAPI バージョンが古すぎるか、この組織に機能がデプロイされていない

ルール／制約

ルール理由
常に sf api request rest を使用する。curl や生の HTTP は使用しないcurl は ~/.sfdx のセッショントークンを経由せず、Authorization ヘッダーを手動で指定する必要があるため、壊れやすくなります
SOQL クエリは絶対に使用しないカテゴリは標準オブジェクトに含まれておらず、この Connect REST API からのみ取得できます
ファイル（LWC、Apex、XML）を絶対に生成しないこれはデータ取得タスクであり、コード生成タスクではありません
ユーザーが指定しない限り、デフォルトで v67.0 を使用するこのエンドポイントが導入された最小バージョンです
指示がない限り、fetchPrompts を渡さないペイロードサイズを抑えます。プロンプトは大きくなる場合があります
カテゴリはラベル順に並んでいるAPI がアルファベット順で返すため、並べ替えないでください
プロンプトはテキスト順に並んでいる各カテゴリ内で、プロンプトはアルファベット順に並びます

出力の要件

完了時には、以下を提示してください。

  1. 返されたカテゴリ数
  2. カテゴリ一覧 — 各カテゴリの名前とラベル
  3. プロンプト（要求された場合） — 該当するカテゴリの下に表示
  4. 発生したエラーと推奨される修正方法

参照ファイル一覧

ファイル参照するタイミング
references/api-response-schema.mdレスポンスの完全な構造とフィールドの説明を確認する必要がある場合

コメント

Markdown 対応