Démarrage SDK
L'écran Démarrage SDK vous permet de copier la ligne d'installation et un démarrage rapide prêt à l'emploi de chaque SDK de la plateforme, avec l'adresse de votre Control Plane déjà renseignée. Chemin dans le portail : /developer/sdk. Il sert aux développeurs qui commencent une intégration.
Ce que montre l'écran
- Un onglet par SDK : Python, TypeScript, Temps réel, Java, Go et CLI. Python est ouvert par défaut.
- Dans chaque onglet :
- Installation : la commande d'installation et son bouton de copie.
- Démarrage rapide : un éditeur de code en lecture seule avec l'extrait, coloré selon son langage, et une indication : complétion via la passerelle avec effort et classification (Python), complétion puis streaming avec server sent events (TypeScript), session créée par le serveur et rejointe par le navigateur avec son jeton à courte durée de vie (Temps réel), appel de chat synchrone (Java), appel de chat avec contexte (Go), commandes courantes de l'outil en ligne de commande (CLI).
Les extraits reprennent l'adresse de l'API configurée dans le portail ; ils ne contiennent jamais de clé.
Actions
| Bouton ou action | Ce qu'il fait | Appel API | Rôles |
|---|---|---|---|
| Onglet d'un SDK | Affiche la ligne d'installation et l'extrait du SDK. | Aucun | Tout utilisateur connecté |
| Bouton de copie de Installation | Copie la commande d'installation. | Aucun | Tout utilisateur connecté |
Rôles
L'écran ne lit rien dans l'API et le portail ne demande aucun rôle. L'exécution d'un extrait demande ensuite les rôles des routes qu'il appelle.
Tâches courantes
Démarrer avec le SDK Python
- Ouvrir l'onglet. Chaque SDK a sa propre ligne d'installation. Cliquez sur Python. Résultat attendu : la ligne d'installation et le démarrage rapide Python. En cas d'échec : rechargez la page.
- Installer le SDK. Copiez la ligne Installation avec son bouton de copie et lancez-la dans votre environnement. Résultat attendu : le paquet est installé. En cas d'échec : vérifiez l'accès à votre miroir de paquets.
- Lancer le démarrage rapide. Copiez le code de Démarrage rapide, placez votre clé dans l'environnement et lancez-le. Résultat attendu : la réponse du modèle. En cas d'échec : récupérez un fichier d'environnement complet sur l'écran Kit développeur.
Choisir le bon SDK pour une application vocale
- Ouvrir Temps réel. Le flux temps réel diffère d'un appel de chat. Cliquez sur Temps réel. Résultat attendu : l'extrait montre le serveur qui crée la session et le navigateur qui la rejoint. En cas d'échec : rechargez la page.
- Séparer le code. La création de session tourne sur votre serveur, la connexion dans le navigateur. Résultat attendu : aucune clé de longue durée dans le navigateur. En cas d'échec : lisez la documentation des SDK.
Dépannage
| Symptôme | Cause | Correction |
|---|---|---|
| L'extrait appelle une mauvaise adresse | L'adresse de l'API du portail n'est pas celle que joint votre code. | Remplacez l'adresse dans l'extrait ou corrigez le paramètre du portail. |
| 401 à l'exécution de l'extrait | Aucune clé ou une clé fausse dans l'environnement. | Créez une clé de projet et renseignez EAI_API_KEY. |
| 403 à l'exécution de l'extrait | La clé ou l'utilisateur n'a pas un rôle de la route. | Demandez le rôle à un administrateur du tenant. |