Risolvere gli errori dell'API Conversational Analytics

Se riscontri problemi durante l'utilizzo dell'API Conversational Analytics, consulta la seguente tabella per 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.
ForbiddenException PERMISSION_DENIED 403 Forbidden 7 Sei autenticato, ma non hai l'autorizzazione per accedere alla risorsa. Controlla il tuo ruolo e le tue autorizzazioni utente. Se necessario, contatta un amministratore.
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

La risorsa non è stata 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 le Domande frequenti sull'API Conversational Analytics.
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, segnala un 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 di streaming :chat, 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 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 di streaming :chat, 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 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 Conversational Analytics.

Per indicazioni su come porre domande efficaci all'API Conversational Analytics, consulta la pagina di documentazione Porre domande efficaci.