Journal des modifications

March 23, 2026

ElevenAgents

  • API de variables d’environnement : nouveaux points de terminaison de variables d’environnement pour gérer la configuration au niveau du Workspace, à laquelle les agents peuvent faire référence à l’exécution via le modèle {{system_env__<label>}}. Prend en charge les types de variables chaîne, secret et connexion d’authentification, avec des remplacements de valeurs par environnement. Les points de terminaison comprennent create, list, get et update.

  • Gestion des connexions d’authentification : nouvelle API de connexions d’authentification au niveau du Workspace pour gérer les identifiants utilisés par les outils et intégrations des agents. Prend en charge plusieurs méthodes d’authentification, dont les identifiants client OAuth2, JWT, l’authentification basique, les jetons bearer, les en-têtes personnalisés et les flux de code d’autorisation OAuth2 gérés par l’intégration. Les points de terminaison permettent de créer, lister et supprimer des connexions.

  • Actualisation des URL de la base de connaissances : nouveau point de terminaison refresh (POST /v1/convai/knowledge-base/{documentation_id}/refresh) pour récupérer à nouveau et mettre à jour le contenu des documents de base de connaissances provenant d’URL. Les documents de base de connaissances prennent désormais également en charge la configuration de synchronisation automatique avec les champs enable_auto_sync, auto_remove et auto_sync_info.

  • Nouvelle tentative de garde-fou avec retour : les garde-fous personnalisés et de contenu prennent désormais en charge des actions de déclenchement configurables avec les options EndCallTriggerAction et RetryTriggerAction. Lorsqu’elle est définie sur une nouvelle tentative, l’agent régénère sa réponse avec un retour système injecté, jusqu’à 3 tentatives. Les espaces réservés disponibles incluent {{trigger_reason}} et {{agent_message}} pour fournir des indications contextuelles lors des nouvelles tentatives.

  • Variable système d’historique des conversations : ajout d’une nouvelle variable dynamique system__conversation_history qui fournit, à l’exécution, un historique des conversations évalué à la demande et sérialisé en JSON. Elle est utile pour transmettre le contexte complet d’une conversation aux outils, webhooks ou transferts vers des sous-agents.

  • Type de contenu des outils webhook : les outils serveur prennent désormais en charge un type de contenu configurable pour les paramètres du corps des webhooks, ce qui vous permet de choisir entre les formats application/json et application/x-www-form-urlencoded. Le format encodé dans l’URL est utile pour les intégrations avec des systèmes existants, des points de terminaison de jetons OAuth et des processeurs de paiement.

  • Messages WhatsApp sortants : mise à jour de l’intégration WhatsApp avec une nouvelle boîte de dialogue de message sortant dans le Dashboard, permettant aux agents d’envoyer des messages sortants en plus des appels via le canal WhatsApp.

  • Filtres de liste d’agents et de ressources : les points de terminaison list agents, list knowledge base documents et list tools prennent désormais en charge un paramètre de requête created_by_user_id (utilisez @me pour l’utilisateur actuel). Les paramètres précédents show_only_owned_agents et show_only_owned_documents sont obsolètes.

  • Expressions conditionnelles de workflow : ajout d’un nouveau nœud AST conditional_operator au schéma d’expression de workflow, permettant une logique de branchement dans les définitions de workflow d’agent.

Musique

  • Music Marketplace : nouvelle documentation Music Marketplace couvrant la place de marché de licences pour la musique générée par l’IA, y compris les types d’utilisation, les rémunérations des créateurs et les détails des licences.

Versions des SDK

SDK Python

  • v2.40.0 - Ajout de la prise en charge du paramètre environment pour les conversations ElevenAgents, permettant des connexions d’agent spécifiques à l’environnement. Régénération Fern pour correspondre au dernier schéma d’API, y compris les variables d’environnement, les connexions d’authentification, l’actualisation de la base de connaissances et les actions de déclenchement des garde-fous.

