リファレンスマテリアル reference-material

IMPORTANT
Adobe LLM Appsは現在Betaにいます。
ここに示す機能、ワークフロー、UIは、必ずしも製品の最終状態を表すものではありません。 Betaに参加するには、llm-apps-beta@adobe.comに電子メールを送信します。

このセクションでは、Adobe LLM Apps UIのアクション設定に関するフィールドレベルの参照を提供します。

アクションパラメーター

入力パラメーターは、LLM プラットフォーム (ChatGPT, Claude)がアクションハンドラーに送信する値です。 モデルはユーザーのメッセージからそれらを抽出し、これらのフィールドに自動的にマッピングします。

プロパティ
説明
名前
パラメーター識別子(例:categoryquery
タイプ
StringNumberIntegerまたはBoolean
説明
人が判読可能な説明:LLM プラットフォームは、これを使用して適切な価値を抽出します
必須
オンにした場合、モデルはアクションを呼び出す前にこのパラメーターを指定する必要があります

ファイルパラメーター

ファイルパラメーターは、download_urlおよびfile_id個のプロパティを持つファイルオブジェクトを保持します。 ユーザーが会話でファイルをアップロードしたときにファイルデータを受け取る入力フィールド名を定義します。

メタデータフィールド

基本情報

フィールド
必須
説明
アクション名
はい
アクションの識別子(例:製品を検索
説明
はい
アクションの内容の説明:LLM プラットフォームは、アクションを呼び出すタイミングを決定するためにこれを使用します

注釈

アクションの動作を説明するオプションのヒント:

注釈
説明
破壊的なヒント
アクションは、データを変更または削除します
Idempotent
同じ引数でアクションを複数回呼び出すと、同じ結果になります
オープンワールドのヒント
アクションは外部システムと相互作用します
読み取り専用のヒント
アクションはデータを読み取るだけで、書き込みはありません

OpenAI メタデータ

フィールド
最大長
説明
ステータス テキストの呼び出し
64文字
アクションの実行中にLLM プラットフォームに表示されるメッセージ (例:製品の読み込み…
呼び出された状態のテキスト
64文字
アクションが完了した後に表示されるメッセージ (例:製品が読み込まれました…

視認性

切り替え
説明
AI モデルに公開
アクションは、会話中にAI モデルによって呼び出すことができます
アプリサーフェスでウィジェットとして表示
アクションは、アプリ内のビジュアルウィジェットをレンダリングします

ウィジェット情報

フィールド
説明
タイプ
ウィジェット技術 – 現在​EDS
ウィジェットドメイン(サンドボックスオリジン)
ウィジェットがホストされるオリジン。アプリごとに一意である必要があります
境界線を好む
オンにすると、ウィジェットはLLM プラットフォームの枠付きカード内でレンダリングされます

テンプレート URL

フィールド
説明
スクリプト URL
エントリ ポイント スクリプト — https://main--<repo>--<owner>.aem.live/scripts/aem-embed.js。 すべてのアクションで共有
ウィジェット埋め込みURL
このアクションのEDS ページ — https://main--<repo>--<owner>.aem.live/eds-widgets/<action-name>。 アクションごとに一意

CSP設定

コンテンツセキュリティポリシーは、ウィジェットのiframeが接続できる外部ドメインを制御します。 すべての外部ドメインを明示的に許可リストに加えるする必要があります。

ディレクティブ
説明
リソースドメイン
静的アセットのドメイン – 画像、フォント、スクリプト、スタイル
ドメインの接続
ウィジェットがfetchXHRまたはWebSocketを介して連絡できるドメイン
フレームドメイン
ネストされたiframeではオリジンが許可され、トリガーではアプリのレビューがより厳しくなります。
リダイレクトドメイン
openExternal個のリダイレクトリンク (ChatGPT固有)の信頼されたターゲット
ベース URI ドメイン
base-uri CSP ディレクティブ (MCP Apps SDKのみ、ChatGPTではありません)

権限

ウィジェットがアクセスできるハードウェアおよびブラウザーAPI。 これらはiframe権限ポリシーにマッピングされます。

権限
説明
カメラ
デバイスカメラへのアクセス
マイク
デバイスのマイクにアクセス
位置情報
ユーザーの場所へのアクセス
クリップボード
クリップボードの読み取りまたは書き込み
recommendation-more-help
llm-apps-help-main-toc