Résoudre les problèmes liés à l'API Conversational Analytics

Si vous rencontrez des problèmes lors de l'utilisation de l'API Conversational Analytics, consultez le tableau suivant pour trouver des solutions potentielles.

Erreur Cause de l'erreur Code d'état HTTP Code d'état gRPC Solution
AlreadyExistsException ALREADY_EXISTS 409 Conflict 6 La ressource existe déjà (par exemple, vous créez une entrée en double). Utilisez un autre identifiant ou vérifiez que la ressource n'existe pas déjà avant de la créer.
BadRequestException INVALID_ARGUMENT 400 Bad Request 3 L'entrée n'est pas valide ou son format n'est pas correct. Vérifiez les entrées ou les charges utiles avant d'envoyer la requête.
BadRequestException (champ d'application de la recherche) INVALID_ARGUMENT 400 Bad Request 3 Le champ d'application de la recherche BigQuery dans la requête n'est pas valide. Pour corriger l'erreur, suivez les instructions correspondant au message d'erreur que vous recevez :
  • At least one of include_project_ids or include_dataset_references must be provided in search_scope.

    Spécifiez au moins un ensemble de données ou un projet.

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

    Spécifiez jusqu'à 100 ensembles de données et jusqu'à 100 projets.

  • 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 une erreur commençant par Each dataset reference in search_scope.include_dataset_references must have

    Spécifiez uniquement l'ID du projet et l'ID de l'ensemble de données, sans préfixe, espaces ni guillemets. Par exemple, spécifiez my-project au lieu de projects/my-project.

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

    Spécifiez le champ d'application de la recherche dans l'objet inline_context d'une requête de chat sans état au lieu d'un agent de données.

Pour en savoir plus, consultez Se connecter à des ensembles de données et des projets BigQuery.
ForbiddenException PERMISSION_DENIED 403 Forbidden 7 Vous êtes authentifié, mais vous n'êtes pas autorisé à accéder à la ressource. Vérifiez votre rôle utilisateur et vos autorisations. Contactez un administrateur si nécessaire.
PermissionDenied (règle d'administration) PERMISSION_DENIED 403 Forbidden 7 La requête ne respecte pas une contrainte de règle d'administration, telle qu'une restriction d'emplacement ou une exigence CMEK. Examinez le message d'erreur dans le corps de la réponse pour identifier la contrainte qui a été enfreinte. Pour en savoir plus, consultez Résoudre les problèmes de non-respect des règles.
FailedPreconditionException FAILED_PRECONDITION 400 Bad Request 9 La requête enfreint l'état du système (par exemple, en tentant de supprimer un dossier non vide). Vérifiez les conditions préalables et corrigez la logique.
NotFoundException NOT_FOUND 404 Not Found 5

La ressource est introuvable. Vérifiez les ID ou les URL de la ressource. Assurez-vous que la ressource existe avant d'essayer d'y accéder.

Pour en savoir plus sur le dépannage, consultez les Questions fréquentes sur l'API Conversational Analytics.

ServiceUnavailableException UNAVAILABLE 503 Service Unavailable 14 Un problème temporaire est survenu sur le serveur. Attendez et réessayez avec un intervalle exponentiel entre les tentatives. Si l'erreur persiste, envoyez un rapport de bug.
Connection reset by peer (pendant le streaming) UNAVAILABLE 503 Service Unavailable 14

Si vous utilisez un client HTTP ou REST standard pour appeler le point de terminaison :chat de streaming, il est possible que le serveur ait rencontré une erreur fatale (par exemple, un délai avant expiration ou un refus d'autorisation) pendant le streaming. Comme les en-têtes HTTP sont déjà envoyés, le véritable code d'erreur est placé dans les trailers HTTP/2, que les clients REST standards ne peuvent pas analyser, ce qui entraîne un plantage du socket.

Nous vous recommandons d'utiliser les bibliothèques clientes gRPC officielles Google Cloud , telles que le SDK Python, pour appeler des points de terminaison de streaming. Ces bibliothèques analysent ces en-têtes de fin et affichent la véritable cause de l'erreur.

Internal error encountered (pendant le streaming) INTERNAL 500 Internal Server Error 13

Si vous utilisez un client HTTP ou REST standard pour appeler le point de terminaison :chat de streaming, il est possible que le serveur ait rencontré une erreur fatale pendant le streaming. Comme les en-têtes HTTP sont déjà envoyés, le véritable code d'erreur est placé dans les trailers HTTP/2, que les clients REST standards ne peuvent pas analyser, ce qui entraîne un plantage du socket.

Nous vous recommandons d'utiliser les bibliothèques clientes gRPC officielles Google Cloud , telles que le SDK Python, pour appeler des points de terminaison de streaming. Ces bibliothèques analysent ces en-têtes de fin et affichent la véritable cause de l'erreur.

UnauthenticatedException UNAUTHENTICATED 401 Unauthorized 16 L'authentification est requise ou a échoué. Assurez-vous d'utiliser les identifiants de connexion, la clé API ou le jeton appropriés.
UnimplementedException UNIMPLEMENTED 501 Not Implemented 12 La fonctionnalité demandée n'est pas disponible ou compatible. Évitez d'appeler cette API ou attendez l'implémentation.

Autres ressources

Pour obtenir d'autres conseils de dépannage et des réponses aux questions fréquentes, consultez la page Questions fréquentes sur l'API Conversational Analytics.

Pour savoir comment poser des questions efficaces à l'API Conversational Analytics, consultez la page de documentation Poser des questions efficaces.