エージェントランタイムでデプロイされたエージェントをテストする¶

これらの手順では、にデプロイされた ADK エージェントをテストする方法について説明します。 Agent Runtime ランタイム環境。これらの手順を使用する前に、次の作業を完了する必要がありますエージェントランタイムランタイム環境へのエージェントのデプロイメント available methodsの。このガイドでは、次のことを示します Google Cloud 経由でデプロイされたエージェントを表示、操作、テストする方法コンソール、および REST API 呼び出しまたはエージェントプラットフォーム SDK を使用してエージェントと対話するパイソン用。

Cloud Console でデプロイされたエージェントを表示する¶

Cloud Console でデプロイされたエージェントを表示するには:

Google Cloud Console の [エージェントランタイム] ページに移動します。 https://console.cloud.google.com/vertex-ai/agents/agent-engines

このページには、現在選択されている Google Cloud にデプロイされているすべてのエージェントがリストされますプロジェクト。エージェントがリストに表示されない場合は、エージェントを持っていることを確認してください。 Google Cloud Console で選択したターゲットプロジェクト。詳細については、既存の Google Cloud プロジェクトの選択については、を参照してください。 Creating and managing projects。

Google Cloud プロジェクト情報を見つける¶

プロジェクトのアドレスとリソース ID (PROJECT_ID、 LOCATION_ID、RESOURCE_ID) を使用して、展開をテストできるようになります。クラウドを利用できるこの情報を見つけるには、コンソールまたは gcloud コマンドラインツールを使用します。

エージェントプラットフォームのエクスプレスモード API キー

Agent Platform 高速モードを使用している場合は、この手順をスキップして API キーを使用できます。

Google Cloud Console でプロジェクト情報を検索するには:

Google Cloud Console で、[エージェントランタイム] ページに移動します。 https://console.cloud.google.com/vertex-ai/agents/agent-engines
ページの上部で [API URL] を選択し、クエリをコピーします。デプロイされたエージェントの URL 文字列。次の形式である必要があります。
```
https://$(LOCATION_ID)-aiplatform.googleapis.com/v1/projects/$(PROJECT_ID)/locations/$(LOCATION_ID)/reasoningEngines/$(RESOURCE_ID):query
```

gcloud コマンドラインツールを使用してプロジェクト情報を検索するには:

開発環境で、認証されていることを確認してください。 Google Cloud にアクセスし、次のコマンドを実行してプロジェクトを一覧表示します。
```
gcloud projects list
```

デプロイメントに使用したプロジェクト ID を使用して、次のコマンドを実行して取得します。追加の詳細:

gcloud asset search-all-resources \
    --scope=projects/$(PROJECT_ID) \
    --asset-types='aiplatform.googleapis.com/ReasoningEngine' \
    --format="table(name,assetType,location,reasoning_engine_id)"

REST 呼び出しを使用してテストする¶

エージェントランタイムでデプロイされたエージェントと対話する簡単な方法は、REST を使用することです。 curl ツールを使用して呼び出します。このセクションでは、エージェントへの接続と、デプロイされたエージェントによるリクエストの処理のテストにも使用できます。エージェント。

エージェントへの接続を確認してください¶

クエリ URL を使用して、実行中のエージェントへの接続を確認できます。 Cloud Console のエージェントランタイムセクションで利用できます。このチェックでは、デプロイされたエージェントを実行しますが、エージェントに関する情報を返します。

REST 呼び出しを送信し、デプロイされたエージェントから応答を取得するには:

開発環境のターミナルウィンドウでリクエストを作成します。そしてそれを実行します:

Google Cloud ProjectAgent Platform express mode

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://$(LOCATION_ID)-aiplatform.googleapis.com/v1/projects/$(PROJECT_ID)/locations/$(LOCATION_ID)/reasoningEngines"

curl -X GET \
    -H "x-goog-api-key:YOUR-EXPRESS-MODE-API-KEY" \
    "https://aiplatform.googleapis.com/v1/reasoningEngines"