SDK JavaScript

  • v2.40.0 - Ajout du type d’événement WebSocket multimodal_message pour les conversations ElevenAgents en temps réel. Régénération Fern pour correspondre au dernier schéma d’API, y compris les variables d’environnement, les connexions d’authentification, l’actualisation de la base de connaissances et les actions de déclenchement des garde-fous.

SDK iOS

  • v3.1.1 - Ajout de la prise en charge du paramètre environment pour les connexions d’agent spécifiques à l’environnement. Correction d’une erreur de build visionOS en portant l’exigence de plateforme à v2.

Packages

Version candidate des packages v1.0.0

La première version candidate de la v1.0.0 des SDK client ElevenAgents est désormais disponible. Il s’agit d’une version majeure avec des changements incompatibles qui améliorent la surface de l’API, ajoutent des hooks React granulaires pour de meilleures performances de rendu et unifient le SDK React Native avec le SDK React.

Pour essayer la version candidate :

npm install @elevenlabs/client@next @elevenlabs/react@next @elevenlabs/react-native@next

Une compétence elevenlabs:sdk-migration est disponible pour aider les assistants de programmation IA à migrer automatiquement votre base de code vers les nouvelles API. Ajoutez-la à votre projet Claude Code, Cursor ou Windsurf pour bénéficier d’une migration guidée.

Principaux changements de la v1.0.0 :

  • @elevenlabs/client : Conversation est désormais un objet d’espace de noms et un alias de type pour TextConversation | VoiceConversation, au lieu d’une classe. Les classes Input et Output sont remplacées par les interfaces InputController et OutputController, avec de nouvelles méthodes pratiques sur l’instance de conversation (setMicMuted(), setVolume(), getInputByteFrequencyData(), getOutputByteFrequencyData()). changeInputDevice() et changeOutputDevice() renvoient désormais void.
  • @elevenlabs/react : useConversation nécessite désormais un ancêtre ConversationProvider. Nouveaux hooks granulaires pour un rerendu précis : useConversationControls(), useConversationStatus(), useConversationInput(), useConversationMode(), useConversationFeedback(). Nouveau hook useConversationClientTool() pour enregistrer dynamiquement des outils client depuis des composants React avec une sécurité de type complète.
  • @elevenlabs/react-native : réécriture complète de l’API, remplaçant ElevenLabsProvider et useConversation par ConversationProvider et les mêmes hooks granulaires que @elevenlabs/react. Les polyfills WebRTC et la configuration native d’AudioSession sont appliqués automatiquement lors de l’importation.

Consultez les notes de version complètes et les guides de migration :

API

Nouveaux points de terminaison

ElevenAgents

Workspaces

  • POST /v1/workspace/auth-connections - Créer une connexion d’authentification de Workspace prenant en charge OAuth2, JWT, les méthodes basique, bearer, d’en-tête personnalisé et d’authentification gérée par l’intégration
  • GET /v1/workspace/auth-connections - Lister toutes les connexions d’authentification du Workspace avec les informations de dépendance (outils, serveurs MCP, connexions d’intégration)
  • DELETE /v1/workspace/auth-connections/{auth_connection_id} - Supprimer une connexion d’authentification du Workspace

Speech to Text

  • GET /v1/speech-to-text/evaluation/eval-criteria - Lister les critères d’évaluation
  • POST /v1/speech-to-text/evaluation/eval-criteria - Créer un critère d’évaluation
  • GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Obtenir un critère d’évaluation spécifique
  • PATCH /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Mettre à jour un critère d’évaluation
  • DELETE /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Supprimer un critère d’évaluation
  • POST /v1/speech-to-text/evaluation/evaluations - Déclencher une évaluation
  • GET /v1/speech-to-text/evaluation/evaluations - Lister les évaluations
  • GET /v1/speech-to-text/evaluation/evaluations/{evaluation_id} - Obtenir une évaluation spécifique
  • GET /v1/speech-to-text/evaluation/human-agents - Lister les agents humains
  • GET /v1/speech-to-text/evaluation/human-agents/{agent_id} - Obtenir un agent humain
  • DELETE /v1/speech-to-text/evaluation/human-agents/{agent_id} - Supprimer un agent humain
  • GET /v1/speech-to-text/evaluation/analytics - Obtenir les analyses d’évaluation
  • GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}/analytics - Obtenir les analyses d’un critère spécifique
  • GET /v1/speech-to-text/evaluation/human-agents/{agent_id}/analytics - Obtenir les analyses d’un agent humain spécifique

