エージェントを使用する

Agent Platform SDK の使用

Agent Platform SDK を使用する場合、エージェントにクエリを実行するコードは、エージェントがローカルで実行されているか、リモートでデプロイされているかに関係なく同じです。サポートされるオペレーションのセットはフレームワークによって異なるため、フレームワーク固有のテンプレートの使用方法を以下に示します。

フレームワーク 説明
Agent Development Kit AI アプリケーションを構築するデベロッパーや、堅牢なエージェントベースのソリューションを迅速にプロトタイピングしてデプロイする必要があるチーム向けに、Google の内部ベスト プラクティスに基づいて設計されています。
Agent2Agent（プレビュー） Agent2Agent（A2A）プロトコルは、AI エージェント間のシームレスな通信とコラボレーションを可能にするように設計されたオープン スタンダードです。
LangChain 事前定義された構成と抽象化により、基本的なユースケースですぐに使用できます。
LangGraph ワークフローを定義するためのグラフベースのアプローチ。高度な人間参加型機能と巻き戻し / 再生機能を備えています。
AG2（旧 AutoGen） AG2 は、LLM ワークフローを構築するための高レベルの抽象化として、マルチエージェント会話フレームワークを提供します。
LlamaIndex（プレビュー） LlamaIndex のクエリ パイプラインは、検索拡張生成（RAG）ワークフローを作成するための高レベル インターフェースを提供します。
カスタム フレームワーク固有のテンプレートを使用せずに開発、デプロイされたエージェント。

localhost で提供されるエージェントを使用する

http://localhost:PORT_NUMBER でリクエストをリッスンする API サーバーを介してエージェントを提供する場合、リクエストは次の場所に送信されます。

http://localhost:PORT_NUMBER/API_PATH

ここで

  • PORT_NUMBER は、サーバーがリッスンしているポート番号です（例: 8080）。
  • API_PATH は、対応する API エンドポイントのパスです（run、run_sse など）。

基盤となる API を介してデプロイされたエージェントを使用する

エージェントをデプロイした場合は、対応するエンドポイントにリクエストを 送信します。

https://LOCATION-aiplatform.googleapis.com/reasoningEngines/v1/projects/PROJECT_NUMBER/locations/<var>LOCATION</var>/reasoningEngines/RESOURCE_ID/api/API_PATH

ここで

このエンドポイントは、localhost のベース URL をデプロイされたエージェントのベース URL に置き換えるのと同じです。

例として、ADK API サーバー を Dockerfile または コンテナ イメージからデプロイした場合は、次のように API エンドポイントを呼び出します。

エージェントを実行する（単一のレスポンス） 

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID/api/run -d '{
  "appName": "my_sample_agent",
  "userId": "u_123",
  "sessionId": "s_abc",
  "newMessage": {
    "role": "user",
    "parts": [{"text": "What is the capital of France?"}]
  }
}'

エージェントを実行する（ストリーミング） 

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID/api/run_sse -d '{
  "appName": "my_sample_agent",
  "userId": "u_123",
  "sessionId": "s_abc",
  "newMessage": {
    "role": "user",
    "parts": [{"text": "What is the weather in New York?"}]
  },
  "streaming": true
}'

コンソールでデプロイされたエージェントを使用する Google Cloud

Agent Development Kit（ADK）を使用して開発されたデプロイ済みエージェントの場合は、 Google Cloud コンソールを使用してエージェントとやり取りできます。

  1. コンソールで、[Agent Platform] の [デプロイ] ページに移動します。 Google Cloud

    Agent Platform のデプロイに移動

    選択したプロジェクトの一部であるランタイムがリストに表示されます。[フィルタ] フィールドを使用して、指定した列でリストをフィルタできます。

  2. ランタイムの名前をクリックします。

  3. [プレイグラウンド] タブをクリックします。

  4. [メッセージを入力] してエージェントとやり取りし、[新しいセッション] をクリックしてエージェントとの新しいセッションを開始できます。

  5. OpenTelemetry を使用してトレースを有効にした 場合は、やり取り中のエージェントの動作に関する詳細を表示できます。

    • トレース: エージェントとの会話のトレース。

    • イベント: エージェントとの 会話中に呼び出された API とイベントの詳細のグラフ。

    • 状態: 会話中のエージェントの状態に関する情報。

    • セッション: エージェントに関連付けられているセッションのリスト。詳細については、コンソールまたは API 呼び出しを使用して管理する Google Cloud をご覧ください。

プレイグラウンドのサポート

次のフレームワークを使用してエージェントを試すことができます。

フレームワーク エージェントとチャット セッションを表示
Agent Development Kit（ADK） サポート対象 サポートされています。エージェントが永続性のために Agent Platform セッション を実装する必要があります。
Agent2Agent（A2A） サポートされています。エージェントが永続性のために Agent Platform セッション を実装する必要があります。 サポートされています。エージェントが Agent Platform セッションを使用し、エージェントが コンテキスト オブジェクトの一部として user_id 値を送信する必要があります。エージェント エグゼキュータの一部として user_id 値を渡す方法の例については、A2A の使用を開始するノートブックをご覧ください。

次のステップ