Resolver erros da API Conversational Analytics

Se você encontrar problemas ao usar a API Análise conversacional, consulte a tabela a seguir para encontrar possíveis soluções.

Erro Causa do erro Código de status HTTP Código de status gRPC Resolução
AlreadyExistsException ALREADY_EXISTS 409 Conflict 6 O recurso já existe (por exemplo, você está criando uma entrada duplicada). Use um identificador diferente ou confirme se o recurso ainda não existe antes de criá-lo.
BadRequestException INVALID_ARGUMENT 400 Bad Request 3 A entrada é inválida ou está incorreta. Valide as entradas ou os payloads antes de enviar a solicitação.
BadRequestException (escopo de pesquisa) INVALID_ARGUMENT 400 Bad Request 3 O escopo de pesquisa do BigQuery na solicitação é inválido. Para corrigir o erro, siga as orientações para a mensagem de erro que você recebe:
  • At least one of include_project_ids or include_dataset_references must be provided in search_scope.

    Especifique pelo menos um conjunto de dados ou projeto.

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

    Especifique até 100 conjuntos de dados e até 100 projetos.

  • Elements in search_scope.include_project_ids must not be blank., Elements in search_scope.include_project_ids must be valid BigQuery project IDs. ou um erro que começa com Each dataset reference in search_scope.include_dataset_references must have

    Especifique apenas o ID do projeto e o ID do conjunto de dados, sem prefixo, espaços ou aspas. Por exemplo, especifique my-project em vez de projects/my-project.

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

    Especifique o escopo da pesquisa no objeto inline_context de uma solicitação de chat sem estado, em vez de em um agente de dados.

Para mais informações, consulte Conectar-se a conjuntos de dados e projetos do BigQuery.
ForbiddenException PERMISSION_DENIED 403 Forbidden 7 Você tem autenticação, mas não tem permissão para acessar o recurso. Verifique seu papel e suas permissões de usuário. Entre em contato com um administrador, se necessário.
PermissionDenied (política da organização) PERMISSION_DENIED 403 Forbidden 7 A solicitação viola uma restrição da política da organização, como uma restrição de local ou um requisito de CMEK. Analise a mensagem de erro no corpo da resposta para identificar qual restrição foi violada. Para mais informações, consulte Resolver problemas de violações da política.
FailedPreconditionException FAILED_PRECONDITION 400 Bad Request 9 A solicitação viola o estado do sistema (por exemplo, tentar excluir uma pasta que não está vazia). Confira as condições prévias e corrija a lógica.
NotFoundException NOT_FOUND 404 Not Found 5

O recurso não foi encontrado. Verifique os IDs ou URLs dos recursos. Confirme se o recurso existe antes de tentar acessá-lo.

Consulte as Perguntas frequentes sobre a API Conversational Analytics para mais informações sobre solução de problemas.

ServiceUnavailableException UNAVAILABLE 503 Service Unavailable 14 Há um problema temporário no servidor. Aguarde e tente de novo com uma espera exponencial entre as tentativas. Se o erro persistir, envie um relatório de bug.
Connection reset by peer (durante o streaming) UNAVAILABLE 503 Service Unavailable 14

Se você usar um cliente HTTP ou REST padrão para chamar o endpoint de streaming :chat, o servidor poderá ter encontrado um erro fatal (como um tempo limite ou negação de permissão) durante o stream. Como os cabeçalhos HTTP já foram enviados, o código do erro verdadeiro é colocado em trailers HTTP/2, que os clientes REST padrão não conseguem analisar, resultando em uma falha de soquete.

Recomendamos o uso das bibliotecas de cliente gRPC oficiais do Google Cloud , como o SDK do Python, para chamar endpoints de streaming. Essas bibliotecas analisam os cabeçalhos finais e mostram a verdadeira causa do erro.

Internal error encountered (durante o streaming) INTERNAL 500 Internal Server Error 13

Se você usar um cliente HTTP ou REST padrão para chamar o endpoint de streaming :chat, o servidor poderá ter encontrado um erro fatal durante o stream. Como os cabeçalhos HTTP já foram enviados, o código do erro verdadeiro é colocado em trailers HTTP/2, que os clientes REST padrão não conseguem analisar, resultando em uma falha de soquete.

Recomendamos o uso das bibliotecas de cliente gRPC oficiais do Google Cloud , como o SDK do Python, para chamar endpoints de streaming. Essas bibliotecas analisam os cabeçalhos finais e mostram a verdadeira causa do erro.

UnauthenticatedException UNAUTHENTICATED 401 Unauthorized 16 A autenticação é necessária ou falhou. Verifique se você está usando as credenciais de login, a chave de API ou o token corretos.
UnimplementedException UNIMPLEMENTED 501 Not Implemented 12 O recurso solicitado não está disponível ou não é compatível. Evite chamar essa API ou aguarde a implementação.

Outros recursos

Para mais dicas de solução de problemas e respostas a perguntas frequentes, consulte a página Perguntas frequentes sobre a API Conversational Analytics.

Para saber como fazer perguntas eficazes à API Análise conversacional, consulte a página de documentação Fazer perguntas eficazes.