Se riscontri problemi durante l'utilizzo dell'API Analisi conversazionale, consulta la tabella seguente per trovare potenziali soluzioni.
| Errore | Causa dell'errore | Codice di stato HTTP | Codice di stato gRPC | Risoluzione |
AlreadyExistsException
|
ALREADY_EXISTS
|
409 Conflict
|
6 | La risorsa esiste già (ad esempio, stai creando una voce duplicata). Utilizza un identificatore diverso o verifica che la risorsa non esista già prima di crearla. |
BadRequestException
|
INVALID_ARGUMENT
|
400 Bad Request
|
3 | L'input non è valido o è in un formato non corretto. Convalida gli input o i payload prima di inviare la richiesta. |
BadRequestException (ambito di ricerca) |
INVALID_ARGUMENT |
400 Bad Request |
3 |
L'ambito di ricerca BigQuery nella richiesta non è valido. Per correggere l'errore, segui le indicazioni per il messaggio di errore che ricevi:
|
ForbiddenException
|
PERMISSION_DENIED
|
403 Forbidden
|
7 | L'autenticazione è stata eseguita, ma non hai l'autorizzazione per accedere alla risorsa. Controlla il tuo ruolo utente e le tue autorizzazioni. Se necessario, contatta un amministratore. |
PermissionDenied (policy dell'organizzazione) |
PERMISSION_DENIED |
403 Forbidden |
7 | La richiesta viola un vincolo della policy dell'organizzazione, ad esempio una limitazione della località o un requisito CMEK. Esamina il messaggio di errore nel corpo della risposta per identificare il vincolo violato. Per saperne di più, consulta Risolvi i problemi relativi alle violazioni delle norme. |
FailedPreconditionException
|
FAILED_PRECONDITION
|
400 Bad Request
|
9 | La richiesta viola lo stato del sistema (ad esempio, il tentativo di eliminare una cartella non vuota). Controlla le precondizioni e correggi la logica. |
NotFoundException
|
NOT_FOUND
|
404 Not Found
|
5 | Risorsa non trovata. Verifica gli ID o gli URL delle risorse. Assicurati che la risorsa esista prima di tentare di accedervi. Per ulteriori informazioni sulla risoluzione dei problemi, consulta Domande frequenti sull'API Analisi conversazionale. |
ServiceUnavailableException
|
UNAVAILABLE
|
503 Service Unavailable
|
14 | Si è verificato un problema temporaneo con il server. Attendi e riprova con un backoff esponenziale tra un tentativo e l'altro. Se l'errore persiste, invia una segnalazione di bug. |
Connection reset by peer (durante lo streaming)
|
UNAVAILABLE
|
503 Service Unavailable
|
14 |
Se utilizzi un client HTTP o REST standard per chiamare l'endpoint Ti consigliamo di utilizzare le librerie client gRPC Google Cloud ufficiali, come l'SDK Python, per chiamare gli endpoint di streaming. Queste librerie analizzano le intestazioni finali e mostrano la vera causa dell'errore. |
Internal error encountered (durante lo streaming)
|
INTERNAL
|
500 Internal Server Error
|
13 |
Se utilizzi un client HTTP o REST standard per chiamare l'endpoint Ti consigliamo di utilizzare le librerie client gRPC Google Cloud ufficiali, come l'SDK Python, per chiamare gli endpoint di streaming. Queste librerie analizzano le intestazioni finali e mostrano la vera causa dell'errore. |
UnauthenticatedException
|
UNAUTHENTICATED
|
401 Unauthorized
|
16 | È richiesta l'autenticazione o l'autenticazione non è riuscita. Assicurati di utilizzare le credenziali di accesso, la chiave API o il token corretti. |
UnimplementedException
|
UNIMPLEMENTED
|
501 Not Implemented
|
12 | La funzionalità richiesta non è disponibile o non è supportata. Evita di chiamare questa API o attendi l'implementazione. |
Risorse aggiuntive
Per ulteriori suggerimenti per la risoluzione dei problemi e risposte alle domande frequenti, consulta la pagina Domande frequenti sull'API Analisi conversazionale.
Per indicazioni su come porre domande efficaci all'API Analisi conversazionale, consulta la pagina della documentazione Fai domande efficaci.