ElevenAgents

  • Anulación de rama y entorno de WhatsApp: Los mensajes salientes de WhatsApp y las llamadas salientes ahora respetan branch_id y environment enviados en conversation_initiation_client_data. Las anulaciones se validan antes de enviar nada —una rama o entorno desconocidos se rechazan con un error— y se mantienen durante la conversación, por lo que la respuesta de un cliente se reanuda en la rama y el entorno solicitados. Consulta la guía de WhatsApp para ver ejemplos.
  • API de procedimientos: Hemos añadido ocho operaciones públicas, limitadas al ámbito de cada rama, para gestionar procedimientos. Puedes crear, listar, recuperar y eliminar procedimientos; crear, recuperar o descartar cambios de borradores; y compilar borradores de procedimientos en un workflow de agente. La creación de procedimientos acepta name, content, type y trigger. Un trigger vacío crea un subprocedimiento, mientras que un trigger omitido o null se deriva del contenido del procedimiento.
  • Tareas de rastreo de la base de conocimientos: Hemos añadido API para crear, listar, inspeccionar y cancelar tareas de rastreo. Las solicitudes de creación requieren url (cadena) y admiten profundidad de rastreo, límites de páginas, patrones de URL, URL de mapas del sitio, ubicación en carpetas, sincronización automática y eliminación de documentos no disponibles.
  • Gestión masiva de la base de conocimientos: Hemos añadido comprobaciones masivas de dependencias y eliminación masiva para 1–20 ID únicos de documentos o carpetas. Las comprobaciones de dependencias admiten paginación y dependent_type; la eliminación devuelve un éxito o error independiente para cada ID. Establecer force: true también elimina las dependencias y borra recursivamente las carpetas no vacías.
  • Exportación de resultados de llamadas por lotes: Hemos añadido Exportar resultados de llamadas por lotes para descargar como CSV los destinatarios y resultados de conversaciones de un lote finalizado.
  • Filtros de conversaciones y datos de análisis: Listar conversaciones y Búsqueda de texto en mensajes de conversaciones añaden los filtros opcionales de matriz visited_agent_ids y visited_agent_branch_ids, limitados a 50 valores cada uno. Las solicitudes de lista también aceptan data_collection_ids y evaluation_criteria_ids para incluir los resultados correspondientes en cada resumen de conversación. Los resúmenes añaden data_collection_results, evaluation_criteria_results y tag_ids opcionales.
  • Configuración de análisis por referencia: La configuración de plataforma de agentes añade el campo opcional y anulable analysis_items, de tipo AgentAnalysisItems, para adjuntar por referencia elementos de evaluación y recopilación de datos. Un valor null indica que el agente sigue usando los campos heredados en línea; un valor vacío indica un agente migrado sin elementos adjuntos.
  • Metadatos de dependencias de procedimientos: Las referencias a procedimientos añaden trigger (cadena) y matrices para referenced_tool_ids, referenced_kb_ids, referenced_procedure_ids y referenced_dynamic_variables.
  • Respuesta de token WebRTC: Las respuestas de Obtener token WebRTC ahora requieren conversation_id (cadena) además de token. Este es un cambio incompatible de esquema para clientes que validan o deserializan la estructura de la respuesta.
  • Resultados RAG de la base de conocimientos: KnowledgeBaseRagToolResultModel añade chunks (KnowledgeBaseRagChunkModel[]) para el modo de resultado RAG en resultado de herramienta.

Studio

  • Estado de proyecto de borrador: ProjectCreationMetaResponseModel.status añade draft. El tipo de creación de proyecto ahora usa la enumeración compartida ProjectCreationMetaType con los mismos valores existentes.

Voces

  • Acentos de voz: Hemos añadido GET /v1/voices/accents para listar los acentos disponibles en la biblioteca de voces compartidas. Los resultados se pueden filtrar por language y model_id, y cada acento devuelve accent, language, code y el name legible. El valor accent se puede pasar al parámetro de consulta accent en Obtener voces compartidas para filtrar voces compartidas.

Espacios de trabajo

  • Informes de uso de webhooks: WebhookUsageType añade Flows.

Lanzamientos de SDK

SDK de JavaScript

  • v2.60.0 - Se ha añadido voices.accents.get para listar acentos de voz en la biblioteca de voces compartidas, junto con las API de procedimientos de ElevenAgents, tareas de rastreo y gestión masiva de la base de conocimientos, y la configuración de análisis por referencia del esquema más reciente.

SDK de Python

  • v2.60.0 - Se han añadido las API de acentos de voz, procedimientos de ElevenAgents, tareas de rastreo y gestión masiva de la base de conocimientos del esquema más reciente. También se ha corregido el inicio de AsyncConversation para que ya no se bloquee y se han corregido los campos multipart de listas de valores primitivos para que se envíen como campos de formulario repetidos.

Paquetes

API

Nuevas rutas

