Membuat ekstensi Vertex AI

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

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

Apa yang dimaksud dengan 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 rental mobil, dan ekstensi ini ditautkan ke aplikasi chat. Saat pengguna bertanya kepada aplikasi tentang menyewa mobil, AI generatif akan memahami konteks pertanyaan dan memanggil API ekstensi untuk menyewa mobil.

Gambar 1. Ekstensi Vertex AI yang terhubung ke aplikasi chat layanan pelanggan.

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

API hub menyederhanakan pembuatan ekstensi Vertex AI

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

Membuat ekstensi Vertex AI

Untuk membuat ekstensi Vertex AI di API Hub:

Konsol

Untuk membuat ekstensi:

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

   Buka hub API
2. Cari API tempat Anda ingin menambahkan ekstensi. Gunakan Filter untuk menentukan kata kunci guna memfilter daftar API. Jika perlu, gunakan Telusuri untuk menemukan API.
3. Klik API untuk melihat halaman detailnya.
4. Klik Create Vertex Extension.
5. Tentukan detail ekstensi di formulir Create a Vertex Extension:
   • Nama ekstensi: (Wajib) Anda harus memberikan nama ekstensi.
   • Deskripsi: (Wajib) Tambahkan deskripsi ekstensi.
   • Version: (Wajib) Pilih versi API.
   • File spesifikasi: (Wajib) Jika ditautkan ke versi API, spesifikasi 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 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 berisi beberapa endpoint, kita akan memilih endpoint pertama.
     Catatan: Satu-satunya konfigurasi autentikasi yang didukung untuk ekstensi Vertex adalah Tidak ada autentikasi.
6. Klik Buat Ekstensi. Jika Anda menambahkan ekstensi ke versi default, ekstensi tersebut akan muncul di bagian Ekstensi pada halaman detail API. Jika menambahkan ekstensi ke versi lain, Anda harus melihat halaman detail versi untuk melihat ekstensi yang tercantum di sana.

Mencantumkan ekstensi Vertex AI

Bagian ini menjelaskan cara mencantumkan ekstensi vertex.

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. Temukan API yang ingin Anda periksa. Gunakan Filter untuk menentukan kata kunci guna memfilter daftar API. Jika perlu, gunakan Telusuri untuk menemukan API.
4. Pilih API.
5. Setiap ekstensi yang ditambahkan ke versi default akan tercantum 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.

Mendapatkan 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 Telusuri untuk menemukan API.
4. Pilih API.
5. Semua ekstensi yang ditambahkan ke versi default tercantum 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. Di tabel Vertex extensions, 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. Temukan API yang menyertakan ekstensi yang ingin Anda hapus. Gunakan Filter untuk menentukan kata kunci guna memfilter daftar API. Jika perlu, gunakan Telusuri untuk menemukan API.
4. Pilih API.
5. Cari ekstensi yang akan dihapus. Setiap ekstensi yang ditambahkan ke versi default akan tercantum 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.
6. Dari menu Tindakan (sisi kanan baris yang berisi ekstensi), klik Hapus.