> 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.

import { YoutubeEmbed } from "../../../components/YoutubeEmbed";

### CLI ElevenLabs

La [CLI ElevenLabs v1.0.0](https://github.com/elevenlabs/cli/releases/tag/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.

<YoutubeEmbed id="MuORAEVtJIQ" />

<CardGroup cols={1}>
  <Card
    title="Documentation de la CLI"
    icon="duotone book"
    href="/docs/fr/eleven-agents/operate/cli"
  >
    Installez la CLI, authentifiez-vous et gérez les agents comme du code.
  </Card>
</CardGroup>

### 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.

<CardGroup cols={3}>
  <Card
    title="Présentation des procédures"
    icon="duotone book"
    href="/docs/fr/eleven-agents/customization/procedures"
  >
    Découvrez quand utiliser les procédures et comment elles se comparent aux prompts et aux workflows.
  </Card>
  <Card
    title="Procédures libres"
    icon="duotone code"
    href="/docs/fr/eleven-agents/customization/procedures/free-form-procedures"
  >
    Rédigez des instructions en langage naturel que l’agent peut adapter à la conversation.
  </Card>
  <Card
    title="Procédures structurées"
    icon="duotone list-check"
    href="/docs/fr/eleven-agents/customization/procedures/structured-procedures"
  >
    Définissez des étapes typées que l’agent suit dans un ordre cohérent.
  </Card>
</CardGroup>

### 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_usage` aprè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](https://github.com/elevenlabs/elevenlabs-js/releases/tag/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](https://github.com/elevenlabs/elevenlabs-python/releases/tag/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 `keyterms` de Speech to Text et `webhook_ids` de Dubbing.

#### SDK Swift

- [v3.3.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.0) - Ajout de l’analyse typée des erreurs client, de la gestion de `expects_response` et 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](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.19.1), [@elevenlabs/react@1.12.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.3), [@elevenlabs/react-native@1.2.21](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.21), [@elevenlabs/convai-widget-core@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.2) et [@elevenlabs/convai-widget-embed@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.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](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.20.0), [@elevenlabs/react@1.12.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.4), [@elevenlabs/react-native@1.2.22](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.22), [@elevenlabs/convai-widget-core@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.3) et [@elevenlabs/convai-widget-embed@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.3) - Ajout de `webRtc.iceTransportPolicy` facultatif. Définissez-le sur `relay` afin de limiter les candidats ICE WebRTC aux relais TURN sur les réseaux qui bloquent le trafic UDP direct.
- [@elevenlabs/client@1.21.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.21.0), [@elevenlabs/react@1.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.13.0), [@elevenlabs/types@0.21.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.21.1), [@elevenlabs/react-native@1.2.23](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.23), [@elevenlabs/convai-widget-core@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.4) et [@elevenlabs/convai-widget-embed@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.4) - Ajout du rappel `onContextUsage` et du type `ContextUsageEvent`. React expose le rappel via `useConversation`. 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](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.22.0), [@elevenlabs/react@1.14.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.14.0), [@elevenlabs/types@0.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.22.0), [@elevenlabs/react-native@1.2.24](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.24), [@elevenlabs/convai-widget-core@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.17.0) et [@elevenlabs/convai-widget-embed@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.17.0) - Ajout de contenu enrichi dans le premier message avec des réponses de boutons attribuées, de `onExternalAgentDisconnected` et de `onMCPToolApprovalRequest`. 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

