Soluciona problemas relacionados con errores de la API de Conversational Analytics

Si tienes problemas cuando usas la API de Conversational Analytics, consulta la siguiente tabla para conocer las posibles soluciones.

Error Causa del error Código de estado HTTP Código de estado de gRPC Solución
AlreadyExistsException ALREADY_EXISTS 409 Conflict 6 El recurso ya existe (por ejemplo, estás creando una entrada duplicada). Usa un identificador diferente o confirma que el recurso no exista antes de crearlo.
BadRequestException INVALID_ARGUMENT 400 Bad Request 3 La entrada no es válida o tiene un formato incorrecto. Valida las entradas o las cargas útiles antes de enviar la solicitud.
BadRequestException (alcance de la búsqueda) INVALID_ARGUMENT 400 Bad Request 3 El permiso de búsqueda de BigQuery en la solicitud no es válido. Para corregir el error, sigue las instrucciones del mensaje de error que recibes:
  • At least one of include_project_ids or include_dataset_references must be provided in search_scope.

    Especifica al menos un conjunto de datos o proyecto.

  • 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.

    Especifica hasta 100 conjuntos de datos y hasta 100 proyectos.

  • 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 error que comience con Each dataset reference in search_scope.include_dataset_references must have

    Especifica solo el ID del proyecto y el ID del conjunto de datos, sin prefijo, espacios ni comillas. Por ejemplo, especifica my-project en lugar de projects/my-project.

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

    Especifica el permiso de búsqueda en el objeto inline_context de una solicitud de chat sin estado en lugar de en un agente de datos.

Para obtener más información, consulta Conéctate a conjuntos de datos y proyectos de BigQuery.
ForbiddenException PERMISSION_DENIED 403 Forbidden 7 Estás autenticado, pero no tienes permiso para acceder al recurso. Verifica tu rol y tus permisos de usuario. Si es necesario, comunícate con un administrador.
PermissionDenied (política de la organización) PERMISSION_DENIED 403 Forbidden 7 La solicitud incumple una restricción de la política de la organización, como una restricción de ubicación o un requisito de CMEK. Revisa el mensaje de error en el cuerpo de la respuesta para identificar qué restricción se incumplió. Para obtener más información, consulta Cómo solucionar problemas relacionados con incumplimientos de políticas.
FailedPreconditionException FAILED_PRECONDITION 400 Bad Request 9 La solicitud infringe el estado del sistema (por ejemplo, intentar borrar una carpeta que no está vacía). Verifica las condiciones previas y corrige la lógica.
NotFoundException NOT_FOUND 404 Not Found 5

No se encontró el recurso. Verifica los IDs o las URLs de los recursos. Asegúrate de que el recurso exista antes de intentar acceder a él.

Consulta las Preguntas frecuentes sobre la API de Conversational Analytics para obtener más información sobre la solución de problemas.

ServiceUnavailableException UNAVAILABLE 503 Service Unavailable 14 Hay un problema temporal con el servidor. Espera y vuelve a intentarlo con una retirada exponencial entre los intentos. Si el error persiste, envía un informe de errores.
Connection reset by peer (durante la transmisión) UNAVAILABLE 503 Service Unavailable 14

Si usas un cliente HTTP o REST estándar para llamar al extremo :chat de transmisión, es posible que el servidor haya encontrado un error fatal (como un tiempo de espera o una denegación de permiso) durante la transmisión. Debido a que los encabezados HTTP ya se enviaron, el código de error verdadero se coloca en los finales de HTTP/2, que los clientes REST estándar no pueden analizar, lo que genera una falla de socket.

Te recomendamos que uses las bibliotecas cliente de gRPC oficiales de Google Cloud , como el SDK de Python, para llamar a los extremos de transmisión. Estas bibliotecas analizan estos encabezados finales y muestran la verdadera causa del error.

Internal error encountered (durante la transmisión) INTERNAL 500 Internal Server Error 13

Si usas un cliente HTTP o REST estándar para llamar al extremo :chat de transmisión, es posible que el servidor haya encontrado un error fatal durante la transmisión. Debido a que los encabezados HTTP ya se enviaron, el código de error verdadero se coloca en los finales de HTTP/2, que los clientes de REST estándar no pueden analizar, lo que genera una falla de socket.

Te recomendamos que uses las bibliotecas cliente de gRPC oficiales de Google Cloud , como el SDK de Python, para llamar a los extremos de transmisión. Estas bibliotecas analizan estos encabezados finales y muestran la verdadera causa del error.

UnauthenticatedException UNAUTHENTICATED 401 Unauthorized 16 Se requiere autenticación o se produjo un error en la autenticación. Asegúrate de usar las credenciales de acceso, la clave de API o el token correctos.
UnimplementedException UNIMPLEMENTED 501 Not Implemented 12 La función solicitada no está disponible o no se admite. Evita llamar a esta API o espera a que se implemente.

Recursos adicionales

Para obtener más sugerencias de solución de problemas y respuestas a preguntas frecuentes, consulta la página Preguntas frecuentes sobre la API de Conversational Analytics.

Para obtener orientación sobre cómo hacer preguntas eficaces a la API de Conversational Analytics, consulta la página de documentación Haz preguntas eficaces.