ElevenAgents
-
Événement WebSocket
agent_response_complete: un nouvel événement clientagent_response_completese déclenche exactement une fois lorsqu’une réponse d’agent est entièrement transmise, après la fin de toute génération LLM, de toutes les chaînes d’appels d’outils et de la lecture audio. Après cet événement, l’agent ne produira de nouvelle sortie que si l’utilisateur fournit une nouvelle entrée ou si un délai d’expiration de tour déclenche un nouveau tour. L’événement permet aux clients de détecter de manière fiable la fin d’un tour afin de regrouper les messages, d’activer un mot d’éveil ou de mettre à jour l’interface après le tour. Ajout d’une nouvelle valeurAGENT_RESPONSE_COMPLETEà l’énumérationClientEventet d’un modèle de réponseAgentResponseCompleteClientEventcorrespondant. -
Mode de parole avant outil : ajout d’un nouveau champ
pre_tool_speech(énumérationPreToolSpeechMode, valeur par défautauto) dans la configuration du serveur MCP et les remplacements par outil. Il remplace le booléenforce_pre_tool_speech, désormais obsolète. Valeurs :autodécide si l’agent parle avant l’appel d’outil en fonction de la latence récente des outils,forcedemande toujours à l’agent de parler etoffdésactive entièrement cette fonctionnalité. -
La répartition des outils respecte le mode d’exécution : les nœuds de répartition d’outils des workflows respectent désormais correctement le
execution_modede chaque outil imbriqué. Si un outil d’un nœud de répartition utilisePOST_TOOL_SPEECH, le workflow attend que l’audio du tour en cours soit entièrement exposé avant d’exécuter la répartition. -
Délai d’expiration des réponses MCP : ajout d’un champ
response_timeout_secs(entier, valeur par défaut30, minimum5, maximum120) dans la configuration du serveur MCP et les remplacements par outil, qui contrôle le délai d’attente maximal pour chaque appel d’outil MCP. -
Contexte de confiance de l’agent : ajout d’un champ
trust_contextaux paramètres de plateforme de l’agent (énumérationAgentTrustContext:unknown|low|high, valeur par défautunknown).lowest destiné aux agents au service de participants externes non fiables, dont les sorties doivent être vérifiées et l’accès aux outils limité ;highest destiné aux agents au service du propriétaire, pour lesquels un accès complet aux outils est approprié ;unknowncouvre les agents créés avant cette fonctionnalité. -
Option d’attribution des sources : ajout d’un booléen
source_attribution(valeur par défautfalse) dans la configuration de conversation. Lorsqu’il est activé et que du contenu de base de connaissances est présent, le LLM reçoit l’instruction d’indiquer les sources utilisées. -
Filtre du mode de partage des tests : le point de terminaison répertorier les tests accepte désormais un paramètre de requête
sharing_mode(all|shared_with_me, valeur par défautall) afin de filtrer les tests et dossiers pour ne conserver que ceux partagés avec l’utilisateur actuel et qu’il n’a pas créés. -
Icônes d’outils et métadonnées d’exécution : ajout des champs
icons(tableau deIcon) etexecution(ToolExecution) au schémaTool.Iconinclutsrc,mimeTypeetsizespour l’affichage dans l’interface, etToolExecution.taskSupport(forbidden|optional|required) indique comment l’outil participe aux tâches. -
Valeur par défaut du compilateur de procédures : la valeur par défaut de
ProcedureCompilerModeest passée dedeterministicàappend, et la valeurllma été supprimée. Les agents existants qui définissent explicitementdeterministicne sont pas concernés. -
Métadonnées d’attribution RAG et de base de connaissances : ajout de
used_static_kb_document_ids(tableau de chaînes) àConversationHistoryTranscriptCommonModeletConversationHistoryTranscriptResponseModel, ainsi que deused_chunk_idsàRagRetrievalInfo, afin d’indiquer précisément quels documents de base de connaissances et fragments RAG ont contribué à chaque tour de transcription. -
Refonte des variables dynamiques :
dynamic_variablesetdynamic_variable_placeholdersfont désormais référence aux schémas unifiésDynamicVariableValueType-Input/DynamicVariableValueType-Output(qui remplacent les précédents schémasDynamicVariableContainerValueType-*), avec une prise en charge étendue des valeurs imbriquées et sous forme de listes.DynamicVariableAssignmenta reçu un champpreserve_native_typepour conserver les valeurs typées plutôt que de les convertir en chaînes.
Isolation audio
- Points de terminaison d’historique : deux nouveaux points de terminaison exposent votre historique d’isolation audio.
- Répertorier l’historique d’isolation audio (
GET /v1/audio-isolation/history) renvoie une liste paginée de toutes vos générations d’isolation audio. Prend en charge les paramètres de requêtepage_size,pageetsearch. - Supprimer un élément de l’historique d’isolation audio (
DELETE /v1/audio-isolation/history/{history_item_id}) supprime un élément spécifique et ses fichiers multimédias associés.
- Répertorier l’historique d’isolation audio (
Speech to Text
- Termes clés en temps réel et mode verbatim : le WebSocket Scribe en temps réel accepte désormais un paramètre
keyterms(tableau de chaînes, 50 entrées maximum de 20 caractères chacune) pour orienter le modèle vers des termes spécifiques, ainsi qu’un booléenno_verbatimpour supprimer les mots de remplissage, faux départs et hésitations des transcriptions. Les deux paramètres sont renvoyés dans l’événementsession_started. Disponibles dans le SDK JavaScript, le SDK Python et le SDK client navigateur/Node@elevenlabs/client.
Versions des SDK
SDK Python
- v2.45.0 : régénération Fern pour le schéma d’API du 27 avril 2026, incluant les points de terminaison d’historique d’isolation audio, les exécutions d’outils,
pre_tool_speechetresponse_timeout_secsde MCP, ainsi que l’événement clientagent_response_complete. Comprend également une correction de l’indication d’installation dans un notebook du README. - v2.44.0 : régénération Fern pour le schéma d’API du 21 avril 2026, incluant le champ
trust_context, le modepre_tool_speech, la prise en charge de la transcription des ressources et la configuration du délai d’expiration des réponses MCP.
SDK JavaScript
- v2.45.0 : ajout des options
keyterms(tableau de chaînes, 50 termes clés maximum de 20 caractères chacun) etnoVerbatim(booléen) au client Scribe en temps réel. Leskeytermssont envoyés comme paramètres de requête répétés dans l’URL WebSocket afin d’orienter la transcription, etnoVerbatimsupprime les mots de remplissage et les hésitations. Les deux champs sont également ajoutés à l’interface typéeConfigpour l’échosession_started. Comprend également la régénération Fern du 27 avril 2026 (#376). - v2.44.0 : régénération Fern pour le schéma d’API du 21 avril 2026, incluant le champ
trust_context, le modepre_tool_speechet la configuration du délai d’expiration des réponses MCP.
SDK Swift
- v3.1.4 : correction d’un problème où le microphone local continuait à publier après la déconnexion d’un agent (délai d’expiration du silence ou outil
end_call).onAgentDisconnecteddéconnecte désormais la salle LiveKit et supprime l’état de conversation, avec le déclenchement deonDisconnectpour une raison.agent.ConnectionManaging.onAgentDisconnectedest désormaisasync. Suppression de l’enveloppeConversationConnectionManagerinutilisée.
Packages
- @elevenlabs/client@1.3.1 : correction d’un problème où le son d’appel d’outil de l’agent était interprété comme de la parole utilisateur et interrompait l’agent pendant l’exécution de l’outil.
- @elevenlabs/client@1.3.0 : ajout de la prise en charge du point de terminaison téléverser un fichier de conversation, permettant aux clients de joindre des fichiers à une conversation en cours directement depuis le SDK client.
- @elevenlabs/react@1.2.1, @elevenlabs/react@1.2.0 : mise à jour vers
@elevenlabs/client@1.3.1/@elevenlabs/client@1.3.0, incluant la correction du son d’appel d’outil et la prise en charge du téléversement de fichiers de conversation. - @elevenlabs/react-native@1.1.3, @elevenlabs/react-native@1.1.2 : mise à jour vers la dernière version de
@elevenlabs/clientpour les mêmes corrections. - @elevenlabs/convai-widget-core@0.11.6, @elevenlabs/convai-widget-embed@0.11.6 : mise à jour vers
@elevenlabs/client@1.3.1pour la correction du son d’appel d’outil. - @elevenlabs/convai-widget-core@0.11.5, @elevenlabs/convai-widget-embed@0.11.5 : mise à jour vers
@elevenlabs/client@1.3.0pour la prise en charge du téléversement de fichiers de conversation.
API
Voir les modifications de l'API
Nouveaux points de terminaison
- Répertorier l’historique d’isolation audio :
GET /v1/audio-isolation/history - Supprimer un élément de l’historique d’isolation audio :
DELETE /v1/audio-isolation/history/{history_item_id} - Obtenir les exécutions d’outils :
GET /v1/convai/tools/{tool_id}/executionsrenvoie des exécutions d’outils paginées pour un outil spécifique, avec les filtres facultatifscursor,page_size,is_error,agent_id,branch_id,start_timeetend_time
Points de terminaison mis à jour
ElevenAgents
-
Créer un agent, Obtenir un agent, Mettre à jour un agent
- Ajout du champ
trust_context(énumérationAgentTrustContext:unknown|low|high, valeur par défautunknown) àAgentPlatformSettingsRequestModel - Ajout du champ
source_attribution(booléen, valeur par défautfalse) àConversationConfig
- Ajout du champ
-
Mettre à jour la configuration du serveur MCP, Créer un serveur MCP
- Ajout du champ
pre_tool_speech(énumérationPreToolSpeechMode:auto|force|off, valeur par défautauto) - Ajout du champ
response_timeout_secs(entier, valeur par défaut30, minimum5, maximum120)
- Ajout du champ
-
Créer un remplacement de configuration, Mettre à jour un remplacement de configuration
- Ajout du champ
pre_tool_speech(énumérationPreToolSpeechMode, nullable, facultatif) - Ajout du champ
response_timeout_secs(entier, nullable, facultatif) - Ajout du champ
response_mocksàMCPToolConfigOverride-Input/MCPToolConfigOverride-Output force_pre_tool_speechmarqué comme obsolète ; utilisez plutôtpre_tool_speech
- Ajout du champ
-
- Ajout du paramètre de requête facultatif
sharing_mode(énumérationTestSharingMode:all|shared_with_me, valeur par défautall)
- Ajout du paramètre de requête facultatif
-
Simuler une conversation, Diffuser la simulation d’une conversation
- Refonte des charges utiles
dynamic_variablesetdynamic_variable_placeholdersafin de référencer les schémas unifiésDynamicVariableValueType-Input/DynamicVariableValueType-Output, avec une prise en charge étendue des valeurs imbriquées et sous forme de listes
- Refonte des charges utiles
-
Schéma
Tool- Ajout du champ
icons(tableau deIcon, nullable) pour l’affichage dans l’interface - Ajout du champ
execution(ToolExecution, nullable), incluanttaskSupport(forbidden|optional|required)
- Ajout du champ
-
Énumération
ClientEvent- Ajout de la valeur
agent_response_completeavec le nouveau modèle de réponseAgentResponseCompleteClientEvent
- Ajout de la valeur
-
Énumération
ProcedureCompilerMode- Valeur par défaut passée de
deterministicàappend - Suppression de la valeur
llm
- Valeur par défaut passée de
-
ConversationHistoryTranscriptCommonModel,ConversationHistoryTranscriptResponseModel- Ajout du champ
used_static_kb_document_ids(tableau de chaînes)
- Ajout du champ
-
RagRetrievalInfo- Ajout du champ
used_chunk_ids(tableau de chaînes)
- Ajout du champ
-
DynamicVariableAssignment- Ajout du champ
preserve_native_type(booléen) pour conserver les valeurs typées au lieu de les convertir en chaînes
- Ajout du champ
-
Nœuds de workflow
- Ajout du champ
auto_advance_after_first_responseaux schémas de nœuds de workflow concernés
- Ajout du champ
-
Documentation de configuration des outils
- Ajout du champ
response_body_schemapour documenter la structure de réponse attendue
- Ajout du champ
Workspaces
-
GetUserSubscriptionResponseModel- Ajout du champ
max_credit_limit_extension
- Ajout du champ
-
Obtenir l’utilisation du Workspace par produit au fil du temps
- Validation des requêtes renforcée : les valeurs minimales de
start_timeetend_timesont relevées à2020-01-01, et des descriptions sont ajoutées aux deux champs. Le résumé du point de terminaison a été renomméGet Workspace Usage.
- Validation des requêtes renforcée : les valeurs minimales de
Autres
- Nouvelle énumération partagée
Currencyavec les valeurseur,inr,usd, remplaçant les chaînes de devise en ligne dans plusieurs schémas. - Les nouveaux schémas
AssetTranscriptionetAssetTranscriptionDataétendent les modèles de ressources avec la prise en charge de la transcription. - Les nouveaux modèles
PendingBlocksMetadataModeletPendingExternalAudiosMetadataModelfournissent des métadonnées plus riches sur les tâches en attente. - Nouvelle valeur
InVPCajoutée aux énumérations liées aux sources. - Les
keytermsde transcription ont désormais des restrictions de longueur explicites dans la spécification. - Ajout des nouveaux schémas
MemoryEntrySearchResult,ConversationSourceetManualSource.