デプロイメントが成功した場合、このリクエストは有効なリストを返します。リクエストと予期されるデータ形式。

接続 URL の :query パラメータを削除

クラウドのエージェントランタイムセクションで利用可能な クエリ URL を使用する場合コンソールでは、アドレスの末尾から :query パラメータを必ず削除してください。

エージェント接続のためのアクセス

この接続テストでは、呼び出し元のユーザーがその接続に対する有効なアクセストークンを持っている必要があります。配備されたエージェント。他の環境からテストする場合は、呼び出し元のユーザーが Google Cloud プロジェクトのエージェントに接続するためのアクセス権を持っています。

エージェントリクエストを送信する¶

エージェントプロジェクトから応答を取得するときは、最初にセッションを開始し、セッション ID を受信し、そのセッションを使用してリクエストを送信します。 ID。このプロセスについては、次の手順で説明します。

REST 経由でデプロイされたエージェントとの対話をテストするには:

開発環境のターミナルウィンドウでセッションを作成します。このテンプレートを使用してリクエストを作成します。

Google Cloud ProjectAgent Platform express mode

curl \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    https://$(LOCATION_ID)-aiplatform.googleapis.com/v1/projects/$(PROJECT_ID)/locations/$(LOCATION_ID)/reasoningEngines/$(RESOURCE_ID):query \
    -d '{"class_method": "async_create_session", "input": {"user_id": "u_123"},}'

curl \
    -H "x-goog-api-key:YOUR-EXPRESS-MODE-API-KEY" \
    -H "Content-Type: application/json" \
    https://aiplatform.googleapis.com/v1/reasoningEngines/$(RESOURCE_ID):query \
    -d '{"class_method": "async_create_session", "input": {"user_id": "u_123"},}'

前のコマンドからの応答で、作成された セッション ID を抽出します。 id フィールドから:

{
    "output": {
        "userId": "u_123",
        "lastUpdateTime": 1757690426.337745,
        "state": {},
        "id": "4857885913439920384", # Session ID
        "appName": "9888888855577777776",
        "events": []
    }
}

開発環境のターミナルウィンドウで、次の宛先にメッセージを送信します。このテンプレートとセッション ID を使用してリクエストを作成し、エージェントを作成します。前のステップで作成したもの:

Google Cloud ProjectAgent Platform express mode

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://$(LOCATION_ID)-aiplatform.googleapis.com/v1/projects/$(PROJECT_ID)/locations/$(LOCATION_ID)/reasoningEngines/$(RESOURCE_ID):streamQuery?alt=sse -d '{
"class_method": "async_stream_query",
"input": {
    "user_id": "u_123",
    "session_id": "4857885913439920384",
    "message": "Hey whats the weather in new york today?",
}
}'

curl \
-H "x-goog-api-key:YOUR-EXPRESS-MODE-API-KEY" \
-H "Content-Type: application/json" \
https://aiplatform.googleapis.com/v1/reasoningEngines/$(RESOURCE_ID):streamQuery?alt=sse -d '{
"class_method": "async_stream_query",
"input": {
    "user_id": "u_123",
    "session_id": "4857885913439920384",
    "message": "Hey whats the weather in new york today?",
}
}'

このリクエストは、JSON でデプロイされたエージェントコードからの応答を生成する必要があります。形式。デプロイされた ADK エージェントとの対話の詳細については、 REST 呼び出しを使用したエージェントランタイムについては、を参照してください。 Manage deployed agents そして Use an Agent Development Kit agent エージェントランタイムのドキュメントを参照してください。

Python を使用してテストする¶

Python コードを使用すると、より洗練された反復可能なテストを行うことができます。エージェントランタイムにデプロイされたエージェント。これらの手順では、作成方法について説明します。デプロイされたエージェントとのセッションを開始し、エージェントにリクエストを送信します。処理中。

リモートセッションを作成する¶

