Membuat ekstensi Vertex AI

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Pratinjau — Apigee API hub

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

Topik ini menjelaskan cara membuat ekstensi Vertex AI dalam hub API.

Apa itu ekstensi Vertex AI?

Ekstensi Vertex AI memungkinkan LLM terhubung ke data dan tindakan dunia nyata melalui API. Ekstensi memproses kueri pengguna dan berkomunikasi dengan model bahasa besar (LLM) untuk menjalankan operasi atas nama aplikasi, seperti aplikasi chat.

Misalnya, Anda membuat ekstensi Vertex AI untuk API penyewaan mobil, dan ekstensi ini ditautkan ke aplikasi chat. Saat pengguna bertanya ke aplikasi tentang penyewaan mobil, AI generatif akan memahami konteks pertanyaan tersebut dan memanggil API ekstensi untuk menyewa mobil.

Untuk mengetahui informasi selengkapnya tentang ekstensi Vertex AI, lihat Ringkasan AI Generatif di Vertex AI.

Hub API menyederhanakan pembuatan ekstensi Vertex AI

Hub API menyederhanakan proses pembuatan ekstensi Vertex AI dengan menggunakan metadata hub API yang sudah ada. Data kunci yang digunakan oleh hub API untuk membuat ekstensi adalah spesifikasi API dan deployment, yang praktisnya, sudah divalidasi oleh hub API. Spesifikasi menyediakan operasi API ke ekstensi, dan deployment menyediakan endpoint server API.

Membuat ekstensi Vertex AI

Untuk membuat ekstensi Vertex AI di hub API:

Konsol

Untuk membuat ekstensi:

1. Di konsol Google Cloud, buka halaman APIs di Hub APIgee API.

   Buka hub API
2. Cari API tempat Anda ingin menambahkan ekstensi. Gunakan Filter untuk menentukan kata kunci guna memfilter daftar API. Jika perlu, gunakan Penelusuran untuk menemukan API.
3. Klik API untuk melihat halaman detailnya.
4. Klik Create Vertex Extension.
5. Tentukan detail ekstensi dalam formulir Buat Ekstensi Vertex:
   • Nama ekstensi: (Wajib diisi) Anda harus memberikan nama ekstensi.
   • Deskripsi: (Wajib) Tambahkan deskripsi ekstensi.
   • Versi: (Wajib) Pilih versi API.
   • File spesifikasi: (Wajib) Jika spesifikasi ditautkan ke versi API, spesifikasi tersebut akan otomatis diisi di kolom ini. Lihat Mengelola spesifikasi API.
     Ekstensi Vertex AI hanya mendukung file spesifikasi OpenAPI dalam format YAML. Batas ukuran file spesifikasi adalah 1 MB.
   • Deployment: (Wajib) Jika deployment ditautkan ke versi API, deployment akan otomatis diisi di kolom ini. Lihat Mengelola deployment.
     Catatan: Karena ekstensi Vertex hanya mendukung satu endpoint server per spesifikasi, kami tidak dapat mengizinkan deployment dengan beberapa endpoint server. Jika deployment memiliki beberapa endpoint, kami akan memilih yang pertama.
     Catatan: Satu-satunya konfigurasi autentikasi yang didukung untuk ekstensi Vertex adalah Tanpa autentikasi.
6. Klik Create Extension. Jika Anda menambahkan ekstensi ke versi default, ekstensi tersebut akan muncul di bagian Ekstensi pada halaman detail API. Jika menambahkan ekstensi tersebut ke versi lain, Anda harus melihat halaman detail versi untuk melihat ekstensi yang tercantum di sana.

Mencantumkan ekstensi Vertex AI

Bagian ini menjelaskan cara membuat daftar ekstensi verteks.

Konsol

Untuk melihat semua ekstensi yang terkait dengan API terdaftar di konsol:

1. Di konsol Google Cloud, buka halaman API hub.

   Buka hub API
2. Klik API.
3. Cari API yang ingin Anda periksa. Gunakan Filter untuk menentukan kata kunci guna memfilter daftar API. Jika perlu, gunakan Penelusuran untuk menemukan API.
4. Pilih API.
5. Setiap ekstensi yang ditambahkan ke versi default akan dicantumkan di bagian Ekstensi di halaman detail API. Jika ekstensi ditambahkan ke versi lain, Anda harus melihat halaman detail versi untuk melihat ekstensi yang tercantum di sana.

Dapatkan detail ekstensi Vertex AI

Bagian ini menjelaskan cara mendapatkan detail tentang ekstensi Vertex AI.

Konsol

Untuk melihat detail ekstensi Vertex AI di konsol:

1. Di konsol Google Cloud, buka halaman API hub.

   Buka hub API
2. Klik API.
3. Cari API yang ingin Anda periksa. Gunakan Filter untuk menentukan kata kunci guna memfilter daftar API. Jika perlu, gunakan Penelusuran untuk menemukan API.
4. Pilih API.
5. Setiap ekstensi yang ditambahkan ke versi default akan dicantumkan di bagian Ekstensi pada halaman detail API. Jika ekstensi ditambahkan ke versi lain, Anda harus melihat halaman detail versi untuk melihat ekstensi yang tercantum di sana. Di tabel Ekstensi Vertex, klik ekstensi untuk melihat halaman detailnya.

Menghapus ekstensi Vertex AI

Bagian ini menjelaskan cara menghapus ekstensi Vertex.

Konsol

Untuk menghapus ekstensi:

1. Di konsol Google Cloud, buka halaman API hub.

   Buka hub API
2. Klik API.
3. Cari API yang menyertakan ekstensi yang ingin Anda hapus. Gunakan Filter untuk menentukan kata kunci guna memfilter daftar API. Jika perlu, gunakan Penelusuran untuk menemukan API.
4. Pilih API.
5. Cari ekstensi yang akan dihapus. Setiap ekstensi yang ditambahkan ke versi default akan dicantumkan di bagian Ekstensi di halaman detail API. Jika ekstensi ditambahkan ke versi lain, Anda harus melihat halaman detail versi untuk melihat ekstensi yang tercantum di sana.
6. Dari menu Tindakan (sisi kanan baris yang berisi ekstensi), klik Delete.