Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Menyiapkan antarmuka Private Service Connect untuk resource Gemini Enterprise Agent Platform

Panduan ini menunjukkan cara menyiapkan antarmuka Private Service Connect untuk resource Gemini Enterprise Agent Platform.

Anda dapat mengonfigurasi koneksi antarmuka Private Service Connect untuk resource tertentu di Gemini Enterprise Agent Platform, termasuk:

Tidak seperti koneksi peering VPC, koneksi antarmuka Private Service Connect bersifat transitif. Hal ini memerlukan lebih sedikit alamat IP di jaringan VPC konsumen. Hal ini memungkinkan fleksibilitas yang lebih besar dalam menghubungkan ke jaringan VPC lain di project Google Cloud dan lokal Anda.

Panduan ini ditujukan bagi administrator jaringan yang sudah memahami konsep jaringan. Google Cloud

Tujuan

Panduan ini mencakup tugas-tugas berikut:

Konfigurasi jaringan, subnet, dan lampiran jaringan VPC konsumen .
Tambahkan aturan firewall ke project host jaringan Google Cloud .
Buat resource Agent Platform yang menentukan lampiran jaringan untuk menggunakan antarmuka Private Service Connect.

Sebelum memulai

Gunakan petunjuk berikut untuk membuat atau memilih project Google Cloud dan mengonfigurasinya untuk digunakan dengan Gemini Enterprise Agent Platform dan Private Service Connect.

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Gemini Enterprise Agent Platform, Compute Engine, and Cloud Storage APIs.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

Instal Google Cloud CLI.

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

Setelah menginisialisasi gcloud CLI, update gcloud CLI dan instal komponen yang diperlukan:

gcloud components update
gcloud components install beta

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Gemini Enterprise Agent Platform, Compute Engine, and Cloud Storage APIs.

Roles required to enable APIs

Enable the APIs

Instal Google Cloud CLI.

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

Setelah menginisialisasi gcloud CLI, update gcloud CLI dan instal komponen yang diperlukan:

gcloud components update
gcloud components install beta

Jika Anda bukan pemilik project dan tidak memiliki peran Project IAM Admin (roles/resourcemanager.projectIamAdmin), minta pemilik untuk memberi Anda peran IAM yang mencakup izin compute.networkAttachments.update, compute.networkAttachments.update, dan compute.regionOperations.get: misalnya, peran Compute Network Admin (roles/compute.networkAdmin), untuk mengelola resource jaringan.
Menetapkan peran yang diperlukan ke Agen Layanan AI Platform. Untuk mengetahui detail tentang peran yang akan diberikan dalam berbagai skenario, lihat bagian Peran yang diperlukan agen layanan Gemini Enterprise Agent Platform dalam dokumen ini.

Menyiapkan jaringan VPC dan subnet

Ikuti langkah-langkah konfigurasi untuk membuat jaringan VPC baru jika Anda tidak memiliki jaringan yang sudah ada.

Buat jaringan VPC:

gcloud compute networks create NETWORK \
    --subnet-mode=custom

Ganti NETWORK dengan nama untuk jaringan VPC.

Buat subnet:
```
gcloud compute networks subnets create SUBNET_NAME \
    --network=NETWORK \
    --range=PRIMARY_RANGE \
    --region=REGION
```
Ganti kode berikut:
- SUBNET_NAME: nama untuk subnet.
- PRIMARY_RANGE: rentang IPv4 utama untuk subnet baru, dalam notasi CIDR.
  
  Berikut adalah persyaratan dan batasan IP untuk Platform Agen:
  - Agent Platform merekomendasikan subnetwork /28.
  - Subnet lampiran jaringan mendukung alamat RFC 1918 dan non-RFC 1918, kecuali subnet 100.64.0.0/20 dan 240.0.0.0/4.
  - Agent Platform hanya dapat terhubung ke rentang alamat IP RFC 1918 yang dapat dirutekan dari jaringan yang ditentukan.
  - Agent Platform tidak dapat menjangkau alamat IP publik yang digunakan secara pribadi atau rentang non-RFC 1918 berikut:
    - 100.64.0.0/20
    - 192.0.0.0/24
    - 192.0.2.0/24
    - 198.18.0.0/15
    - 198.51.100.0/24
    - 203.0.113.0/24
    - 240.0.0.0/4
  Untuk mengetahui informasi selengkapnya, lihat Rentang subnet IPv4.
- REGION: Google Cloud region tempat Anda membuat subnet baru.

Membuat network attachment

Dalam deployment VPC Bersama, buat subnet yang digunakan untuk Lampiran Jaringan di Project Host, lalu buat Lampiran Jaringan Private Service Connect di Project Layanan.

