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 mewakili URL target, biasanya REST API, yang diakses oleh agen Anda. Dengan mendaftarkan tujuan ini sebagai komponen agen yang dikelola dalam Agent Registry, Anda dapat mengontrol secara terpusat endpoint eksternal yang dapat terhubung dengan fleet agen Anda.

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

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

Sebelum memulai

Sebelum memulai, siapkan Agent Registry. Anda memerlukan project ID 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 Editor API Agent Registry (roles/agentregistry.editor) pada 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 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 Endpoints.

4. Klik Add endpoint.

5. Di panel Endpoint details, masukkan nama tampilan, deskripsi, region geografis, dan URL tujuan.

   Secara opsional, klik Test connection di panel ini untuk menguji koneksi Anda ke URL tujuan.

   Catatan: Anda dapat mendaftarkan endpoint yang menggunakan URL pribadi. Namun, pengujian koneksi hanya berfungsi untuk endpoint publik, dengan memeriksa apakah URL publik dapat dijangkau. Pengujian ini tidak mendukung URL pribadi atau endpoint yang memerlukan pengiriman data yang diautentikasi, seperti endpoint Vertex AI.

6. Klik Save.

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 registry.
• 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, Agent Registry akan otomatis membuat resource Endpoint hanya baca di sisi konsumen yang dapat ditemukan dan digunakan oleh agen dan pengatur untuk ditemukan dan digunakan.