Changelog

February 16, 2026

ElevenAgents

  • Endpoint de usuários de conversas: Adicionado o endpoint Obter usuários de conversas (GET /v1/convai/users) para listar usuários que tiveram conversas com seus agentes. Compatível com paginação e filtragem por agente, intervalo de tempo e outros critérios.
  • Versionamento de agentes: Busque configurações específicas de agentes por versão usando os novos parâmetros de consulta version_id e branch_id no endpoint Obter agente. O endpoint Atualizar agente agora também aceita um parâmetro branch_id para atualizações específicas de uma ramificação.
  • Ferramenta de busca na documentação: Adicionado search_documentation como uma nova ferramenta de sistema integrada para RAG (geração aumentada por recuperação). Configure a recuperação de múltiplas fontes com os esquemas MultiSourceConfigJson, SourceConfigJson e SourceRetrievalConfig. Compatível com estratégias de mesclagem configuráveis pelo enum MergingStrategy.
  • Suporte a ferramentas MCP: Adicionado mcp como um novo tipo de ferramenta, junto com ferramentas de webhook, cliente e sistema. Configure ferramentas MCP usando o novo esquema MCPToolConfig nas definições de ferramentas do seu agente.
  • Proteções de conteúdo: Adicionadas proteções de moderação de conteúdo ao GuardrailsV1, com limites configuráveis para diferentes categorias de conteúdo: sexual, violência, assédio, automutilação, palavrões, religião/política e conteúdo médico/jurídico. Use os novos esquemas ContentGuardrail e ContentConfig.
  • Modo expressivo: Adicionado o campo expressive_mode (booleano) aos esquemas de configuração de agentes para orientar automaticamente seu agente a aproveitar ao máximo o novo modelo conversacional v3.
  • Dígitos pós-discagem: As transferências de números de telefone agora aceitam post_dial_digits para enviar tons DTMF após a conexão. Configurável como valores estáticos ou variáveis dinâmicas.
  • Tipos de teste de agentes: Os testes de agentes agora aceitam três tipos distintos de teste com esquemas dedicados: llm (avaliação de resposta), tool (verificação de chamada de ferramenta) e simulation (simulação completa de conversa). Os testes de simulação incluem os campos de configuração simulation_scenario e simulation_max_turns.

Dicionários de pronúncia

  • Regras na resposta da API: O endpoint Obter dicionário de pronúncia agora retorna um array rules com detalhes completos das regras. A resposta usa o novo esquema GetPronunciationDictionaryWithRulesResponseModel, com PronunciationDictionaryAliasRuleResponseModel e PronunciationDictionaryPhonemeRuleResponseModel para os tipos de regra.

Base de conhecimento

  • Exclusão de pastas: O endpoint Excluir documento da base de conhecimento agora permite excluir pastas além de documentos. Ao excluir pastas, defina force=true para ativar a exclusão recursiva de todos os documentos e subpastas contidos.

Lançamentos de SDKs

SDK Python

  • v2.36.0 - Adicionados endpoint de usuários de conversas, versionamento de agentes, ferramenta de busca na documentação, suporte a ferramentas MCP, proteções de conteúdo e tipos de teste de agentes

SDK JavaScript

  • v2.36.0 - Adicionadas assinaturas sobrecarregadas de convert a speechToText.convert() para melhorar a inferência de tipos com base nos parâmetros da solicitação (acesse .text, .transcripts ou campos de webhook sem estreitamento manual de tipo), além de endpoint de usuários de conversas, versionamento de agentes, ferramenta de busca na documentação, suporte a ferramentas MCP, proteções de conteúdo e tipos de teste de agentes

Pacotes de widget

  • @elevenlabs/convai-widget-core@0.9.0 - Adicionados indicador de status de uso de ferramentas pelo agente e novo selo de status para chamadas de ferramentas de longa duração; corrigida a remoção de tags de emoção e o envio de avaliações e feedback para incorporação de widget por URL assinada
  • @elevenlabs/convai-widget-embed@0.9.0 - Adicionados indicador de status de uso de ferramentas pelo agente e novo selo de status para chamadas de ferramentas de longa duração; corrigida a remoção de tags de emoção

API

Novos endpoints

Endpoints atualizados

ElevenAgents

  • Obter agente
    • Adicionado o parâmetro de consulta version_id (string, opcional) para buscar uma versão específica do agente
    • Adicionado o parâmetro de consulta branch_id (string, opcional) para buscar de uma ramificação específica
  • Atualizar agente
    • Adicionado o parâmetro de consulta branch_id (string, opcional) para atualizações específicas de uma ramificação
  • Criar agente
    • Adicionado search_documentation às ferramentas de sistema com configuração RAG de múltiplas fontes
    • Adicionado o tipo de ferramenta mcp ao discriminador de ferramentas
    • Adicionado o campo content ao GuardrailsV1 para proteções de moderação de conteúdo
    • Adicionado o campo expressive_mode (booleano) à configuração do agente
  • Criar teste de agente, Atualizar teste de agente, Obter teste de agente
    • Alterados para esquemas de união discriminada com o campo type (llm, tool, simulation)
    • Adicionados os campos simulation_scenario e simulation_max_turns para testes de simulação

Dicionários de pronúncia

Base de conhecimento

Alterações de esquema

Novos esquemas

  • GetPronunciationDictionaryWithRulesResponseModel - Modelo de resposta com array de regras incorporado
  • PronunciationDictionaryAliasRuleResponseModel - Regra de alias com string_to_replace e alias
  • PronunciationDictionaryPhonemeRuleResponseModel - Regra de fonema com string_to_replace, phoneme e alphabet
  • MultiSourceConfigJson - Configuração RAG de múltiplas fontes
  • SourceConfigJson - Configuração individual de fonte para RAG
  • SourceRetrievalConfig - Configuração de recuperação para fontes RAG
  • MergingStrategy - Enum para estratégias de mesclagem de resultados RAG
  • MCPToolConfig - Configuração para ferramentas MCP
  • ContentGuardrail-Input, ContentGuardrail-Output - Configuração de proteção de moderação de conteúdo
  • ContentConfig - Configuração de limites por categoria de conteúdo
  • TestType - Enum com os valores llm, tool, simulation
  • CreateAgentTestResponseModel - Resposta para criação de teste
  • LLMResponseTest*, ToolCallTest*, SimulationTest* - Esquemas de teste por tipo que substituem os modelos legados Create/Get/UpdateUnitTest*

Esquemas modificados

  • GuardrailsV1-Input, GuardrailsV1-Output - Adicionado o campo content para proteções de conteúdo
  • AgentConfig - Adicionado o campo expressive_mode (booleano)
  • PhoneNumberTransferConfig - Adicionado o campo post_dial_digits (string ou variável dinâmica)
  • DistributionTerritories - Restrição de itens flexibilizada para permitir strings de território arbitrárias