Onboarding ElevenLabs

Le CLI ElevenLabs exécute toute la configuration et vous indique chaque étape. À partir du dossier de l'app qui utilisera la clé (dans un monorepo, le dossier de cette app), exécutez :

npx -y @elevenlabs/cli@latest onboard init

Chaque commande onboard affiche du JSON. Agissez en conséquence, et continuez jusqu'à ce que next soit done :

• next : ce qu'il faut faire maintenant, expliqué dans instruction.
• run : la commande exacte à exécuter ensuite. Exécutez-la telle que donnée.
• say : ce qu'il faut dire à l'utilisateur. Dites-le tel qu'écrit.
• details : informations pour l'étape suivante, comme la façon dont l'app charge la clé et la commande d'installation du SDK.
• rules : règles pour toute la configuration. Suivez-les.

Ce que chaque next signifie :

• run : exécutez run.
• wait : la page d'approbation est ouverte. Affichez say (elle contient le lien), puis exécutez run immédiatement après, sans terminer votre tour. Chaque fois que vous donnez le lien à l'utilisateur, copiez-le en entier, exactement tel qu'affiché : un lien raccourci ne fonctionne pas.
• ask_what_to_build : dites à l'utilisateur say, qui demande ce qu'il veut construire ou s'il veut juste ajouter le SDK, et attendez sa réponse avant d'écrire du code. Posez la question même s'il l'a déjà dit, et ne choisissez pas un produit pour lui. Une fois qu'il répond, exécutez run.
• write_code : écrivez ce qu'il a demandé, comme instruction le dit : le SDK seul, ou l'intégration, avec la skill qui convient de details.fetch_skills quand il y en a une. Si cela nécessite quelque chose de créé d'abord dans ElevenLabs, comme un agent, créez-le vous-même avec la clé (chargez le fichier env dans la commande, ne l'imprimez jamais), pas un script pour que l'utilisateur l'exécute. Chargez la clé de la façon que details.load_key indique, puis exécutez run.
• load_key : le code utilise déjà le SDK, donc il n'y a rien à construire. Assurez-vous que l'app charge la clé de la façon que details.load_key indique, ne changez rien d'autre, puis exécutez run.
• fix : faites ce que say décrit, puis exécutez run. Si cela nécessite le shell, les paramètres ou les secrets de l'utilisateur, posez-leur la question à la place, comme pour ask_user.
• ask_user : demandez à l'utilisateur ce que say dit et attendez sa réponse, puis exécutez run, sauf s'il dit non.
• offer_test : dites ce que vous avez configuré et tout ce que l'utilisateur doit encore faire lui-même, comme installer les packages que vous avez ajoutés. Puis terminez votre réponse avec la question dans say. Exécutez run uniquement s'il dit oui.
• done : dites à l'utilisateur say, puis tout ce qu'il doit encore faire lui-même, en une ou deux étapes concrètes.

Règles

• N'ouvrez jamais, n'imprimez pas et ne faites pas de cat du fichier env ; onboard check le vérifie.
• Ne demandez jamais une clé API en chat, et n'en acceptez pas une collée ici. Si une apparaît, dites à l'utilisateur de la faire tourner sur la page des clés API.
• Ne mettez jamais la clé dans le code ; le SDK lit ELEVENLABS_API_KEY.
• N'exécutez jamais git clean ou ne supprimez pas les fichiers non suivis : la clé en est un.
• N'écrivez ou ne changez pas de code tant que le next d'une réponse n'est pas write_code ou load_key.
• Mettez tout ce que vous téléchargez juste pour lire, comme un package ou une archive, dans un dossier temporaire, jamais dans le projet.
• N'exécutez pas l'app (ou son script de démarrage) ni ne générez de parole pour l'essayer avant que l'utilisateur n'accepte la demande de test. Les appels API que ce qu'il a demandé nécessite, comme créer un agent, sont acceptables. Une fois le code écrit, exécutez onboard check avant de terminer : cela vérifie la clé et le code.

Pas de npx

Si npx n'est pas disponible (Node.js n'est pas installé), installez le CLI (ou mettez-le à jour s'il est déjà installé : brew upgrade elevenlabs, ou relancez l'installateur), puis exécutez elevenlabs onboard init à la place. Tout ce qui suit est identique.

• macOS ou Linux : brew install elevenlabs/tap/elevenlabs, ou curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh
• Windows : powershell -ExecutionPolicy ByPass -c "irm https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.ps1 | iex"

Si elevenlabs n'est pas trouvé après l'exécution de l'installateur, utilisez ~/.cargo/bin/elevenlabs à la place, ici et dans chaque run fourni par le CLI.