Memecahkan masalah error Conversational Analytics API

Pratinjau

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

Jika Anda mengalami masalah saat menggunakan Conversational Analytics API, lihat tabel berikut untuk mengetahui potensi solusinya.

Catatan: Untuk memberikan masukan atau meminta dukungan terkait fitur ini, kirim email ke [e-mail].

Error	Penyebab error	Kode status HTTP	Kode status gRPC	Resolusi
AlreadyExistsException	ALREADY_EXISTS	409 Conflict	6	Resource sudah ada (misalnya, Anda membuat entri duplikat). Gunakan ID yang berbeda atau konfirmasi bahwa resource belum ada sebelum membuatnya.
BadRequestException	INVALID_ARGUMENT	400 Bad Request	3	Input tidak valid atau salah format. Validasi input atau payload sebelum mengirim permintaan.
ForbiddenException	PERMISSION_DENIED	403 Forbidden	7	Anda telah diautentikasi, tetapi Anda tidak diizinkan untuk mengakses resource. Periksa peran dan izin pengguna Anda. Hubungi admin jika diperlukan.
FailedPreconditionException	FAILED_PRECONDITION	400 Bad Request	9	Permintaan melanggar status sistem (misalnya, mencoba menghapus folder yang tidak kosong). Periksa prasyarat dan perbaiki logika.
NotFoundException	NOT_FOUND	404 Not Found	5	Resource tidak ditemukan. Verifikasi ID atau URL resource. Pastikan resource ada sebelum mencoba mengaksesnya. Lihat Pertanyaan umum tentang Conversational Analytics API untuk mengetahui informasi pemecahan masalah selengkapnya.
ServiceUnavailableException	UNAVAILABLE	503 Service Unavailable	14	Terjadi masalah server sementara. Tunggu dan coba lagi dengan backoff eksponensial di antara upaya percobaan ulang. Jika error berlanjut, ajukan laporan bug.
Connection reset by peer (selama streaming)	UNAVAILABLE	503 Service Unavailable	14	Jika Anda menggunakan klien HTTP atau REST standar untuk memanggil endpoint :chat streaming, server mungkin mengalami error fatal (seperti waktu tunggu habis atau penolakan izin) selama streaming. Karena header HTTP sudah dikirim, kode error sebenarnya ditempatkan di trailer HTTP/2, yang tidak dapat diuraikan oleh klien REST standar, sehingga menyebabkan error soket. Sebaiknya gunakan library klien gRPC Google Cloud resmi, seperti Python SDK, untuk memanggil endpoint streaming. Library ini mem-parsing header berikutnya dan menampilkan penyebab sebenarnya dari error.
Internal error encountered (selama streaming)	INTERNAL	500 Internal Server Error	13	Jika Anda menggunakan klien HTTP atau REST standar untuk memanggil endpoint :chat streaming, server mungkin mengalami error fatal selama streaming. Karena header HTTP sudah dikirim, kode error sebenarnya ditempatkan di trailer HTTP/2, yang tidak dapat diuraikan oleh klien REST standar, sehingga menyebabkan error soket. Sebaiknya gunakan library klien gRPC Google Cloud resmi, seperti Python SDK, untuk memanggil endpoint streaming. Library ini mem-parsing header berikutnya dan menampilkan penyebab sebenarnya dari error.
UnauthenticatedException	UNAUTHENTICATED	401 Unauthorized	16	Autentikasi diperlukan, atau autentikasi gagal. Pastikan Anda menggunakan kredensial login, kunci API, atau token yang benar.
UnimplementedException	UNIMPLEMENTED	501 Not Implemented	12	Fitur yang diminta tidak tersedia atau tidak didukung. Hindari memanggil API ini, atau tunggu hingga penerapan.

Referensi lainnya

Untuk tips pemecahan masalah tambahan dan jawaban atas pertanyaan umum (FAQ), lihat halaman Pertanyaan umum (FAQ) tentang Conversational Analytics API.

Untuk mendapatkan panduan tentang cara mengajukan pertanyaan yang efektif ke Conversational Analytics API, lihat halaman dokumentasi Ajukan pertanyaan yang efektif.