remote_app オブジェクトを使用して、デプロイされたリモートエージェントへの接続を作成します。

# If you are in a new script or used the ADK CLI to deploy, you can connect like this:
# remote_app = agent_engines.get("your-agent-resource-name")
remote_session = await remote_app.async_create_session(user_id="u_456")
print(remote_session)

create_session (リモート) の予想される出力:

{'events': [],
'user_id': 'u_456',
'state': {},
'id': '7543472750996750336',
'app_name': '7917477678498709504',
'last_update_time': 1743683353.030133}

id 値はセッション ID で、app_name はそのリソース ID です。エージェントランタイムにエージェントをデプロイします。

リモートエージェントにクエリを送信する¶

async for event in remote_app.async_stream_query(
    user_id="u_456",
    session_id=remote_session["id"],
    message="whats the weather in new york",
):
    print(event)

async_stream_query (リモート) の予想される出力:

{'parts': [{'function_call': {'id': 'af-f1906423-a531-4ecf-a1ef-723b05e85321', 'args': {'city': 'new york'}, 'name': 'get_weather'}}], 'role': 'model'}
{'parts': [{'function_response': {'id': 'af-f1906423-a531-4ecf-a1ef-723b05e85321', 'name': 'get_weather', 'response': {'status': 'success', 'report': 'The weather in New York is sunny with a temperature of 25 degrees Celsius (41 degrees Fahrenheit).'}}}], 'role': 'user'}
{'parts': [{'text': 'The weather in New York is sunny with a temperature of 25 degrees Celsius (41 degrees Fahrenheit).'}], 'role': 'model'}

デプロイされた ADK エージェントとの対話の詳細については、エージェントランタイム、を参照してください。 Manage deployed agents そして Use a Agent Development Kit agent エージェントランタイムのドキュメントを参照してください。

マルチモーダルクエリの送信¶

マルチモーダルクエリ (画像など) をエージェントに送信するには、types.Part オブジェクトのリストを使用して、async_stream_query の message パラメーターを構築できます。各パーツにはテキストまたは画像を使用できます。

画像を含めるには、types.Part.from_uri を使用して、画像の Google Cloud Storage (GCS) URI を指定します。

from google.genai import types

image_part = types.Part.from_uri(
    file_uri="gs://cloud-samples-data/generative-ai/image/scones.jpg",
    mime_type="image/jpeg",
)
text_part = types.Part.from_text(
    text="What is in this image?",
)

async for event in remote_app.async_stream_query(
    user_id="u_456",
    session_id=remote_session["id"],
    message=[text_part, image_part],
):
    print(event)

Note

モデルとの基礎となる通信には Base64 が含まれる場合がありますが、画像のエンコーディング、画像を送信するために推奨およびサポートされている方法 Agent Runtime にデプロイされたエージェントにデータを送信するには、GCS URI を提供します。

デプロイメントをクリーンアップする¶

テストとして展開を実行した場合は、クリーンアップすることをお勧めします。完了したら、クラウドリソースを削除します。デプロイされたエージェントを削除できますランタイムインスタンス。Google Cloud アカウントへの予期せぬ請求を回避します。

remote_app.delete(force=True)

force=True パラメータは、生成されたすべての子リソースも削除しますデプロイされたエージェント (セッションなど) から。デプロイしたものを削除することもできますエージェント経由で Agent Runtime UI Googleクラウド上で。

エージェント ランタイムでデプロイされたエージェントをテストする¶

Cloud Console でデプロイされたエージェントを表示する¶

Google Cloud プロジェクト情報を見つける¶

REST 呼び出しを使用してテストする¶

エージェントへの接続を確認してください¶

エージェントリクエストを送信する¶

Python を使用してテストする¶

リモートセッションを作成する¶

リモート エージェントにクエリを送信する¶

マルチモーダルクエリの送信¶

デプロイメントをクリーンアップする¶

エージェントランタイムでデプロイされたエージェントをテストする¶

リモートエージェントにクエリを送信する¶