アクションフィールドとウィジェットフィールド action-widget-configuration
このページを使用して、アクションエディターでフィールドを検索します。 作成手順については、最初からアクションを作成するを参照してください。
設定を見つける
新しいアクションを作成 ダイアログには、アクションと ウィジェットメタデータ のタブがあります。
作成後、保存済みアクションエディターは3つのタブを使用します。
編集を保存するには、変更を保存を選択します。 生成されたアクションは、レビュー待ちのため、レビュー済みとしてマークされます。これは、生成されたプルリクエストも処理します。
アクションパラメーター
入力パラメーターは、LLM プラットフォームがアクションハンドラーに送信する値です。 モデルはユーザーのメッセージから値を抽出し、設定されたパラメーターにマッピングします。
category、query）String、Number、IntegerまたはBooleanファイルパラメーター
ファイルパラメーターは、アクションエディターで設定された入力フィールド名です。 ユーザーがファイルをアップロードすると、ホストはそれらの引数（通常はdownload_urlとfile_idを含む）のファイルオブジェクトを提供します。
メタデータフィールド
基本情報
作成ダイアログには、アクション名から派生した不変の コード識別子 がプレビューされます。 これはアプリ内で一意であり、小文字で始まり、小文字、数字、ハイフン、またはアンダースコアを使用して、最大63文字が含まれます。 アクションをハンドラーリポジトリのactions/<code-identifier>/index.jsにマッピングします。
注釈
アクションの動作を説明するオプションのヒント：
OpenAI メタデータ
_meta["openai/widgetDescription"]にマップします。モデルのレンダリング済みコンポーネントを要約し、繰り返しナレーションを減らしますアクションの説明は、モデルがアクションを選択するタイミングを制御します。 ウィジェットの説明では、コンポーネントがレンダリング後に表示される内容を説明します。
視認性
アクションのオンとオフを切り替えるには、アプリページで表示 スイッチを使用します。 スイッチは、次のデプロイメントにアクションを含めるかどうかを制御します。 アクションエディターには個別のオン/オフスイッチはありません。
次のアクションエディター設定は、アプリレベルのオン/オフ状態ではなく、モデルとウィジェットの露出を制御します。
モデルとウィジェットの露出の設定は、ウィジェットタイプの選択に代わるものではありません。
Analytics
ウィジェットフィールド
ウィジェット情報
テンプレート URL
scripts/aem-embed.js エントリポイントのHTTPS URL。 同じEDS プロジェクト内のアクション間で共有CSP設定
コンテンツセキュリティポリシーは、ウィジェットのiframeが接続できる外部ドメインを制御します。 すべての外部ドメインを明示的に許可リストに加えるする必要があります。
fetch、XHRまたはWebSocketを介して連絡できるドメインopenExternal個のリダイレクトリンク （ChatGPT固有）の信頼されたターゲットbase-uri CSP ディレクティブ （MCP Apps SDKのみ、ChatGPTではありません）権限
ウィジェット権限は、ハードウェアおよびブラウザーAPIへのアクセスを管理します。 権限は、iframe権限ポリシーにマッピングされます。
作成ダイアログの 権限（MCP固有） の下に権限コントロールが表示されます。 ウィジェットに必要な機能のみを付与します。ホストサポートとユーザーの同意も適用されます。