Points de terminaison mis à jour

ElevenAgents

  • Obtenir une URL signée, Obtenir un jeton de conversation

    • Ajout du paramètre de requête environment (chaîne, facultatif) pour une résolution spécifique à l’environnement

  • Lister les agents

    • Ajout du paramètre de requête created_by_user_id (chaîne, facultatif, prend en charge @me)
    • show_only_owned_agents est obsolète au profit de created_by_user_id

  • Lister les documents de la base de connaissances

    • Ajout du paramètre de requête created_by_user_id (chaîne, facultatif, prend en charge @me)
    • show_only_owned_documents est obsolète au profit de created_by_user_id

  • Lister les outils

    • Ajout du paramètre de requête created_by_user_id (chaîne, facultatif, prend en charge @me)
    • show_only_owned_documents est obsolète au profit de created_by_user_id

  • Obtenir un segment de base de connaissances

    • Ajout du paramètre de requête embedding_model (chaîne, facultatif) pour spécifier le modèle d’embedding lors de la récupération d’un segment

  • Créer un agent, Mettre à jour un agent, Créer un brouillon

    • Ajout de la prise en charge de guardrail_trigger_action avec les schémas EndCallTriggerAction et RetryTriggerAction
    • Ajout du nœud AST conditional_operator aux définitions d’expression de workflow
    • Les schémas d’agent prennent désormais en charge ConvAIEnvVarLocator et EnvironmentAuthConnectionLocator pour référencer des variables d’environnement dans les configurations d’outils

  • Appel sortant de trunk SIP

    • Schéma de requête mis à jour pour prendre en compte les nouveaux champs liés à l’environnement

  • Simuler une conversation, Simuler un flux de conversation

    • Ajout du champ simulation_environment au schéma de requête

Modifications de schéma

Nouveaux schémas

  • ConvAIEnvironmentVariable, ConvAIEnvironmentVariableCreate, ConvAIEnvironmentVariableUpdate - Modèles de variables d’environnement prenant en charge les types chaîne, secret et connexion d’authentification
  • ConvAIEnvVarLocator, EnvironmentAuthConnectionLocator - Localisateurs permettant de référencer des variables d’environnement dans les configurations d’outils et de serveurs MCP
  • EndCallTriggerAction, RetryTriggerAction - Schémas d’action de déclenchement de garde-fou pour les comportements de fin d’appel et de nouvelle tentative avec retour
  • ConditionalOperator - Nouveau nœud AST pour les expressions conditionnelles dans les workflows d’agent
  • AuthConnectionCreateRequest, AuthConnectionResponse, AuthConnectionDependencies - Schémas de gestion des connexions d’authentification du Workspace prenant en charge OAuth2, JWT, les méthodes basique, bearer, d’en-tête personnalisé, WhatsApp et d’authentification gérée par l’intégration
  • SpeechToTextEvaluation* - Ensemble de schémas pour les critères d’évaluation Speech to Text, les évaluations, les agents humains et les analyses

Schémas modifiés

  • MCPServerConfig, MCPServerConfigOutput - Ajout de la prise en charge des références ConvAIEnvVarLocator dans la configuration serveur
  • CustomGuardrailConfig - Ajout du champ trigger_action pour configurer le comportement de fin d’appel ou de nouvelle tentative
  • Contributor - Ajout des champs facultatifs bio (chaîne) et profile_id (chaîne)
  • ASTLLMNode - Ajout du champ value_schema ; le champ prompt est obsolète au profit de value_schema
  • TelephonyDirection - Refactorisé en enum partagé référencé par plusieurs modèles de conversation et de téléphonie