CLI ElevenLabs
La CLI ElevenLabs v1.0.0 est désormais disponible. Chaque opération de l’API ElevenLabs est accessible sous forme de sous-commande, avec une sortie JSON, tableau, YAML et CSV, une pagination automatique et la complétion du shell.
La CLI propose également des workflows de configuration locale pour ElevenAgents. Stockez les configurations d’agents, d’outils et de tests sous forme de fichiers, synchronisez-les avec les commandes push et pull, gérez les branches, exécutez des tests, installez des composants d’interface ElevenLabs et sélectionnez une région de résidence des données.
Procédures
Les procédures sont désormais disponibles pour tous dans ElevenAgents. Une procédure contient des instructions propres à une tâche et un déclencheur qui détermine quand elles s’appliquent. Au cours d’une conversation, l’agent charge la procédure pertinente, ce qui lui permet de traiter des tâches distinctes sans intégrer chaque instruction à son prompt système.
Utilisez des procédures libres lorsque l’agent peut adapter la formulation ou l’ordre des instructions. Utilisez des procédures structurées lorsque les étapes doivent s’exécuter dans un ordre défini. Les deux types peuvent être utilisés avec des workflows sur un même agent.
ElevenAgents
- Tickets de triage des conversations : ajout d’API permettant de créer des tickets sur les performances des agents, de créer des tickets de suivi manuel, de lister les tickets, d’attribuer des membres du Workspace, de mettre à jour le statut et la personne assignée, et d’ajouter des commentaires au niveau du ticket ou du tour de conversation.
- Observabilité des conversations : les clients en temps réel peuvent recevoir un événement
context_usageaprès chaque tour d’agent terminé. L’événement indique le modèle, le nombre de tokens du prompt et la limite de contexte du modèle.
Versions des SDK
SDK JavaScript
- v2.65.0 - Ajout de clients et de types pour les tickets de triage des conversations et les résumés légers de conversations. Les API de conversation ajoutent des filtres de procédure, d’appel d’outil non valide et de tri ; les API de procédure ajoutent la sélection de version d’agent ; les API de sujet ajoutent des contrôles de détail d’évaluation et le tri par frustration. Cette version ajoute également des champs de fréquence d’actualisation de la base de connaissances, d’environnement de test et d’intégration d’alertes, ainsi que des types de messages Dubbing en temps réel.
SDK Python
- v2.65.0 - Ajout de clients et de types pour les tickets de triage des conversations et les résumés légers de conversations. Les API de conversation ajoutent des filtres de procédure, d’appel d’outil non valide et de tri ; les API de procédure ajoutent la sélection de version d’agent ; les API de sujet ajoutent des contrôles de détail d’évaluation et le tri par frustration. Cette version ajoute également des champs de fréquence d’actualisation de la base de connaissances, d’environnement de test et d’intégration d’alertes, et préserve les champs multipartites répétés pour
keytermsde Speech to Text etwebhook_idsde Dubbing.
SDK Swift
- v3.3.0 - Ajout de l’analyse typée des erreurs client, de la gestion de
expects_responseet de résultats d’outils sûrs du point de vue des types. Le démarrage WebRTC est désormais prêt lorsque l’agent rejoint la session, au lieu d’attendre l’abonnement à la piste audio. Cette version renforce également la gestion des URL, supprime le bruit lié aux événements inconnus et retire l’allocation du thread temps réel du traitement de la mise en sourdine logicielle.
Packages
- @elevenlabs/client@1.19.1, @elevenlabs/react@1.12.3, @elevenlabs/react-native@1.2.21, @elevenlabs/convai-widget-core@0.16.2 et @elevenlabs/convai-widget-embed@0.16.2 - La capture de sortie WebRTC utilise désormais des chemins AudioWorklet auto-hébergés avec des politiques strictes de sécurité du contenu. La mise en cache des worklets inclut la source demandée, empêchant une URL en ligne antérieure de remplacer un chemin auto-hébergé. Les erreurs de configuration de React Native renvoient désormais vers
@elevenlabs/react-native. - @elevenlabs/client@1.20.0, @elevenlabs/react@1.12.4, @elevenlabs/react-native@1.2.22, @elevenlabs/convai-widget-core@0.16.3 et @elevenlabs/convai-widget-embed@0.16.3 - Ajout de
webRtc.iceTransportPolicyfacultatif. Définissez-le surrelayafin de limiter les candidats ICE WebRTC aux relais TURN sur les réseaux qui bloquent le trafic UDP direct. - @elevenlabs/client@1.21.0, @elevenlabs/react@1.13.0, @elevenlabs/types@0.21.1, @elevenlabs/react-native@1.2.23, @elevenlabs/convai-widget-core@0.16.4 et @elevenlabs/convai-widget-embed@0.16.4 - Ajout du rappel
onContextUsageet du typeContextUsageEvent. React expose le rappel viauseConversation. React Native effectue désormais la résolution via la condition d’export de son package au lieu de la détection globale du navigateur. - @elevenlabs/client@1.22.0, @elevenlabs/react@1.14.0, @elevenlabs/types@0.22.0, @elevenlabs/react-native@1.2.24, @elevenlabs/convai-widget-core@0.17.0 et @elevenlabs/convai-widget-embed@0.17.0 - Ajout de contenu enrichi dans le premier message avec des réponses de boutons attribuées, de
onExternalAgentDisconnectedet deonMCPToolApprovalRequest. WebRTC utilise désormais le périphérique d’entrée sélectionné, préserve l’état de sourdine lors du changement de microphone et échoue lors de la configuration si les données d’initialisation ne peuvent pas être envoyées. Le widget ajoute l’état de la file d’attente des requêtes simultanées, la sélection facultative de la langue sur le déclencheur réduit et le rendu du premier message pour les agents prenant en charge le texte et la voix.
API
Voir les modifications de l’API
Nouveaux points de terminaison
ElevenAgents
- Ajout de neuf points de terminaison pour les tickets de triage des conversations :
- Créer un ticket de conversation -
POST /v1/convai/triage-tickets. La requête requiertconversation_id(chaîne) et accepteqa_comment(chaîne nullable, de 1 à 10 000 caractères) ainsi que jusqu’à 200 commentaires de tours. - Lister les tickets -
GET /v1/convai/agents/{agent_id}/triage-tickets, avec pagination par curseur. - Créer un ticket manuel -
POST /v1/convai/agents/{agent_id}/triage-tickets. La requête requiertqa_comment(chaîne, de 1 à 10 000 caractères). - Lister les utilisateurs pouvant être assignés -
GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users. La réponse liste les membres du Workspace qui ne sont pas des comptes de service et indique si chaque membre a accès à l’agent. - Obtenir un ticket -
GET /v1/convai/triage-tickets/{agentqa_ticket_id}. - Mettre à jour un ticket -
PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}. La requête acceptestatusfacultatif etassignee_user_idnullable. - Supprimer un ticket -
DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}. - Ajouter un commentaire -
POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments. La requête requiertcomment(chaîne, de 1 à 10 000 caractères). - Ajouter un commentaire de tour -
POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments. La requête requiertturn_indexà indexation zéro (entier) etcomment(chaîne, de 1 à 10 000 caractères).
- Créer un ticket de conversation -
Points de terminaison mis à jour
ElevenAgents
- Obtenir une URL signée -
GET /v1/convai/conversation/get-signed-url- Ajout de
debug_events_requestfacultatif (booléen,falsepar défaut). Les événements de débogage requièrent un accès éditeur à l’agent.
- Ajout de
- Obtenir un jeton WebRTC -
GET /v1/convai/conversation/token- Ajout de
debug_events_requestfacultatif (booléen,falsepar défaut). La route héritéeGET /v1/convai/conversation/get_signed_urlaccepte le même paramètre.
- Ajout de
- Lister les conversations -
GET /v1/convai/conversations- Ajout de
triggered_procedure_idsfacultatif (tableau de chaînes nullable, maximum 50) pour trouver les conversations dans lesquelles l’une des procédures spécifiées a été exécutée. - Ajout de
include_invalid_tool_callsfacultatif (booléen,falsepar défaut) pour inclure les appels d’outils qui n’ont pas été exécutés. - Ajout de
sort_directionfacultatif (ascoudesc,descpar défaut) pour l’heure de début de l’appel.
- Ajout de
- Rechercher du texte dans les messages de conversation -
GET /v1/convai/conversations/messages/text-search- Ajout de
triggered_procedure_idsfacultatif (tableau de chaînes nullable, maximum 50). - Ajout de
include_invalid_tool_callsfacultatif (booléen,falsepar défaut).
- Ajout de
- Obtenir les sujets de conversation d’un agent -
GET /v1/convai/agents/{agent_id}/topics- Ajout de
include_evaluation_criteriafacultatif (booléen,truepar défaut). - Ajout de
frustrationàsort_by. - Les réponses de sujet ajoutent
success_ratenullable (nombre), tandis que la réponse globale ajouteaggregated_run_count(entier,0par défaut). from_unix_secsest arrondi à l’inférieur jusqu’au début de son jour UTC. Une plage délimitée agrège les exécutions quotidiennes de découverte terminées ; si les deux limites sont omises, la dernière exécution est renvoyée.
- Ajout de
- Lister les procédures (
GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures) et Obtenir une procédure (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id})- Ajout de
agent_version_idfacultatif et nullable (chaîne) pour récupérer les procédures d’une version spécifique de l’agent.
- Ajout de
- Créer un test et Mettre à jour un test
- Ajout de
environmentfacultatif et nullable (chaîne) aux schémas de réponse, de simulation et de test unitaire d’appel d’outil. La valeur sélectionne les URL, en-têtes et connexions d’authentification propres à l’environnement ; sa valeur par défaut estproduction.
- Ajout de
- Créer un document à partir d’une URL, Créer une tâche d’exploration et Créer un dossier
- Ajout de
minimum_frequency_daysfacultatif et nullable (entier, de 1 à 180) pour la synchronisation automatique. La valeur par défaut est7, et une fréquence plus stricte du dossier parent prévaut.
- Ajout de
Musique
- Lister les Finetunes de musique -
GET /v1/music/finetunes- Augmentation de la valeur maximale de
page_sizede 100 à 150. La valeur par défaut reste 50.
- Augmentation de la valeur maximale de
Modifications de schéma
ElevenAgents
- Les requêtes de mise à jour d’agent ajoutent
proceduresfacultatif et nullable (object<string, ProcedureVersionRef>). Chaque valeur requiertprocedure_idetversion_id(chaînes). Un objet vide supprime toutes les procédures. - La configuration d’initialisation de conversation ajoute
enable_procedure_ids_from_client(booléen,falsepar défaut). Les données d’initialisation ajoutentprocedure_idsfacultatif et nullable (tableau de chaînes) ; un tableau vide désactive toutes les procédures pour l’agent de départ. ClientEventajoutecontext_usage.- Les remplacements de délai d’expiration souple ajoutent
additional_soft_timeout_messagesfacultatif et nullable (tableau de chaînes). - Les valeurs constantes dans les modèles d’analyse et de remplacement de schéma acceptent désormais
null. - Les valeurs par défaut de la configuration du widget pour
mic_muting_enabledettranscript_enabledpassent defalseàtrue. Définissez-les explicitement surfalsepour préserver le comportement précédent.
Workspace
- Les réponses de Obtenir un utilisateur ont supprimé
xi_api_keydeUserResponseModel. ResourceMetadataResponseModel.role_to_group_idsaccepte désormais des ID de rôle personnalisés comme clés au lieu de limiter les clés àadmin,editor,commenteretviewer.- Les réponses de publication directe ajoutent
restricted_to_user_email_domainsfacultatif et nullable (tableau de chaînes). - Les réponses de changement d’abonnement en attente ajoutent
goànext_tier.