Risolvere gli errori dell'API Conversational Analytics

Se riscontri problemi durante l'utilizzo dell'API Analisi conversazionale, consulta la tabella seguente per le possibili 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 è malformato. Convalida gli input o i payload prima di inviare la richiesta.
ForbiddenException PERMISSION_DENIED 403 Forbidden 7 Hai eseguito l'autenticazione, ma non hai l'autorizzazione per accedere alla risorsa. Controlla il ruolo utente e le autorizzazioni. Se necessario, contatta un amministratore.
FailedPreconditionException FAILED_PRECONDITION 400 Bad Request 9 La richiesta viola lo stato del sistema (ad esempio, stai tentando di eliminare una cartella non vuota). Controlla le precondizioni e correggi la logica.
NotFoundException NOT_FOUND 404 Not Found 5

La risorsa non è stata trovata. Verifica gli ID o gli URL delle risorse. Assicurati che la risorsa esista prima di provare ad accedervi.

Per ulteriori informazioni sulla risoluzione dei problemi, consulta la pagina Domande frequenti sull'API Analisi conversazionale.
ServiceUnavailableException UNAVAILABLE 503 Service Unavailable 14 Si è verificato un problema temporaneo del server. Attendi e riprova con un backoff esponenziale tra i tentativi. 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 :chat di streaming, il server potrebbe aver riscontrato un errore irreversibile (ad esempio un timeout o un rifiuto di autorizzazione) durante lo stream. Poiché le intestazioni HTTP sono già state inviate, il codice di errore effettivo viene inserito nei trailer HTTP/2, che i client REST standard non possono analizzare, causando un arresto anomalo del socket.

Ti consigliamo di utilizzare le librerie client gRPC ufficiali Google Cloud , come l'SDK Python, per chiamare gli endpoint di streaming. Queste librerie analizzano le intestazioni finali e mostrano la causa effettiva 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 :chat di streaming, il server potrebbe aver riscontrato un errore irreversibile durante lo stream. Poiché le intestazioni HTTP sono già state inviate, il codice di errore effettivo viene inserito nei trailer HTTP/2, che i client REST standard non possono analizzare, causando un arresto anomalo del socket.

Ti consigliamo di utilizzare le librerie client gRPC ufficiali Google Cloud , come l'SDK Python, per chiamare gli endpoint di streaming. Queste librerie analizzano le intestazioni finali e mostrano la causa effettiva 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 Porre domande efficaci.