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.
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.
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 (réinitialisation de la connexion par le pair) (lors du streaming) UNAVAILABLE 503 Service Unavailable 14

Si vous utilisez un client HTTP ou REST standard pour appeler le point de terminaison de streaming :chat, le serveur peut avoir rencontré une erreur fatale (par exemple, un délai avant expiration ou un refus d'autorisation) pendant le flux. Étant donné que 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 les points de terminaison de streaming. Ces bibliothèques analysent ces en-têtes de fin et font apparaître la véritable cause de l'erreur.
Internal error encountered (erreur interne rencontrée) (lors du streaming) INTERNAL 500 Internal Server Error 13

Si vous utilisez un client HTTP ou REST standard pour appeler le point de terminaison de streaming :chat, le serveur peut avoir rencontré une erreur fatale pendant le flux. Étant donné que 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 les points de terminaison de streaming. Ces bibliothèques analysent ces en-têtes de fin et font apparaître 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.