Risolvere gli errori dell'API Conversational Analytics

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:
  • At least one of include_project_ids or include_dataset_references must be provided in search_scope.

    Specifica almeno un set di dati o un progetto.

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

    Specifica fino a 100 set di dati e fino a 100 progetti.

  • Elements in search_scope.include_project_ids must not be blank., Elements in search_scope.include_project_ids must be valid BigQuery project IDs. o un errore che inizia con Each dataset reference in search_scope.include_dataset_references must have

    Specifica solo l'ID progetto e l'ID set di dati, senza prefisso, spazi o virgolette. Ad esempio, specifica my-project invece di projects/my-project.

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

    Specifica l'ambito di ricerca nell'oggetto inline_context di una richiesta di chat stateless anziché in un agente per i dati.

Per saperne di più, consulta Connettiti a set di dati e progetti BigQuery.
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 :chat di streaming, il server potrebbe aver riscontrato un errore irreversibile (ad esempio un timeout o un rifiuto dell'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 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 :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 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.