コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

Google ADK エージェントをインポートする — Gemini 上の 1 つのエージェント

Google の Agent Development Kit で構築されたアプリケーションの Agent Config — Gemini 上の 1 つのエージェントで、ADK に同梱の Google Search ツールを使います — を、aggrega import で Aggrega ファイルに下書きし、アプリケーションのイメージを回答ファイルで一度だけ指定して、Docker Compose 向けにビルドしたものです。

Google ADK エージェントをインポートする では、コマンド、それが尋ねる内容、それが書き出すファイルと各行がある理由、ビルド、そして実行中のエージェントまでを順を追って説明します。このフォルダーには、そのウォークスルーの各段階が収められています:

フォルダーまたはファイル内容
source/エージェントの設定 support_agent/root_agent.yaml、フォルダーをワークスペースにする .aggrega-config.yaml、そしてどの設定にも含まれない値を持つ support_agent/import-answers.yaml。その値とは、アプリケーションのイメージと、Kubernetes 向けのビルドが Gemini API キーを読み取る Kubernetes Secret の名前です
draft/aggrega import support_agent --target compose が書き出したファイル(変更なし、release.lock を含む)と、出力した内容:標準出力は stdout.txt、標準エラーは import.txt

設定はこの例のために書かれたものです。アプリケーションのコードと、ADK のスキャフォールドが書き出す環境ファイルはこの例に含まれません。インポートはどちらも読むことはなく、アプリケーションが動作するイメージは Release が指定します。

ドキュメントリポジトリのチェックアウトでは、check.sh がインポートを再実行し、書き出した内容と出力した内容を draft/ と比較し、ウォークスルーが引用するブロックをこれらのファイルと比較して、インポートが書き出したものを検証しビルドします。このリポジトリの隣に標準ライブラリのカタログ(入手先)がチェックアウトされているか、そのディレクトリが AGGREGA_CATALOG_DIRS に指定されている必要があります。

サンプルを生成する

この例のインポートは、以下のコマンドで実行することも、AI アシスタントに代わりに実行させることもできます。

例の名前を付けた新しいフォルダーに例を書き出します。

Terminal window
aggrega scaffold --example import-google-adk

その後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。

Terminal window
cd import-google-adk

ビルド

インポートは、プロジェクトの隣の source/ に Aggrega ファイルの下書きを作成します。インポートはプロジェクトを標準ライブラリのカタログと照らし合わせます。このカタログは、ワークスペースのデフォルトレジストリが署名付きスナップショットとして公開しているものです。最初のインポートがそれを取得して検証し、ワークスペースのコンテンツキャッシュに保持し、下書きの隣に書き出す記録の中でそのダイジェストによって示します。独自のカタログフォルダーを指定しているワークスペース(AGGREGA_CATALOG_DIRS 内、または workspace.catalog_dirs の下)では、代わりにそれらに対してインポートします。インポートは support_agent/import-answers.yaml からイメージを読み取り、続いて下書きされた Release が依存するものをプルするため、すぐにビルドへ進めます:

Terminal window
cd source
aggrega import support_agent --target compose
aggrega build --release release.yaml

例で指定しているイメージは、プロジェクトからビルドするイメージを表しています。そのビルド方法とスタックの実行方法は、上記リンク先のウォークスルーにあります。

AI アシスタントを使う

Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。

Aggrega のツールだけを使い、フォルダーは自分で作成しないでください。ワークスペースフォルダーにまだ `import-google-adk` フォルダーがない場合は、`example` を `import-google-adk` に設定し、`dir` を指定せずに `scaffold` ツールを一度呼び出してください。このツールは例を新しい `import-google-adk` フォルダーに書き込み、その `source` フォルダーにこの例がインポートするものが入ります。次に、`workspace_root` を `import-google-adk/source`、`source` を `support_agent`、`target` を `compose` に設定して `import` ツールを呼び出してください。このツールは必要な回答を `support_agent` フォルダー内の `import-answers.yaml` から読み取り、下書きを `import-google-adk/source` に書き込み、下書きが必要とするものをプルします。次に、`workspace_root` を `import-google-adk/source`、`release` を `release.yaml` に設定して `validate` ツールを、`workspace_root` を `import-google-adk/source`、`release` を `release.yaml`、`write` を true に設定して `build` ツールを呼び出してください。ビルドが書き込んだファイルを教えてください。それらは `import-google-adk/source/dist/` の下にあります。

テストする

ウォークスルーと同じように、その Dockerfile がビルドするイメージでスタックを実行したら、Release が公開するポートでエージェントにメッセージを送ります:

Terminal window
curl -sS -X POST http://127.0.0.1:8000/run -H 'Content-Type: application/json' \
-d '{"app_name": "support_agent", "user_id": "u1", "session_id": "s1", "new_message": {"role": "user", "parts": [{"text": "Where is my order 1234? Answer in one short sentence."}]}}'

この実行の Gemini キーはプレースホルダーだったため、リクエストは HTTP 500、Internal Server Error を返し、サービスのログには Gemini による拒否が記録されています:

google.genai.errors.ClientError: 400 INVALID_ARGUMENT. {'error': {'code': 400, 'message': 'API key not valid. Please pass a valid API key.', 'status': 'INVALID_ARGUMENT', [… omitted: the error's details]}}

--target helm でインポートし、ウォークスルー に示すとおりクラスターが読み取るレジストリにプッシュしたイメージを使うと、ローカルポートをその Service に転送した時点で、エージェントは同じアドレスで同じメッセージに応答します:

Terminal window
kubectl port-forward -n <namespace> svc/support-agent-default 8000:8000