Dokumen ini menjelaskan cara mengatasi error yang mungkin Anda alami saat menggunakan aplikasi.
Skema operasi kosong
Jika aplikasi Anda menampilkan daftar kosong dari .operation_schemas()
, hal ini mungkin
disebabkan oleh salah satu masalah berikut:
Gagal membuat skema selama pembuatan aplikasi
Masalah:
Saat men-deploy aplikasi, Anda akan menerima peringatan yang mirip dengan peringatan berikut:
WARNING:vertexai.reasoning_engines._reasoning_engines:failed to generate schema: issubclass() arg 1 must be a class
Kemungkinan penyebab:
Peringatan ini mungkin terjadi jika Anda men-deploy aplikasi menggunakan template
LangchainAgent
bawaan pada versi google-cloud-aiplatform
yang
lebih lama dari 1.49.0
. Untuk memeriksa versi yang Anda gunakan, jalankan perintah
berikut di terminal:
pip show google-cloud-aiplatform
Solusi yang disarankan:
Jalankan perintah berikut di terminal Anda untuk mengupdate
paket google-cloud-aiplatform
:
pip install google-cloud-aiplatform --upgrade
Setelah Anda mengupdate paket google-cloud-aiplatform
, jalankan perintah
berikut untuk memverifikasi bahwa versinya adalah 1.49.0
atau yang lebih baru:
pip show google-cloud-aiplatform
Jika Anda berada dalam instance notebook (misalnya, Jupyter atau Colab atau Workbench), Anda mungkin perlu memulai ulang runtime untuk menggunakan paket yang telah diupdate. Setelah memastikan bahwa versi google-cloud-aiplatform
adalah 1.49.0
atau yang lebih baru, coba deploy aplikasi Anda lagi.
PermissionDenied
error saat membuat kueri aplikasi Anda
Kueri Anda mungkin gagal jika Anda tidak memiliki izin yang diperlukan.
Izin LLM
Masalah:
Anda mungkin menerima error PermissionDenied
yang mirip dengan yang berikut ini:
PermissionDenied: 403 Permission 'aiplatform.endpoints.predict' denied on resource
'//aiplatform.googleapis.com/projects/{PROJECT_ID}/locations/{LOCATION}/publishers/
google/models/{MODEL}' (or it may not exist). [reason: "IAM_PERMISSION_DENIED"
domain: "aiplatform.googleapis.com"
metadata {
key: "permission"
value: "aiplatform.endpoints.predict"
}
metadata {
key: "resource"
value: "projects/{PROJECT_ID}/locations/{LOCATION}/publishers/google/models/{MODEL}"
}
]
Kemungkinan penyebab:
Akun Layanan Anda mungkin tidak memiliki izin yang sesuai untuk mengkueri model bahasa besar (LLM).
Solusi yang disarankan:
Pastikan akun layanan Anda memiliki izin Identity and Access Management (IAM) yang tepat dan tercantum dalam pesan error. Contoh izin IAM
yang mungkin tidak Anda miliki adalah aiplatform.endpoints.predict
. Lihat Menyiapkan izin agen layanan
untuk mengetahui informasi selengkapnya.
Permintaan Tidak Valid
Jika Anda mengalami masalah dengan permintaan yang tidak valid saat membuat kueri pada aplikasi, hal ini mungkin disebabkan oleh salah satu masalah yang dijelaskan di bagian ini.
FailedPrecondition
Masalah:
Anda mungkin menerima error FailedPrecondition
yang mirip dengan yang berikut ini:
FailedPrecondition: 400 Reasoning Engine Execution failed. Error Details:
{"detail":"Invalid request: `{'query': ...}`"}
Kemungkinan penyebab:
Hal ini mungkin terjadi jika Anda memanggil agent.query(query_str)
, bukan
agent.query(input=query_str)
(yaitu, menentukan input ke kueri sebagai
argumen posisi, bukan argumen kata kunci).
Solusi yang disarankan:
Saat membuat kueri untuk instance mesin penalaran yang telah di-deploy, tentukan semua input sebagai argumen kata kunci (misalnya, agent.query(input=query_str)
).