> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. ### ElevenAgents - **Mocks d'outils spécifiques aux tests** : les simulations d'agent et les tests unitaires peuvent désormais définir `tool_mock_overrides`, indexés par ID d'outil, afin de remplacer les mocks partagés pour un test. `ToolResponseMockConfig` ajoute également `is_error` facultatif (booléen, `false` par défaut), afin qu'un mock puisse tester les chemins d'échec d'outil. - **Messages de workflow traduits** : les messages littéraux des nœuds Say ajoutent `text_translations`, une map de clés de langue vers des objets `TranslatedString`. Le champ est facultatif en entrée et requis en sortie ; les validateurs de réponse stricts doivent donc l'accepter. - **Filtres de version de conversation** : [Lister les conversations](/docs/fr/api-reference/conversations/list) et [Rechercher du texte dans les messages de conversation](/docs/fr/api-reference/conversations/messages/text-search) ajoutent le paramètre de requête facultatif `version_id` (chaîne) pour filtrer les résultats par version d'agent. - **Outil système de base de connaissances** : la configuration de l'agent ajoute un outil système `knowledge_base` avec `enabled_strategies` (`SearchStrategy[]`) configurable. Les requêtes RAG de la base de connaissances de l'agent ajoutent `use_agent_defaults` facultatif (booléen, `true` par défaut) ; définissez-le sur `false` pour utiliser des paramètres de récupération neutres tout en conservant le modèle d'intégration de l'agent. - **Détection d'activité vocale de l'agent** : les schémas de création, de mise à jour, de réponse et de remplacement de workflow d'agent ajoutent la configuration `vad`. `VADConfig` prend actuellement en charge `background_voice_detection` (booléen, `false` par défaut). - **LLM personnalisés WebSocket** : `CustomLLMAPIType` ajoute `websocket`. - **Contrôles de mémoire des fichiers** : la configuration d'entrée de fichiers du widget ajoute `max_files_in_memory` (entier, 1 à 30, `10` par défaut). Les fichiers au-delà de la limite sont résumés et libérés de la mémoire ; `max_files_per_conversation` doit être égal à `-1` ou au moins à la limite de mémoire. - **Masquage des entrées DTMF** : `DTMFInputConfig` ajoute `redact_input` facultatif (booléen, `false` par défaut) pour remplacer les chiffres du clavier de l'appelant dans les transcriptions, journaux de conversation et analyses. Les chiffres répétés par l'agent ou transmis aux outils restent inchangés. ### Speech to Text - **Détection d'entités en temps réel** : Scribe v2 Realtime ajoute l'option de requête `entity_detection`. Elle accepte `all`, un type ou une catégorie d'entité, ou un tableau de types et catégories, et émet les entités détectées dans les événements `committed_transcript_entities`. Consultez le [guide de détection d'entités](/docs/fr/eleven-api/guides/how-to/speech-to-text/batch/entity-detection) pour connaître les catégories prises en charge. ### Voix - **Réplication de voix entre résidences de données** : ajout de `POST /v1/voices/{voice_id}/replicate-to-isolated-environment` pour copier une voix Instant Voice Clone ou Voice Design vers un Workspace du même groupe de facturation consolidée. Les requêtes nécessitent `target_workspace_id` (chaîne) et acceptent `preserve_voice_id` (booléen, `true` par défaut) ; les réponses renvoient le `voice_id` cible. - **Métadonnées de personnage** : les réponses de personnage ajoutent `recommended_voice_ids` (tableau de chaînes, `[]` par défaut), les métadonnées ajoutent `role` nullable (`CharacterRole`), et `CharacterAge` remplace `middle-aged` par `middle_aged`. ### Versions des SDK #### Packages - [@elevenlabs/client@1.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.16.0), [@elevenlabs/react@1.11.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.11.0), [@elevenlabs/types@0.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.18.0), [@elevenlabs/react-native@1.2.17](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.17) et [@elevenlabs/convai-widget-core@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.0) - Ajout de `onAgentReasoningResponsePart`, qui reçoit les événements de raisonnement d'agent en streaming avec les types `start`, `delta` et `stop`. - [@elevenlabs/convai-widget-core@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.0) et [@elevenlabs/convai-widget-embed@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.15.0) - Ajout de `show_resize_button` et de l'attribut d'intégration `show-resize-button`. Définissez l'un ou l'autre sur `false` pour masquer le contrôle d'agrandissement et de réduction dans l'en-tête du widget. - [@elevenlabs/client@1.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.17.0), [@elevenlabs/react@1.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.0), [@elevenlabs/types@0.19.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.19.0), [@elevenlabs/react-native@1.2.18](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.18) et [@elevenlabs/convai-widget-core@0.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.1) - Ajout de l'option `enableLogging` à `Scribe.connect` et `useScribe`. La définir sur `false` démarre une session entreprise en mode zéro rétention. Le type Scribe `session_started` signale désormais `enable_logging` ; le champ inutilisé `disable_logging` a été supprimé. #### Serveur MCP - [v0.12.1](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.12.1) - Inclut les mises à jour d'outils de la v0.11 et une actualisation des dépendances qui résout 44 alertes de sécurité. - [v0.11.0](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.11.0) - Ajout de `simulate_conversation` avec un comportement d'utilisateur simulé configurable, des critères d'évaluation, une sortie de transcription et une analyse réussite/échec. L'outil `speech_to_text` utilise désormais `scribe_v2` par défaut, et `voice_clone` envoie désormais le contenu des fichiers audio au lieu de chaînes de chemin. ### API ## Nouveaux endpoints ### Voix - `POST /v1/voices/{voice_id}/replicate-to-isolated-environment` - Réplique une voix Instant Voice Clone ou Voice Design dans l'environnement isolé d'un autre Workspace - Nécessite `target_workspace_id` (chaîne) - Accepte `preserve_voice_id` facultatif (booléen, `true` par défaut) - Renvoie `voice_id` requis (chaîne) ## Endpoints mis à jour ### ElevenAgents - [Lister les conversations](/docs/fr/api-reference/conversations/list) - `GET /v1/convai/conversations` - Ajout du paramètre de requête facultatif `version_id` (chaîne) - [Rechercher du texte dans les messages de conversation](/docs/fr/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search` - Ajout du paramètre de requête facultatif `version_id` (chaîne) - `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query` - Ajout du champ de requête facultatif `use_agent_defaults` (booléen, `true` par défaut) ## Modifications de schéma ### ElevenAgents - Les charges utiles de simulation et de test unitaire ajoutent des maps `tool_mock_overrides` facultatives ; `ToolResponseMockConfig` ajoute `is_error` facultatif (booléen, `false` par défaut) - `SayNodeLiteralMessage` ajoute `text_translations` (map de `TranslatedString`) ; le champ est facultatif en entrée et requis en sortie - La configuration d'agent ajoute `knowledge_base` (`KnowledgeBaseToolConfig`) et `vad` (`VADConfig`) - `CustomLLMAPIType` ajoute `websocket` - `FileInputConfig` ajoute `max_files_in_memory` (entier, 1 à 30, `10` par défaut) - `DTMFInputConfig` ajoute `redact_input` facultatif (booléen, `false` par défaut) - La configuration d'agent en temps réel utilise désormais `eleven_realtime_v1_mini` par défaut ### Voix - Les réponses de personnage ajoutent `recommended_voice_ids` (tableau de chaînes, `[]` par défaut) - Les métadonnées de personnage ajoutent `role` nullable (`CharacterRole`) - Incompatible : `CharacterAge` remplace `middle-aged` par `middle_aged` ; les clients envoyant l'ancienne valeur doivent migrer ### Text to Speech - Incompatible : suppression de `AudioFilterId` et `audio_filter` des schémas de configuration Text to Speech d'ElevenAgents