Mendaftarkan endpoint

Di Agent Registry, endpoint merepresentasikan URL target, biasanya REST API, yang diakses oleh agen Anda. Dengan mendaftarkan tujuan ini sebagai resource terkelola, Anda dapat mengelola secara terpusat layanan eksternal yang dapat dihubungkan oleh kumpulan agen Anda.

Dokumen ini menjelaskan cara mendaftarkan endpoint eksternal secara eksplisit di registri.

Sebelum memulai

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

Untuk menggunakan perintah gcloud CLI dalam dokumen ini, pastikan Anda telah menyiapkan lingkungan Google Cloud CLI.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mendaftarkan endpoint 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 endpoint

Karena endpoint adalah tujuan eksternal kustom, gunakan pendaftaran manual untuk menambahkannya ke Agent Registry:

Konsol

  1. Di konsol Google Cloud , buka Agent Registry:

    Buka Agent Registry

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

  3. Pilih tab Endpoints.

  4. Klik Add endpoint.

  5. Di panel Endpoint details, masukkan nama tampilan, deskripsi, wilayah geografis, dan URL tujuan. Anda dapat menguji koneksi ke URL tujuan dari panel ini.

  6. Klik Simpan.

gcloud

Anda membuat resource Service dengan endpoint-spec-type no-spec.

Daftarkan endpoint dan tentukan detail koneksi antarmukanya:

gcloud alpha agent-registry services create SERVICE_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --endpoint-spec-type=no-spec \
  --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL

Ganti kode berikut:

  • SERVICE_NAME: Nama yang ingin Anda berikan ke resource, misalnya, my-external-api.
  • PROJECT_ID: Project ID.
  • REGION: Region registri.
  • DISPLAY_NAME: Nama endpoint yang dapat dibaca manusia.
  • ENDPOINT_URL: URL target, misalnya, https://api.example.com/v1/data.
  • PROTOCOL: Binding protokol untuk antarmuka. Nilai yang valid adalah HTTP_JSON, GRPC, atau JSONRPC.

Setelah resource Service dibuat, Pendaftaran Agen akan otomatis membuat resource Endpoint hanya baca di sisi konsumen yang dapat ditemukan dan digunakan oleh agen dan pengelola.