Panduan memulai: Mendaftarkan agen

Mendaftarkan agen mengubahnya dari komponen terisolasi menjadi bagian yang dapat ditemukan dan terintegrasi dari ekosistem AI Anda dalam Agent Registry. Dengan memublikasikan kemampuan A2A agen Anda, Anda memungkinkan developer dan agen pengelola lainnya di organisasi Anda menemukan dan menggunakan kembali pekerjaan Anda, sehingga mempercepat pengembangan AI secara keseluruhan.

Panduan memulai ini menunjukkan cara mendaftarkan agen tiruan secara manual di Agent Registry menggunakan konsol Google Cloud . Untuk mengetahui informasi selengkapnya tentang mekanisme pendaftaran agen di Agent Registry, lihat Mendaftarkan agen.

Sebelum memulai

Sebelum memulai, siapkan Agent Registry. Anda memerlukan project ID untuk melakukan tugas ini.

Aktifkan Agent Registry API:

Konsol

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

Mengaktifkan API

gcloud

Aktifkan Agent Registry API di project Anda:

gcloud services enable agentregistry.googleapis.com \
    --project=PROJECT_ID

Ganti PROJECT_ID dengan project ID Anda.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mendaftarkan agen di Agent Registry, minta administrator untuk memberi Anda peran IAM Agent Registry API Editor (roles/agentregistry.editor) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

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

Mendaftarkan agen tiruan

Untuk mencoba Agent Registry, Anda dapat mendaftarkan agen tiruan secara manual dengan menempelkan contoh Kartu Agen Agent2Agent (A2A).

Ikuti langkah-langkah berikut untuk mendaftarkan agen:

  1. Di konsol Google Cloud , buka Agent Registry:

    Buka Agent Registry

    Jika diminta, klik Enable untuk mengaktifkan Agent Registry API.

  2. Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.

  3. Pilih tab Agen.

  4. Klik Tambahkan agen.

  5. Di panel Agent details, masukkan detail berikut:

    • Jenis: Pilih A2A.
    • Region: Pilih global (Global).

  6. Pilih tab Tempel JSON.

  7. Salin dan tempel contoh konten Kartu Agen berikut:

    {
  "supportedInterfaces": [
    {
      "url": "https://example.com/mock-travel-agent",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0.0"
    }
  ],
  "name": "mock-travel-agent",
  "description": "A mock agent that plans travel itineraries.",
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "defaultInputModes": ["text/plain"],
  "defaultOutputModes": ["text/plain"],
  "skills": [
    {
      "id": "BookFlight",
      "name": "BookFlight",
      "description": "Books a flight to a destination.",
      "tags": ["travel", "booking"]
    },
    {
      "id": "SearchHotels",
      "name": "SearchHotels",
      "description": "Searches for hotels in a destination city.",
      "tags": ["travel", "accommodation"]
    }
  ]
}

  8. Klik Simpan.

Agent Registry memproses kartu agen dan mendaftarkan agen.

Memverifikasi pendaftaran

Untuk mengonfirmasi bahwa agen tiruan Anda berhasil didaftarkan, lakukan hal berikut:

  1. Di tab Agen, temukan agen tiruan dalam daftar.
  2. Klik nama agen untuk melihat detailnya.
  3. Pastikan bahwa kemampuan A2A BookFlight dan SearchHotels ditampilkan di tab Ringkasan.

Pembersihan

Untuk menghindari resource tiruan yang tertinggal di project Anda, hapus agen terdaftar:

  1. Di tab Agen, temukan agen tiruan dalam daftar.
  2. Klik menu Opsi lainnya di kolom Tindakan agen tiruan, lalu pilih Hapus.
  3. Pada dialog konfirmasi, ketik HAPUS untuk mengonfirmasi tindakan.
  4. Klik Hapus.

Langkah berikutnya