Platform For AI:EAS client SDK

Cas d'utilisation

Le cas d'utilisation typique des SDK officiels EAS est la connexion directe VPC. Dans ce scénario, le SDK vous évite d'implémenter vous-même la découverte de service et l'équilibrage de charge.

Pour les autres méthodes d'appel, telles que via une passerelle partagée ou une passerelle dédiée, un client HTTP standard suffit généralement ; l'utilisation du SDK n'est pas requise.

Pour obtenir des conseils sur le choix d'une méthode d'appel, consultez la rubrique Appel de service.

Fonctionnement

Le SDK prend en charge deux types de points de terminaison : l'accès par passerelle et la connexion directe VPC. Ces deux types diffèrent par le routage des requêtes, mais suivent le même processus d'appel, qui comprend les trois étapes suivantes :

1. Initialisez le client : Créez un objet PredictClient et définissez le point de terminaison, le nom du service et le jeton. Vous pouvez obtenir le jeton depuis la page des détails du service dans la console EAS. Appelez la méthode init() pour terminer l'initialisation.

2. Construisez une requête : Créez un objet de requête, tel que StringRequest, TFRequest ou TorchRequest, en fonction des formats d'entrée et de sortie du service. Le type de requête doit correspondre à celui attendu par le service. Pour les services déployés avec un processeur, consultez la rubrique Déploiement de processeur afin de connaître le type de requête correspondant à chaque processeur.

3. Appelez le service : Appelez la méthode predict() pour envoyer la requête et recevoir la réponse. Le SDK gère automatiquement la signature du jeton, les nouvelles tentatives en cas d'échec (cinq fois par défaut) et la désérialisation de la réponse, sans aucune intervention de votre part.

En plus des appels d'inférence synchrones décrits ci-dessus, le SDK propose également une méthode d'appel basée sur un service de file d'attente :

1. Utilisez un objet QueueClient pour pousser les requêtes de manière asynchrone vers une file d'attente d'entrée. Le service consomme (extrait) les requêtes et écrit les résultats dans une file d'attente de sortie.

2. Le client reçoit les résultats en s'abonnant (surveillance) à la file d'attente de sortie.

Cette méthode convient à l'inférence asynchrone et aux tâches de longue durée. Pour des instructions détaillées, consultez les exemples fournis dans les guides spécifiques à chaque langage du SDK.

Référence du SDK

Sélectionnez votre langage de programmation pour trouver les instructions d'installation, la référence de l'API et des exemples de code :

• Guide du SDK Java

• Guide du SDK Python

• Guide du SDK Golang

Dépannage des appels

Si un appel SDK échoue, effectuez un dépannage couche par couche dans l'ordre suivant : client → réseau → côté serveur. La classification des problèmes courants et les orientations de dépannage correspondantes sont les suivantes :

• Authentification (401 / 403) : Vérifiez si le jeton est transmis correctement, s'il correspond au service cible ou s'il a été réinitialisé dans la console.

• Routage (404) : Vérifiez que le point de terminaison et le nom du service correspondent aux valeurs indiquées sur la page des détails du service dans la console EAS. Si vous utilisez une connexion directe VPC, confirmez que la découverte de service a bien récupéré la liste des instances.

• Connectivité (connexion refusée / délai d'attente dépassé / échec de résolution DNS) : Vérifiez que le client et le serveur se trouvent dans le même VPC, que les règles du groupe de sécurité autorisent le trafic et que le domaine du point de terminaison est résolvable.

• Côté serveur (5xx / réponse vide / format de réponse non valide) : Consultez les journaux du service pour identifier la cause racine de ces problèmes.

Pour obtenir la liste complète des codes d'état du service, des messages d'erreur typiques et des solutions recommandées, consultez la rubrique Annexe : Codes d'état du service et erreurs courantes.