Mengembangkan dan men-deploy agen di Agent Runtime dengan Agent Development Kit

Mengembangkan dan men-deploy agen di Agent Runtime dengan Agent Development Kit

Agent Runtime memungkinkan Anda menghosting agen yang dikembangkan dengan Agent Development Kit (ADK). Dokumen ini menjelaskan cara membuat, men-deploy, dan menguji agen menggunakan ADK.

Panduan memulai ini akan memandu Anda melalui langkah-langkah berikut:

• Menyiapkan project Anda. Google Cloud
• Menginstal Agent Platform SDK untuk Python dan ADK.
• Mengembangkan agen penukaran mata uang.
• Men-deploy agen ke Agent Runtime.
• Menguji agen yang di-deploy.

Anda juga dapat menggunakan panduan memulai alternatif berikut untuk ADK:

• Panduan memulai ADK: Panduan memulai ADK berjalan sepenuhnya di komputer Anda dan mengasumsikan bahwa Anda menggunakan IDE lokal dan akses terminal.
• Paket Starter Agen: Kumpulan template agen AI generatif siap produksi yang dibuat untuk Agent Platform.

Untuk panduan memulai menggunakan framework yang didukung selain Agent Development Kit, lihat Mengembangkan dan men-deploy agen di Agent Runtime.

Sebelum memulai

Catatan: Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda tidak memiliki izin ini, minta administrator untuk memberi Anda peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin).

Login keakun Anda. Google Cloud Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

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

Untuk mendapatkan izin yang diperlukan untuk menggunakan Agent Runtime, minta administrator untuk memberi Anda peran IAM berikut di project Anda:

• Pengguna Agent Platform (roles/aiplatform.user)
• Storage Admin (roles/storage.admin)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Menginstal dan menginisialisasi Agent Platform SDK untuk Python

1. Jalankan perintah berikut untuk menginstal Agent Platform SDK untuk Python dan paket lain yang diperlukan:

   pip install --upgrade --quiet google-cloud-aiplatform[agent_engines,adk]>=1.112

2. Mengautentikasi sebagai pengguna

   Shell Lokal

   Jalankan perintah berikut:

   gcloud auth application-default login

   Colab

   Jalankan kode berikut:

   from google.colab import auth
   
   auth.authenticate_user(project_id="PROJECT_ID")
   

   Cloud Shell

   Tindakan tidak diperlukan.

3. Jalankan kode berikut untuk mengimpor Agent Platform dan menginisialisasi SDK:

   Project Google Cloud

   import vertexai
   
   client = vertexai.Client(
       project="PROJECT_ID",               # Your project ID.
       location="LOCATION",                # Your cloud region.
   )
   

   Dengan:

   • PROJECT_ID adalah Google Cloud project ID tempat Anda mengembangkan dan men-deploy agen

   • LOCATION adalah salah satu wilayah yang didukung.

Mengembangkan agen

1. Mengembangkan alat penukaran mata uang untuk agen Anda:

   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()
   

2. Membuat instance agen:

   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)
   

3. Menguji agen secara lokal:

   Catatan: Menguji agen ADK secara lokal menggunakan sesi dalam memori.

   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)
   

   dengan USER_ID adalah ID yang ditentukan pengguna dengan batas karakter 128.

Men-deploy agen

Men-deploy agen dengan membuat reasoningEngine resource di Agent Platform:

Catatan: Men-deploy agen ADK ke Agent Platform akan otomatis membuat resource sesi terkelola. Anda dapat menghapus resource sesi terkelola bersama dengan agen di bagian Pembersihan.

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,
    }
)

dengan STAGING_BUCKET adalah bucket Cloud Storage yang diawali dengan gs://.

Menggunakan agen

Menguji agen yang di-deploy dengan mengirimkan kueri:

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)

Pembersihan

Agar akunAnda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut. Google Cloud

remote_agent.delete(force=True)

Langkah berikutnya

Panduan

Penyiapan Runtime Agent Platform

Siapkan lingkungan Anda untuk menggunakan Runtime Agent Platform.

Panduan

Men-deploy agen

Pelajari lima cara men-deploy agen di Runtime Agent Platform berdasarkan kebutuhan pengembangan Anda.

Panduan

Mengelola agen yang di-deploy

Pelajari cara mengelola agen yang telah di-deploy ke runtime terkelola Agent Platform.

Panduan

Menggunakan agen

Menggunakan agen dengan Runtime Agent Platform.

Referensi

Mendapatkan dukungan

Temukan referensi dan dukungan untuk Google Agent Platform.