Panduan memulai: Mendaftarkan agen

Mendaftarkan agen akan mengubahnya dari workload terisolasi menjadi komponen yang dapat ditemukan dalam Agent Registry. Dengan memublikasikan kemampuan agen, Anda memungkinkan developer dan agen pengatur lainnya di organisasi Anda menemukan dan menggunakan kembali pekerjaan Anda, sehingga mempercepat pengembangan AI.

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

Sebelum memulai

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

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 se contoh Kartu Agen Agent2Agent (A2A).

Ikuti langkah-langkah berikut untuk mendaftarkan agen:

  1. Di Google Cloud konsol, buka Agent Registry:

    Buka Agent Registry

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

  3. Pilih tab Agents.

  4. Klik Add agent.

  5. Di panel Agent details, masukkan detail berikut:

    • Display name: Mock Travel Agent
    • Description: A mock agent that plans travel itineraries.
    • Lokasi: Pilih global.
    • Jenis agen: Pilih A2A.

  6. Di bagian Agent specification, pilih tab Paste JSON.

  7. Salin dan tempel konten Kartu Agen contoh berikut:

    {
  "schemaVersion": "0.3",
  "agent": {
    "name": "mock-travel-agent",
    "description": "A mock agent that plans travel itineraries.",
    "skills": [
      {
        "name": "BookFlight",
        "description": "Books a flight to a destination."
      },
      {
        "name": "SearchHotels",
        "description": "Searches for hotels in a destination city."
      }
    ]
  }
}

  8. Klik Save.

Agent Registry memproses kartu agen dan mendaftarkan agen.

Memverifikasi pendaftaran

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

  1. Di tab Agents, temukan Mock Travel Agent dalam daftar.
  2. Klik Mock Travel Agent untuk melihat detailnya.
  3. Pastikan kemampuan BookFlight dan SearchHotels ditampilkan di tab Overview.

Pembersihan

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

  1. Di tab Agents, temukan Mock Travel Agent dalam daftar.
  2. Klik menu More options di samping Mock Travel Agent, lalu pilih Delete.
  3. Pada dialog konfirmasi, klik Delete.

Langkah berikutnya