ElevenAgents

  • Remplacements de branche et d’environnement WhatsApp : les messages WhatsApp sortants et les appels sortants respectent désormais branch_id et environment transmis dans conversation_initiation_client_data. Les remplacements sont validés avant tout envoi, une branche ou un environnement inconnu est rejeté avec une erreur, et ils persistent pour la conversation. Ainsi, la réponse d’un client reprend sur la branche et l’environnement demandés. Consultez le guide WhatsApp pour des exemples.
  • API de procédures : ajout de huit opérations publiques limitées à une branche pour gérer les procédures. Vous pouvez créer, lister, récupérer et supprimer des procédures, créer, récupérer ou abandonner des modifications de brouillon, et compiler des brouillons de procédure dans un workflow d’agent. La création d’une procédure accepte name, content, type et trigger. Un trigger vide crée une sous-procédure, tandis qu’un déclencheur omis ou défini sur null est déduit du contenu de la procédure.
  • Tâches de crawl de la base de connaissances : ajout d’API pour créer, lister, inspecter et annuler des tâches de crawl. Les requêtes de création nécessitent url (chaîne) et prennent en charge la profondeur de crawl, les limites de pages, les modèles d’URL, les URL de sitemap, le placement dans des dossiers, la synchronisation automatique et la suppression des documents indisponibles.
  • Gestion groupée de la base de connaissances : ajout de vérifications groupées des dépendances et de suppression groupée pour 1 à 20 ID uniques de documents ou de dossiers. Les vérifications de dépendances prennent en charge la pagination et dependent_type ; la suppression renvoie une réussite ou un échec indépendant pour chaque ID. Définir force: true supprime également les dépendances et efface récursivement les dossiers non vides.
  • Export des résultats d’appels par lot : ajout d’Exporter les résultats d’appels par lot pour télécharger au format CSV les destinataires et les résultats de conversation d’un lot terminé.
  • Filtres de conversation et données d’analyse : Lister les conversations et Rechercher du texte dans les messages de conversation ajoutent les filtres de tableau facultatifs visited_agent_ids et visited_agent_branch_ids, limités chacun à 50 valeurs. Les requêtes de liste acceptent également data_collection_ids et evaluation_criteria_ids pour inclure les résultats correspondants dans chaque résumé de conversation. Les résumés ajoutent data_collection_results, evaluation_criteria_results et tag_ids facultatifs.
  • Configuration d’analyse référencée : les paramètres de plateforme d’agent ajoutent le champ facultatif et nullable analysis_items, typé comme AgentAnalysisItems, pour associer par référence des éléments d’évaluation et de collecte de données. Une valeur null indique que l’agent utilise encore les champs intégrés hérités ; une valeur vide indique un agent migré sans éléments associés.
  • Métadonnées de dépendance des procédures : les références de procédure ajoutent trigger (chaîne) et des tableaux pour referenced_tool_ids, referenced_kb_ids, referenced_procedure_ids et referenced_dynamic_variables.
  • Réponse de jeton WebRTC : les réponses de Obtenir un jeton WebRTC nécessitent désormais conversation_id (chaîne) en plus de token. Il s’agit d’une modification de schéma incompatible pour les clients qui valident ou désérialisent la structure de réponse.
  • Résultats RAG de la base de connaissances : KnowledgeBaseRagToolResultModel ajoute chunks (KnowledgeBaseRagChunkModel[]) pour le mode résultat RAG dans le résultat d’outil.

Studio

  • Statut de projet brouillon : ProjectCreationMetaResponseModel.status ajoute draft. Le type de création de projet utilise désormais l’énumération partagée ProjectCreationMetaType avec les mêmes valeurs existantes.

Voix

  • Accents de voix : ajout de GET /v1/voices/accents pour lister les accents disponibles dans la bibliothèque de voix partagées. Les résultats peuvent être filtrés par language et model_id, et chaque accent renvoie son accent, sa language, son code et son name lisible par l’humain. La valeur accent peut être transmise au paramètre de requête accent de Obtenir les voix partagées pour filtrer les voix partagées.

Workspaces

  • Rapports d’utilisation des webhooks : WebhookUsageType ajoute Flows.

Versions des SDK

SDK JavaScript

  • v2.60.0 - Ajout de voices.accents.get pour lister les accents de voix dans la bibliothèque de voix partagées, ainsi que des API de procédures ElevenAgents, de tâches de crawl de la base de connaissances, de gestion groupée et de configuration d’analyse référencée du dernier schéma.

SDK Python

  • v2.60.0 - Ajout des API d’accents de voix, de procédures ElevenAgents, de tâches de crawl de la base de connaissances et de gestion groupée du dernier schéma. Correction également du démarrage de AsyncConversation, qui ne bloque plus, et des champs multipart de listes de primitives, désormais envoyés comme champs de formulaire répétés.

Packages

API

Nouveaux endpoints

