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_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 - 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 keyterms de Speech to Text et webhook_ids de Dubbing.

SDK Swift

  • 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

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 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 - 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 requiert qa_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 accepte status facultatif et assignee_user_id nullable.
    • 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 requiert comment (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 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 - 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 - 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 - 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 - 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 - 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 (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_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 et Mettre à jour un test
    • 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, Créer une tâche d’exploration et Créer un dossier
    • 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

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