Reasoning Engine API menyediakan runtime terkelola untuk alur kerja agen yang disesuaikan dalam aplikasi AI generatif. Anda dapat membuat aplikasi menggunakan framework orkestrasi seperti LangChain, dan men-deploy-nya dengan Reasoning Engine. Layanan ini memiliki semua manfaat keamanan, privasi, kemampuan observasi, dan skalabilitas dari integrasi Vertex AI.
Untuk mengetahui informasi konseptual selengkapnya tentang Reasoning Engine, lihat Men-deploy aplikasi.
Batasan
- Reasoning Engine API hanya mendukung framework orkestrasi Python.
- Reasoning Engine API hanya didukung di region
us-central1
.
Contoh sintaksis
Sintaksis untuk membuat dan mendaftarkan resource mesin penalaran.
Python
class SimpleAdditionApp: def query() -> str: """ ... """ return ... reasoning_engine = reasoning_engines.ReasoningEngine.create( SimpleAdditionApp(), display_name="", description="", requirements=[...], extra_packages=[...], )
Daftar parameter
Parameter | |
---|---|
display_name |
Wajib: Nama tampilan |
description |
Opsional: Deskripsi |
spec |
Wajib: Konfigurasi |
package_spec |
Wajib: Spesifikasi paket yang diberikan pengguna, seperti objek pilihan dan persyaratan paket. |
class_methods |
Opsional: Deklarasi untuk metode class objek. |
PackageSpec
PackageSpec berisi referensi ke URI Cloud Storage yang menyimpan file YAML OpenAPI.
Parameter | |
---|---|
pickle_object_gcs_uri |
Opsional: URI Cloud Storage dari objek python yang dipilih. |
dependency_files_gcs_uri |
Opsional: URI Cloud Storage file dependensi dengan ekstensi |
requirements_gcs_uri |
Opsional: URI Cloud Storage dari file |
python_version |
Opsional: Versi Python. Versi yang didukung mencakup Python |
QueryReasoningEngine
Parameter | |
---|---|
input |
Argumen di dalam |
Contoh
Men-deploy konfigurasi aplikasi dasar
Contoh berikut menggunakan aplikasi yang menambahkan dua bilangan bulat dan aplikasi jarak jauh dengan Reasoning Engine:
Python
Untuk mempelajari cara menginstal atau mengupdate Vertex AI SDK untuk Python, lihat Menginstal Vertex AI SDK untuk Python. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Python API.
Men-deploy konfigurasi aplikasi lanjutan
Ini adalah contoh lanjutan yang menggunakan rantai, template perintah, dan Gemini API LangChain:
Python
Untuk mempelajari cara menginstal atau mengupdate Vertex AI SDK untuk Python, lihat Menginstal Vertex AI SDK untuk Python. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Python API.
Mesin Penalaran Kueri
Membuat kueri mesin penalaran.
Contoh ini menggunakan class SimpleAdditionApp
dari Men-deploy contoh konfigurasi aplikasi dasar.
REST
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: Project ID Anda.
- LOCATION: Region untuk memproses permintaan. Harus berupa
us-central1
. - REASONING_ENGINE_ID: ID mesin penalaran.
- INPUT:
protobuf.struct:
Argumen di dalaminput
harus cocok dengan argumen di dalam metodedef query(self, question: str)
yang ditentukan selama Men-deploy konfigurasi aplikasi dasar.
Metode HTTP dan URL:
POST http://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID:query
Isi JSON permintaan:
{ "input": { INPUT } }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"http://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID:query"
PowerShell
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "http://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID:query" | Select-Object -Expand Content
Python
Untuk mempelajari cara menginstal atau mengupdate Vertex AI SDK untuk Python, lihat Menginstal Vertex AI SDK untuk Python. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Python API.
Membuat Daftar Mesin Penalaran
Membuat daftar mesin penalaran dalam sebuah project.
REST
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: Project ID Anda.
- PROJECT_ID: Project ID Anda.
- LOCATION: Region untuk memproses permintaan. Harus berupa
us-central1
.
Metode HTTP dan URL:
GET http://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"http://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines"
PowerShell
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "http://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines" | Select-Object -Expand Content
Python
Untuk mempelajari cara menginstal atau mengupdate Vertex AI SDK untuk Python, lihat Menginstal Vertex AI SDK untuk Python. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Python API.
Mendapatkan Mesin Penalaran
Dapatkan detail mesin penalaran.
REST
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: Project ID Anda.
- PROJECT_ID: Project ID Anda.
- LOCATION: Region untuk memproses permintaan. Harus berupa
us-central1
. - REASONING_ENGINE_ID: ID mesin penalaran.
Metode HTTP dan URL:
GET http://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"http://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID"
PowerShell
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "http://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID" | Select-Object -Expand Content
Python
Untuk mempelajari cara menginstal atau mengupdate Vertex AI SDK untuk Python, lihat Menginstal Vertex AI SDK untuk Python. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Python API.
Mesin Penalaran Penghapusan
Menghapus mesin penalaran.
REST
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: Project ID Anda.
- LOCATION: Region untuk memproses permintaan. Harus berupa
us-central1
. - REASONING_ENGINE_ID: ID mesin penalaran.
Metode HTTP dan URL:
DELETE http://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"http://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID"
PowerShell
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "http://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID" | Select-Object -Expand Content
Python
Untuk mempelajari cara menginstal atau mengupdate Vertex AI SDK untuk Python, lihat Menginstal Vertex AI SDK untuk Python. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Python API.
Langkah selanjutnya
- Pelajari lebih lanjut cara menggunakan library klien Vertex AI.