Mendaftarkan endpoint

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

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

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

Catatan: Pendaftaran manual tidak didukung di lokasi multi-region us dan eu. Anda harus mendaftarkan resource di wilayah yang didukung atau lokasi global. Untuk mengetahui informasi selengkapnya, lihat Lokasi Agent Registry.

Sebelum memulai

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

Untuk menggunakan perintah Google Cloud CLI dalam dokumen ini, pastikan Anda telah menyiapkan lingkungan gcloud 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.

   Jika perlu, klik Uji koneksi di panel ini untuk menguji koneksi Anda ke URL tujuan.

   Catatan: Anda dapat mendaftarkan endpoint yang menggunakan URL pribadi. Namun, uji koneksi hanya berfungsi untuk endpoint publik, dengan memeriksa apakah URL publik dapat dijangkau. Pengujian tidak mendukung URL atau endpoint pribadi yang memerlukan pengiriman data yang diautentikasi, seperti endpoint Agent Runtime di Gemini Enterprise Agent Platform.

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 ENDPOINT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --endpoint-spec-type=no-spec \
  --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL

Ganti kode berikut:

• ENDPOINT_NAME: Nama yang ingin Anda berikan ke endpoint, 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: Pengikatan protokol untuk antarmuka. Nilai yang valid adalah HTTP_JSON, GRPC, atau JSONRPC.

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