Agent Development Kit を使用して Agent Runtime でエージェントを開発してデプロイする

Agent Runtime を使用すると、Agent Development Kit（ADK）で開発されたエージェントをホストできます。このドキュメントでは、ADK を使用してエージェントを作成、デプロイ、テストする方法について説明します。

このクイックスタートでは、次の手順について説明します。

Google Cloud プロジェクトを設定する。
Agent Platform SDK for Python と ADK をインストールします。
為替レートエージェントを開発します。
エージェントを Agent Runtime にデプロイします。
デプロイしたエージェントをテストします。

ADK の代替クイックスタートとして、次のものも使用できます。

ADK クイックスタート: ADK クイックスタートはマシン上で完全に実行され、ローカル IDE とターミナルアクセスを使用していることを前提としています。
Agent Starter Pack: Agent Platform 用に構築されたプロダクションレディな生成 AI エージェントテンプレートのコレクション。

Agent Development Kit 以外のサポートされているフレームワークを使用したクイックスタートについては、Agent Runtime でエージェントを開発してデプロイするをご覧ください。

始める前に

Google Cloud アカウントにログインします。 Google Cloudを初めて使用する場合は、アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Agent Platform and Cloud Storage APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Agent Platform and Cloud Storage APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Agent Runtime の使用に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

Agent Platform ユーザー（roles/aiplatform.user）
ストレージ管理者（roles/storage.admin）

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

Agent Platform SDK for Python をインストールして初期化する

次のコマンドを実行して、Agent Platform SDK for Python とその他の必要なパッケージをインストールします。
```
pip install --upgrade --quiet google-cloud-aiplatform[agent_engines,adk]>=1.112
```
ユーザーとして認証します。
ローカルシェル
次のコマンドを実行します。
```
gcloud auth application-default login
```
Colab
次のコードを実行します。
```
from google.colab import auth

auth.authenticate_user(project_id="PROJECT_ID")
```
Cloud Shell
対応は不要です。
次のコードを実行して、Agent Platform をインポートし、SDK を初期化します。
Google Cloud プロジェクト
```
import vertexai

client = vertexai.Client(
    project="PROJECT_ID",               # Your project ID.
    location="LOCATION",                # Your cloud region.
)
```
ここで
- PROJECT_ID は、エージェントを開発してデプロイする Google Cloud プロジェクト ID です。
- LOCATION は、サポートされているリージョンの一つです。

エージェントを開発する

エージェントの通貨換算ツールを開発します。

def get_exchange_rate(
    currency_from: str = "USD",
    currency_to: str = "EUR",
    currency_date: str = "latest",
):
    """Retrieves the exchange rate between two currencies on a specified date."""
    import requests

    response = requests.get(
        f"https://api.frankfurter.app/{currency_date}",
        params={"from": currency_from, "to": currency_to},
    )
    return response.json()

エージェントをインスタンス化します。

from google.adk.agents import Agent
from vertexai import agent_engines

agent = Agent(
    model="gemini-2.0-flash",
    name='currency_exchange_agent',
    tools=[get_exchange_rate],
)

app = agent_engines.AdkApp(agent=agent)

ローカルでエージェントをテストします。

注: ADK エージェントをローカルでテストする場合は、インメモリセッションを使用します。
```
async for event in app.async_stream_query(
    user_id="USER_ID",
    message="What is the exchange rate from US dollars to SEK today?",
):
    print(event)
```
ここで、USER_ID はユーザー定義の ID で、文字数制限は 128 です。

エージェントをデプロイする

Agent Platform で reasoningEngine リソースを作成して、エージェントをデプロイします。

remote_agent = client.agent_engines.create(
    agent=app,
    config={
        "requirements": ["google-cloud-aiplatform[agent_engines,adk]"],
        "staging_bucket": "STAGING_BUCKET",
        "identity_type": types.IdentityType.AGENT_IDENTITY,
    }
)

ここで、STAGING_BUCKET は gs:// で始まる Cloud Storage バケットです。

エージェントを使用する

クエリを送信して、デプロイしたエージェントをテストします。

async for event in remote_agent.async_stream_query(
    user_id="USER_ID",
    message="What is the exchange rate from US dollars to SEK today?",
):
    print(event)

クリーンアップ

このページで使用したリソースについて、 Google Cloud アカウントに課金されないようにするには、次の手順を実施します。

remote_agent.delete(force=True)

次のステップ

ガイド

Agent Development Kit を使用して Agent Runtime でエージェントを開発してデプロイする

始める前に

Agent Platform SDK for Python をインストールして初期化する

ローカルシェル

Colab

Cloud Shell

Google Cloud プロジェクト

エージェントを開発する

エージェントをデプロイする

エージェントを使用する

クリーンアップ

次のステップ

Agent Platform Runtime の設定

エージェントをデプロイする

デプロイされたエージェントを管理する

エージェントを使用する

サポートを受ける