Contoh berikut menunjukkan cara Membuat lampiran jaringan yang secara otomatis menerima koneksi.

   gcloud compute network-attachments create NETWORK_ATTACHMENT_NAME \
       --region=REGION \
       --connection-preference=ACCEPT_AUTOMATIC \
       --subnets=SUBNET_NAME

Ganti NETWORK_ATTACHMENT_NAME dengan nama untuk lampiran jaringan.

Jika network attachment dibuat di project yang berbeda dengan Project Layanan, Anda harus meneruskan jalur network attachment lengkap saat memanggil Gemini Enterprise.

Peran yang diperlukan agen layanan Gemini Enterprise Agent Platform

Dalam project tempat Anda membuat lampiran jaringan, berikan peran compute.networkAdmin ke agen layanan Gemini Enterprise Agent Platform dari project yang sama. Aktifkan Agent Platform API dalam project ini sebelumnya jika berbeda dengan project layanan tempat Anda menggunakan Agent Platform.

Jika Anda menentukan jaringan VPC Bersama untuk digunakan oleh Platform Agen dan Anda membuat lampiran jaringan di project layanan, berikan peran compute.networkUser ke project host VPC Anda kepada agen layanan Platform Agen di project layanan tempat Anda menggunakan Platform Agen.

Mengonfigurasi aturan firewall

Sistem menerapkan aturan firewall Ingress di VPC konsumen untuk mengaktifkan komunikasi dengan subnet network attachment antarmuka Private Service Connect dari endpoint komputasi dan lokal.

Mengonfigurasi aturan firewall bersifat opsional. Namun, sebaiknya tetapkan aturan firewall umum seperti yang ditunjukkan dalam contoh berikut.

Buat aturan firewall yang mengizinkan akses SSH di port TCP 22:

gcloud compute firewall-rules create NETWORK-firewall1 \
    --network NETWORK \
    --allow tcp:22

Buat aturan firewall yang mengizinkan traffic HTTPS di port TCP 443:

gcloud compute firewall-rules create NETWORK-firewall2 \
    --network NETWORK \
    --allow tcp:443

Buat aturan firewall yang mengizinkan traffic ICMP (seperti permintaan ping):

gcloud compute firewall-rules create NETWORK-firewall3 \
    --network NETWORK \
    --allow icmp

Menyiapkan peering DNS pribadi

Untuk mengaktifkan tugas Vertex AI Training atau agen Agent Runtime yang dikonfigurasi dengan PSC-I agar dapat me-resolve data DNS pribadi di zona Cloud DNS yang dikelola pelanggan, AI Platform menawarkan mekanisme yang dapat dikonfigurasi pengguna untuk menentukan domain DNS mana yang akan di-peering dengan resource internal Google. Lakukan konfigurasi tambahan berikut:

Tetapkan peran DNS Peer (roles/dns.peer) ke akun AI Platform Service Agent dalam project tempat layanan Vertex AI Training atau Agent Runtime di Gemini Enterprise Agent Platform aktif.

Jika Anda menggunakan jaringan VPC Bersama untuk Agent Platform dan membuat lampiran jaringan di project layanan, Anda juga harus memberikan peran DNS Peer (roles/dns.peer) kepada Agen Layanan AI Platform project layanan dalam project host VPC Anda.

Buat aturan firewall yang mengizinkan semua traffic ICMP, TCP, dan UDP (opsional):

gcloud compute firewall-rules create NETWORK-firewall4 \
    --network NETWORK
    --allow tcp:0-65535,udp:0-65535,icmp
    --source-ranges IP_RANGES

Siapkan zona DNS pribadi Anda untuk resolusi DNS dan perutean traffic. Untuk menambahkan data DNS ke zona DNS pribadi, lihat bagian Menambahkan set data resource.

Pemecahan masalah

Bagian ini membahas beberapa masalah umum dalam mengonfigurasi Private Service Connect dengan Gemini Enterprise Agent Platform.

Saat mengonfigurasi Agent Platform dengan VPC Bersama, buat network attachment di project layanan tempat Anda menggunakan Agent Platform. Pendekatan ini membantu mencegah pesan error tertentu, seperti:

_Please make sure that the Agent Platform API is enabled for the
project_, by ensuring the
necessary permissions and APIs are enabled in the correct project.

Langkah berikutnya

Pelajari cara menggunakan keluar antarmuka Private Service Connect untuk Ray on Vertex AI.
Pelajari cara menggunakan egress antarmuka Private Service Connect untuk pelatihan kustom.
Pelajari cara menggunakan egress antarmuka Private Service Connect untuk Agent Platform Pipelines.
Pelajari cara menggunakan egress antarmuka Private Service Connect untuk Agent Runtime