<Accordion title="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](/docs/fr/api-reference/triage-tickets/create-agent-conversation-ticket-route) - `POST /v1/convai/triage-tickets`. La requête requiert `conversation_id` (chaîne) et accepte `qa_comment` (chaîne nullable, de 1 à 10 000 caractères) ainsi que jusqu’à 200 commentaires de tours.
  - [Lister les tickets](/docs/fr/api-reference/triage-tickets/list-agent-conversation-tickets-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets`, avec pagination par curseur.
  - [Créer un ticket manuel](/docs/fr/api-reference/triage-tickets/create-manual-agent-ticket-route) - `POST /v1/convai/agents/{agent_id}/triage-tickets`. La requête requiert `qa_comment` (chaîne, de 1 à 10 000 caractères).
  - [Lister les utilisateurs pouvant être assignés](/docs/fr/api-reference/triage-tickets/get-assignable-users-route) - `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](/docs/fr/api-reference/triage-tickets/get-agent-conversation-ticket-route) - `GET /v1/convai/triage-tickets/{agentqa_ticket_id}`.
  - [Mettre à jour un ticket](/docs/fr/api-reference/triage-tickets/update-agent-conversation-ticket-route) - `PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}`. La requête accepte `status` facultatif et `assignee_user_id` nullable.
  - [Supprimer un ticket](/docs/fr/api-reference/triage-tickets/delete-agent-conversation-ticket-route) - `DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}`.
  - [Ajouter un commentaire](/docs/fr/api-reference/triage-tickets/add-ticket-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments`. La requête requiert `comment` (chaîne, de 1 à 10 000 caractères).
  - [Ajouter un commentaire de tour](/docs/fr/api-reference/triage-tickets/add-turn-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments`. La requête requiert `turn_index` à indexation zéro (entier) et `comment` (chaîne, de 1 à 10 000 caractères).

## Points de terminaison mis à jour

### ElevenAgents

- [Obtenir une URL signée](/docs/fr/api-reference/conversations/get-signed-url) - `GET /v1/convai/conversation/get-signed-url`
  - Ajout de `debug_events_request` facultatif (booléen, `false` par défaut). Les événements de débogage requièrent un accès éditeur à l’agent.
- [Obtenir un jeton WebRTC](/docs/fr/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
  - Ajout de `debug_events_request` facultatif (booléen, `false` par défaut). La route héritée `GET /v1/convai/conversation/get_signed_url` accepte le même paramètre.
- [Lister les conversations](/docs/fr/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - Ajout de `triggered_procedure_ids` facultatif (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_calls` facultatif (booléen, `false` par défaut) pour inclure les appels d’outils qui n’ont pas été exécutés.
  - Ajout de `sort_direction` facultatif (`asc` ou `desc`, `desc` par défaut) pour l’heure de début de l’appel.
- [Rechercher du texte dans les messages de conversation](/docs/fr/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - Ajout de `triggered_procedure_ids` facultatif (tableau de chaînes nullable, maximum 50).
  - Ajout de `include_invalid_tool_calls` facultatif (booléen, `false` par défaut).
- [Obtenir les sujets de conversation d’un agent](/docs/fr/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
  - Ajout de `include_evaluation_criteria` facultatif (booléen, `true` par défaut).
  - Ajout de `frustration` à `sort_by`.
  - Les réponses de sujet ajoutent `success_rate` nullable (nombre), tandis que la réponse globale ajoute `aggregated_run_count` (entier, `0` par défaut).
  - `from_unix_secs` est 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.
- [Lister les procédures](/docs/fr/api-reference/agents/procedures/list) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`) et [Obtenir une procédure](/docs/fr/api-reference/agents/procedures/get) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`)
  - Ajout de `agent_version_id` facultatif et nullable (chaîne) pour récupérer les procédures d’une version spécifique de l’agent.
- [Créer un test](/docs/fr/api-reference/tests/create) et [Mettre à jour un test](/docs/fr/api-reference/tests/update)
  - Ajout de `environment` facultatif 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 est `production`.
- [Créer un document à partir d’une URL](/docs/fr/api-reference/knowledge-base/create-from-url), [Créer une tâche d’exploration](/docs/fr/api-reference/knowledge-base/create-crawl-job) et [Créer un dossier](/docs/fr/api-reference/knowledge-base/create-folder)
  - Ajout de `minimum_frequency_days` facultatif et nullable (entier, de 1 à 180) pour la synchronisation automatique. La valeur par défaut est `7`, et une fréquence plus stricte du dossier parent prévaut.

### Musique

- [Lister les Finetunes de musique](/docs/fr/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
  - Augmentation de la valeur maximale de `page_size` de 100 à 150. La valeur par défaut reste 50.

## Modifications de schéma

### ElevenAgents

- Les requêtes de mise à jour d’agent ajoutent `procedures` facultatif et nullable (`object<string, ProcedureVersionRef>`). Chaque valeur requiert `procedure_id` et `version_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, `false` par défaut). Les données d’initialisation ajoutent `procedure_ids` facultatif et nullable (tableau de chaînes) ; un tableau vide désactive toutes les procédures pour l’agent de départ.
- `ClientEvent` ajoute `context_usage`.
- Les remplacements de délai d’expiration souple ajoutent `additional_soft_timeout_messages` facultatif 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_enabled` et `transcript_enabled` passent de `false` à `true`. Définissez-les explicitement sur `false` pour préserver le comportement précédent.

### Workspace

- Les réponses de [Obtenir un utilisateur](/docs/fr/api-reference/user/get) ont supprimé `xi_api_key` de `UserResponseModel`.
- `ResourceMetadataResponseModel.role_to_group_ids` accepte désormais des ID de rôle personnalisés comme clés au lieu de limiter les clés à `admin`, `editor`, `commenter` et `viewer`.
- Les réponses de publication directe ajoutent `restricted_to_user_email_domains` facultatif et nullable (tableau de chaînes).
- Les réponses de changement d’abonnement en attente ajoutent `go` à `next_tier`.

</Accordion>