Panduan memulai: Mendaftarkan agen

Dengan mendaftarkan agen di Agent Registry, Anda dapat mengubah komponen yang terisolasi menjadi bagian yang dapat ditemukan dari ekosistem AI Anda. Dengan memublikasikan kemampuan A2A agen, Anda membantu developer dan agen orkestrator lain di organisasi Anda menemukan dan menggunakan kembali pekerjaan Anda.

Dalam panduan memulai ini, Anda akan 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

  1. Menyiapkan Agent Registry.
  2. Dapatkan project ID untuk project tata kelola tempat Agent Registry diaktifkan.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mendaftarkan agen di Agent Registry, minta administrator untuk memberi Anda peran IAM Agent Registry API Editor (roles/agentregistry.editor) di project tata kelola tempat Agent Registry diaktifkan. 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.

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 project Google Cloud tempat Anda menyiapkan Agent Registry.

  3. Pilih tab Agents.

  4. Klik Tambahkan agen.

  5. Di panel Agent details, masukkan detail berikut:

    • Type: pilih A2A.
    • Region: pilih global (Global).

  6. Pilih tab Tempel JSON.

  7. Tempelkan 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 kemampuan A2A BookFlight dan SearchHotels muncul di tab Ringkasan.

Pembersihan

Agar tidak meninggalkan resource tiruan di project Anda, hapus agen yang terdaftar:

  1. Di tab Agen, temukan agen tiruan dalam daftar.
  2. Klik menu More options di kolom Actions pada agen tiruan, lalu pilih Delete.
  3. Dalam dialog konfirmasi, masukkan DELETE untuk mengonfirmasi tindakan.
  4. Klik Hapus.

Langkah berikutnya