Memecahkan masalah error Conversational Analytics API

Jika Anda mengalami masalah saat menggunakan Conversational Analytics API, lihat tabel berikut untuk mengetahui solusi yang mungkin.

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 lain atau pastikan 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.
BadRequestException (cakupan penelusuran) INVALID_ARGUMENT 400 Bad Request 3 Cakupan penelusuran BigQuery dalam permintaan tidak valid. Untuk memperbaiki error, ikuti panduan untuk pesan error yang Anda terima:
  • At least one of include_project_ids or include_dataset_references must be provided in search_scope.

    Tentukan setidaknya satu set data atau project.

  • search_scope.include_dataset_references must not contain more than 100 elements. atau search_scope.include_project_ids must not contain more than 100 elements.

    Tentukan hingga 100 set data dan hingga 100 project.

  • Elements in search_scope.include_project_ids must not be blank., Elements in search_scope.include_project_ids must be valid BigQuery project IDs., atau error yang dimulai dengan Each dataset reference in search_scope.include_dataset_references must have

    Tentukan hanya project ID dan ID set data, tanpa awalan, spasi, atau tanda petik. Misalnya, tentukan my-project, bukan projects/my-project.

  • Search scope is not supported in DataAgent. It is only supported for standalone conversations.

    Tentukan cakupan penelusuran di objek inline_context dari permintaan chat stateless, bukan di agen data.

Untuk mengetahui informasi selengkapnya, lihat Menghubungkan ke set data dan project BigQuery.
ForbiddenException PERMISSION_DENIED 403 Forbidden 7 Anda telah diautentikasi, tetapi tidak diizinkan untuk mengakses resource. Periksa peran dan izin pengguna Anda. Hubungi administrator jika diperlukan.
PermissionDenied (Kebijakan organisasi) PERMISSION_DENIED 403 Forbidden 7 Permintaan melanggar batasan kebijakan organisasi, seperti pembatasan lokasi atau persyaratan CMEK. Tinjau pesan error dalam isi respons untuk mengidentifikasi batasan yang dilanggar. Untuk mengetahui informasi selengkapnya, lihat Memecahkan masalah pelanggaran kebijakan.
FailedPreconditionException FAILED_PRECONDITION 400 Bad Request 9 Permintaan melanggar status sistem (misalnya, mencoba menghapus folder yang tidak kosong). Periksa prasyarat dan perbaiki logikanya.
NotFoundException NOT_FOUND 404 Not Found 5

Resource tidak ditemukan. Verifikasi ID atau URL resource. Pastikan resource ada sebelum mencoba mengaksesnya.

Lihat Pertanyaan umum (FAQ) 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. 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 yang sebenarnya ditempatkan di trailer HTTP/2, yang tidak dapat diurai 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 mengurai header tambahan ini dan menampilkan penyebab error yang sebenarnya.

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 yang sebenarnya ditempatkan di trailer HTTP/2, yang tidak dapat diurai 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 mengurai header tambahan ini dan menampilkan penyebab error yang sebenarnya.

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 implementasinya.

Referensi lainnya

Untuk mendapatkan 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 Mengajukan pertanyaan yang efektif.