基盤の設定 create-first-app

インフラストラクチャは、アプリの技術的な基盤です。コードを保存するリポジトリと、アクションハンドラーを実行し、ウィジェットをユーザーに配信するサービスです。

概要で説明しているように、アクションハンドラー​は製品の検索などのタスクを実行し、ウィジェット​は会話のインタラクティブなエクスペリエンスとして結果を表示します。

LLM Appsは、ハンドラーとウィジェットのソースコードを2つの別々のGitHub リポジトリに保存します。

たとえば、商品検索ハンドラーは一致する商品を取得し、そのウィジェットにはそれらを商品カードとして表示します。 リポジトリはそのコードを保存し、Adobe I/O Runtimeはデプロイされたハンドラーを実行し、Edge Delivery Servicesはウィジェットを提供します。

セットアップウィザードはこれらのリポジトリを準備し、アプリに必要なサービスを接続します。 Adobe Managed Infrastructure​から始めることをお勧めします。最も早く始める方法です。 Adobeは、アクションハンドラーとウィジェットのリポジトリを作成およびホストします。 自分でリポジトリを設定する必要はありません。

または、自分のアカウントまたは組織に2つの空のGitHub リポジトリを指定します。 プラットフォームは、必要なプロジェクトファイルでそれらを初期化します。アクションやウィジェットコードを事前に準備する必要はありません。

このガイドでは、 インフラストラクチャ オプションを選択し、セットアップ ウィザードを使用してアプリを作成する方法を説明します。 セットアップ後、​ アクションの作成に進みます。

アプリを作成すると、not​がアクションの生成を開始します。 アプリページとは別にアクションの生成を開始します。

アプリ作成ウィザードを開く

Adobe LLM アプリ ​を開きます。 ようこそページから、開始​を選択します。 既にアプリを開いている場合は、アプリセレクターを使用して、新しいアプリを作成​を選択します。

LLM アプリの作成 ウィザードは、開始​から始まります。 テクノロジー環境の設定方法を選択します。

どちらのオプションも、後で自動アクション生成をサポートします。 どちらのオプションも、アクションを手動で記述する必要はありません。

Adobeのマネージドインフラストラクチャの使用 adobe-managed-infrastructure

このオプションを使用すると、Adobeでアプリのリポジトリと接続サービスを設定および管理できます。 リポジトリを作成したり、GitHub アプリを自分でインストールしたりする必要はありません。

アプリページには​ アプリの設定 ​が表示され、Adobeはリポジトリを準備し、ウィジェットサイトに接続します。 UIは、設定には通常1～2分かかることを示します。アクション、テスト、デプロイメントは、設定の準備ができるまで利用できません。

設定が失敗した場合は、エラーを読み取り、再試行​を選択します。 ページで進行状況を確認できない場合は、バックグラウンドで設定を続行します。再接続するには、もう一度チェック​を選択します。

セットアップが完了したら、​ アクションの作成を続行します。

独自のリポジトリを接続 your-own-repositories

「自分で設定します」を選択し、「次の手順」を選択します。 このパスには、次の4つのウィザード手順があります。

アプリの詳細→ついて、アクション インフラストラクチャの設定→ウィジェット インフラストラクチャ→設定を開始します。

選択したリポジトリへのアクセスと、必要なGitHub アプリのインストールまたは設定の権限が必要です。 組織所有のリポジトリの場合、管理者はアクセスを承認する必要がある場合があります。

アクションハンドラー用とウィジェット用の2つの空のリポジトリを作成します。 README、ライセンス、または.gitignoreを使用して初期化しないでください。 ウィザードで各リポジトリを検証すると、プラットフォームによって必要なプロジェクト構造が追加されます。

互換性のあるアクションとEDS プロジェクトが既にある場合は、代わりにそれらを接続できますが、既存のコードは必要ありません。

アクションインフラの設定

アクションリポジトリには、LLM プラットフォームがアクションを呼び出したときに実行されるサーバーサイドのハンドラーとテストが含まれます。

組織またはリポジトリーが見つからない場合は、ピッカーで​ 別の組織を接続 ​または​ 別のリポジトリーを接続 ​してください。 GitHubのアクセス権を変更した後、組織とリポジトリを更新​を選択します。

ウィジェットインフラストラクチャの設定

ウィジェットとは、商品カードや予約フォームなどのアクションに添付される、オプションの視覚的な応答です。 ウィザードはEdge Delivery Services （EDS） リポジトリをホストに接続します。

検証でAEM Code Syncが検出されない場合は、AEM Code Syncが選択したウィジェットリポジトリにアクセスできること、およびサイト管理者として自分自身を追加したことを確認します。 次に、もう一度検証します。

アプリの詳細を入力 app-details

両方のインフラストラクチャ オプションは、アプリの詳細​で終わります。

利用できるAEM プログラムがない場合は、管理者にアクセス権を依頼します。 プログラムの読み込みに失敗した場合は、「プログラムの読み込みを再試行」を選択します。

ウィザードは、作成後にアプリページを開きます。 Adobe Managed Infrastructureでは、インフラストラクチャのセットアップが完了するのを待ってから続行します。

次のトピック：アクションの作成

アプリにインフラストラクチャが追加されましたが、まだ生成されたアクションはありません。 ​ アクションの作成を続行してweb サイトを分析するか、手動でのアクション作成を選択します。

アクションメタデータ、ハンドラー、ウィジェット、およびデプロイされたMCP サーバーの関係については、​ アプリケーションの接続方法を参照してください。