ElevenAgents

  • POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
    • Crea un procedimiento y devuelve su procedure_id (cadena)
    • Acepta name opcional (cadena, máximo 200 caracteres), content (cadena), type (ProcedureType, valor predeterminado free_form) y trigger (cadena anulable)
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
    • Lista los procedimientos de la rama con procedure_id, version_id, name, type, trigger y has_draft
    • Excluye el contenido del procedimiento; recupera un procedimiento individual para leer su contenido
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
    • Acepta version_id opcional (cadena); de lo contrario, devuelve la versión en la cabecera de la rama
    • Devuelve name, content, type y trigger
  • DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
    • Elimina el procedimiento del conjunto de trabajo de borradores de la rama
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Devuelve el borrador actual del procedimiento
  • PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Crea o actualiza un borrador
    • Requiere name (cadena, máximo 200 caracteres), content (cadena, máximo 50.000 caracteres) y type (ProcedureType); acepta trigger opcional (cadena anulable)
  • DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Descarta los cambios del borrador y restablece el procedimiento a su versión confirmada
  • POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/compile
    • Compila borradores de procedimientos en un AgentWorkflowResponseModel
  • Crear tarea de rastreo - POST /v1/convai/knowledge-base/crawl
    • Requiere url (cadena)
    • Acepta max_depth opcional (entero, 1–5, valor predeterminado 3), max_pages (entero, 1–10.000, valor predeterminado 1000), pattern (cadena), sitemap_urls (matriz de cadenas), parent_folder_id (cadena), enable_auto_sync (booleano, valor predeterminado false) y auto_remove (booleano, valor predeterminado false)
  • Listar tareas de rastreo - GET /v1/convai/knowledge-base/crawl
    • Acepta include_job_ids opcional (matriz de cadenas), page_size (entero, 1–100, valor predeterminado 30) y cursor (cadena)
  • Obtener tarea de rastreo - GET /v1/convai/knowledge-base/crawl/{crawl_job_id}
  • Cancelar tarea de rastreo - POST /v1/convai/knowledge-base/crawl/{crawl_job_id}/cancel
  • Obtener agentes dependientes para varios documentos - POST /v1/convai/knowledge-base/dependent-agents
    • Requiere document_ids (matriz de 1–20 cadenas únicas)
    • Acepta dependent_type opcional (KnowledgeBaseDependentType, valor predeterminado all), page_size (entero, 1–100, valor predeterminado 30) y cursor (cadena)
  • Eliminar documentos de la base de conocimientos de forma masiva - POST /v1/convai/knowledge-base/bulk-delete
    • Requiere document_ids (matriz de 1–20 cadenas únicas)
    • Acepta force opcional (booleano, valor predeterminado false)
    • Devuelve un resultado de éxito o error para cada ID de documento
  • Exportar resultados de llamadas por lotes - GET /v1/convai/batch-calling/{batch_id}/export
    • Devuelve como CSV los destinatarios y resultados de conversaciones de un lote finalizado

Voces

  • GET /v1/voices/accents
    • Lista los acentos disponibles en la biblioteca de voces compartidas
    • Acepta los parámetros de consulta opcionales language (cadena) y model_id (cadena)
    • Cada acento devuelve accent, language, code y name

Rutas actualizadas

ElevenAgents

  • Listar conversaciones - GET /v1/convai/conversations
    • Se han añadido los filtros opcionales de matriz de cadenas visited_agent_ids y visited_agent_branch_ids, limitados a 50 valores cada uno
    • Se han añadido las matrices de cadenas opcionales data_collection_ids y evaluation_criteria_ids para seleccionar resultados de análisis para cada resumen
    • Los resúmenes de respuesta añaden los campos de objeto opcionales data_collection_results y evaluation_criteria_results, además de la matriz de cadenas tag_ids
  • Búsqueda de texto en mensajes de conversaciones - GET /v1/convai/conversations/messages/text-search
    • Se han añadido los filtros opcionales de matriz de cadenas visited_agent_ids y visited_agent_branch_ids, limitados a 50 valores cada uno
  • Obtener token WebRTC - GET /v1/convai/conversation/token
    • Las respuestas ahora requieren conversation_id (cadena)
    • Cambio incompatible: los validadores y deserializadores estrictos de respuestas deben aceptar el nuevo campo obligatorio

Cambios de esquema

ElevenAgents

  • La configuración de solicitudes y respuestas de la plataforma de agentes añade el campo opcional y anulable analysis_items, de tipo AgentAnalysisItems, para la configuración de evaluación y recopilación de datos por referencia
  • Las referencias a procedimientos añaden trigger (cadena), referenced_tool_ids (matriz de cadenas), referenced_kb_ids (matriz de cadenas), referenced_procedure_ids (matriz de cadenas) y referenced_dynamic_variables (matriz de cadenas)
  • KnowledgeBaseRagToolResultModel añade chunks (KnowledgeBaseRagChunkModel[])

Studio

  • ProjectCreationMetaResponseModel.status añade draft
  • ProjectCreationMetaResponseModel.type ahora hace referencia a la enumeración compartida ProjectCreationMetaType

Espacios de trabajo

  • WebhookUsageType añade Flows