ElevenAgents

  • POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
    • Crée une procédure et renvoie son procedure_id (chaîne)
    • Accepte name facultatif (chaîne, 200 caractères maximum), content (chaîne), type (ProcedureType, free_form par défaut) et trigger (chaîne nullable)
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
    • Liste les procédures de la branche avec procedure_id, version_id, name, type, trigger et has_draft
    • Exclut le contenu des procédures ; récupérez une procédure individuelle pour lire son contenu
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
    • Accepte version_id facultatif (chaîne) ; sinon, renvoie la version à la tête de la branche
    • Renvoie name, content, type et trigger
  • DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
    • Supprime la procédure de l’ensemble de travail brouillon de la branche
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Renvoie le brouillon actuel de la procédure
  • PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Crée ou met à jour un brouillon
    • Nécessite name (chaîne, 200 caractères maximum), content (chaîne, 50 000 caractères maximum) et type (ProcedureType) ; accepte trigger facultatif (chaîne nullable)
  • DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Abandonne les modifications du brouillon et réinitialise la procédure à sa version validée
  • POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/compile
    • Compile les brouillons de procédure dans un AgentWorkflowResponseModel
  • Créer une tâche de crawl - POST /v1/convai/knowledge-base/crawl
    • Nécessite url (chaîne)
    • Accepte max_depth facultatif (entier, 1 à 5, 3 par défaut), max_pages (entier, 1 à 10 000, 1000 par défaut), pattern (chaîne), sitemap_urls (tableau de chaînes), parent_folder_id (chaîne), enable_auto_sync (booléen, false par défaut) et auto_remove (booléen, false par défaut)
  • Lister les tâches de crawl - GET /v1/convai/knowledge-base/crawl
    • Accepte include_job_ids facultatif (tableau de chaînes), page_size (entier, 1 à 100, 30 par défaut) et cursor (chaîne)
  • Obtenir une tâche de crawl - GET /v1/convai/knowledge-base/crawl/{crawl_job_id}
  • Annuler une tâche de crawl - POST /v1/convai/knowledge-base/crawl/{crawl_job_id}/cancel
  • Obtenir les agents dépendants pour plusieurs documents - POST /v1/convai/knowledge-base/dependent-agents
    • Nécessite document_ids (tableau de 1 à 20 chaînes uniques)
    • Accepte dependent_type facultatif (KnowledgeBaseDependentType, all par défaut), page_size (entier, 1 à 100, 30 par défaut) et cursor (chaîne)
  • Supprimer en masse des documents de la base de connaissances - POST /v1/convai/knowledge-base/bulk-delete
    • Nécessite document_ids (tableau de 1 à 20 chaînes uniques)
    • Accepte force facultatif (booléen, false par défaut)
    • Renvoie un résultat de réussite ou d’échec pour chaque ID de document
  • Exporter les résultats d’appels par lot - GET /v1/convai/batch-calling/{batch_id}/export
    • Renvoie les destinataires et les résultats de conversation d’un lot terminé au format CSV

Voix

  • GET /v1/voices/accents
    • Liste les accents disponibles dans la bibliothèque de voix partagées
    • Accepte les paramètres de requête facultatifs language (chaîne) et model_id (chaîne)
    • Chaque accent renvoie accent, language, code et name

Endpoints mis à jour

ElevenAgents

  • Lister les conversations - GET /v1/convai/conversations
    • Ajout des filtres facultatifs de tableaux de chaînes visited_agent_ids et visited_agent_branch_ids, limités chacun à 50 valeurs
    • Ajout des tableaux de chaînes facultatifs data_collection_ids et evaluation_criteria_ids pour sélectionner les résultats d’analyse de chaque résumé
    • Les résumés de réponse ajoutent les champs d’objet facultatifs data_collection_results et evaluation_criteria_results, ainsi que le tableau de chaînes tag_ids
  • Rechercher du texte dans les messages de conversation - GET /v1/convai/conversations/messages/text-search
    • Ajout des filtres facultatifs de tableaux de chaînes visited_agent_ids et visited_agent_branch_ids, limités chacun à 50 valeurs
  • Obtenir un jeton WebRTC - GET /v1/convai/conversation/token
    • Les réponses nécessitent désormais conversation_id (chaîne)
    • Incompatible : les validateurs et désérialiseurs de réponse stricts doivent accepter le nouveau champ requis

Modifications de schéma

ElevenAgents

  • Les paramètres de requête et de réponse de la plateforme d’agent ajoutent le champ facultatif et nullable analysis_items, typé comme AgentAnalysisItems, pour une configuration d’évaluation et de collecte de données référencée
  • Les références de procédure ajoutent trigger (chaîne), referenced_tool_ids (tableau de chaînes), referenced_kb_ids (tableau de chaînes), referenced_procedure_ids (tableau de chaînes) et referenced_dynamic_variables (tableau de chaînes)
  • KnowledgeBaseRagToolResultModel ajoute chunks (KnowledgeBaseRagChunkModel[])

Studio

  • ProjectCreationMetaResponseModel.status ajoute draft
  • ProjectCreationMetaResponseModel.type référence désormais l’énumération partagée ProjectCreationMetaType

Workspaces

  • WebhookUsageType ajoute Flows