Changelog

March 23, 2026

ElevenAgents

  • API de variáveis de ambiente: Novos endpoints de variáveis de ambiente para gerenciar configurações no nível do workspace que os agentes podem consultar em tempo de execução por meio de templates {{system_env__<label>}}. Compatível com tipos de variável string, secreta e de conexão de autenticação, com substituições de valores por ambiente. Os endpoints incluem criar, listar, obter e atualizar.

  • Gerenciamento de conexões de autenticação: Nova API de conexões de autenticação no nível do workspace para gerenciar credenciais de autenticação usadas por ferramentas e integrações de agentes. Compatível com vários métodos de autenticação, incluindo credenciais de cliente OAuth2, JWT, autenticação básica, tokens bearer, cabeçalhos personalizados e fluxos de código de autorização OAuth2 gerenciados por integração. Os endpoints incluem operações de criação, listagem e exclusão.

  • Atualização de URL da Base de conhecimento: Novo endpoint de atualização (POST /v1/convai/knowledge-base/{documentation_id}/refresh) para buscar novamente e atualizar o conteúdo de documentos da Base de conhecimento originados de URLs. Os documentos da Base de conhecimento agora também aceitam configuração de sincronização automática com os campos enable_auto_sync, auto_remove e auto_sync_info.

  • Nova tentativa de guardrail com feedback: Guardrails personalizados e de conteúdo agora aceitam ações de acionamento configuráveis com as opções EndCallTriggerAction e RetryTriggerAction. Quando configurado para tentar novamente, o agente gera uma nova resposta com feedback do sistema inserido, em até 3 tentativas. Os placeholders disponíveis incluem {{trigger_reason}} e {{agent_message}} para orientações contextuais de nova tentativa.

  • Variável de sistema do histórico de conversas: Adicionamos uma nova variável dinâmica system__conversation_history que fornece um histórico de conversas serializado em JSON, avaliado sob demanda, em tempo de execução. Isso é útil para passar o contexto completo da conversa para ferramentas, webhooks ou transferências para subagentes.

  • Tipo de conteúdo da ferramenta de webhook: As ferramentas de servidor agora aceitam um tipo de conteúdo configurável para parâmetros do corpo do webhook, permitindo escolher entre os formatos application/json e application/x-www-form-urlencoded. O formato codificado em URL é útil para integração com sistemas legados, endpoints de token OAuth e processadores de pagamento.

  • Mensagens enviadas pelo WhatsApp: Atualizamos a integração com o WhatsApp com um novo diálogo de mensagens enviadas no dashboard, permitindo que os agentes enviem mensagens, além de fazer chamadas, pelo canal do WhatsApp.

  • Filtros de listagem de agentes e recursos: Os endpoints listar agentes, listar documentos da Base de conhecimento e listar ferramentas agora aceitam um parâmetro de consulta created_by_user_id (use @me para o usuário atual). Os parâmetros anteriores show_only_owned_agents e show_only_owned_documents foram descontinuados.

  • Expressões condicionais de workflow: Adicionamos um novo nó AST conditional_operator ao esquema de expressões de workflow, permitindo lógica de ramificação nas definições de workflow de agentes.

Música

  • Music Marketplace: Nova documentação do Music Marketplace, que aborda o marketplace para licenciar músicas geradas por IA, incluindo tipos de uso, pagamentos a criadores e detalhes de licenciamento.

Lançamentos de SDKs

SDK Python

  • v2.40.0 - Adicionado suporte ao parâmetro environment para conversas do ElevenAgents, permitindo conexões de agentes específicas por ambiente. Regeneração do Fern para corresponder ao esquema de API mais recente, incluindo variáveis de ambiente, conexões de autenticação, atualização da Base de conhecimento e ações de acionamento de guardrail.

SDK JavaScript

  • v2.40.0 - Adicionado o tipo de evento WebSocket multimodal_message para conversas em tempo real do ElevenAgents. Regeneração do Fern para corresponder ao esquema de API mais recente, incluindo variáveis de ambiente, conexões de autenticação, atualização da Base de conhecimento e ações de acionamento de guardrail.

SDK iOS

  • v3.1.1 - Adicionado suporte ao parâmetro environment para conexões de agentes específicas por ambiente. Corrigido um erro de compilação do visionOS ao atualizar o requisito da plataforma para v2.

Pacotes

Candidato a lançamento dos pacotes v1.0.0

O primeiro candidato a lançamento da v1.0.0 dos SDKs de cliente do ElevenAgents já está disponível. Este é um grande lançamento com alterações incompatíveis que melhoram a superfície da API, adicionam hooks granulares do React para melhor desempenho de renderização e unificam o SDK React Native com o SDK React.

Para testar o candidato a lançamento:

npm install @elevenlabs/client@next @elevenlabs/react@next @elevenlabs/react-native@next

Uma skill elevenlabs:sdk-migration está disponível para ajudar assistentes de programação com IA a migrar automaticamente sua base de código para as novas APIs. Adicione-a ao seu projeto no Claude Code, Cursor ou Windsurf para receber suporte guiado à migração.

Principais mudanças na v1.0.0:

  • @elevenlabs/client: Conversation agora é um objeto de namespace e alias de tipo para TextConversation | VoiceConversation, em vez de uma classe. As classes Input e Output foram substituídas pelas interfaces InputController e OutputController, com novos métodos de conveniência na instância de conversa (setMicMuted(), setVolume(), getInputByteFrequencyData(), getOutputByteFrequencyData()). changeInputDevice() e changeOutputDevice() agora retornam void.
  • @elevenlabs/react: useConversation agora exige um ancestral ConversationProvider. Novos hooks granulares para re-renderização detalhada: useConversationControls(), useConversationStatus(), useConversationInput(), useConversationMode(), useConversationFeedback(). Novo hook useConversationClientTool() para registrar dinamicamente ferramentas de cliente a partir de componentes React com total segurança de tipos.
  • @elevenlabs/react-native: Reescrita completa da API, substituindo ElevenLabsProvider e useConversation por ConversationProvider e os mesmos hooks granulares de @elevenlabs/react. Polyfills de WebRTC e a configuração nativa de AudioSession são aplicados automaticamente na importação.

Veja as notas de lançamento completas e os guias de migração:

API

Novos endpoints

ElevenAgents

  • Criar variável de ambiente - POST /v1/convai/environment-variables - Crie uma nova variável de ambiente com tipo string, secreto ou de conexão de autenticação
  • Listar variáveis de ambiente - GET /v1/convai/environment-variables - Liste todas as variáveis de ambiente no workspace
  • Obter variável de ambiente - GET /v1/convai/environment-variables/{env_var_id} - Obtenha uma variável de ambiente específica
  • Atualizar variável de ambiente - PATCH /v1/convai/environment-variables/{env_var_id} - Atualize uma variável de ambiente, incluindo a remoção de valores por ambiente via null
  • Atualizar conteúdo de documento por URL - POST /v1/convai/knowledge-base/{documentation_id}/refresh - Busque novamente o conteúdo de documentos da Base de conhecimento originados de URLs

Workspaces

  • POST /v1/workspace/auth-connections - Crie uma conexão de autenticação do workspace com suporte para OAuth2, JWT, autenticação básica, bearer, cabeçalho personalizado e métodos de autenticação gerenciados por integração
  • GET /v1/workspace/auth-connections - Liste todas as conexões de autenticação do workspace com informações de dependências (ferramentas, servidores MCP, conexões de integração)
  • DELETE /v1/workspace/auth-connections/{auth_connection_id} - Exclua uma conexão de autenticação do workspace

Speech to Text

  • GET /v1/speech-to-text/evaluation/eval-criteria - Liste critérios de avaliação
  • POST /v1/speech-to-text/evaluation/eval-criteria - Crie um critério de avaliação
  • GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Obtenha um critério de avaliação específico
  • PATCH /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Atualize um critério de avaliação
  • DELETE /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Exclua um critério de avaliação
  • POST /v1/speech-to-text/evaluation/evaluations - Acione uma avaliação
  • GET /v1/speech-to-text/evaluation/evaluations - Liste avaliações
  • GET /v1/speech-to-text/evaluation/evaluations/{evaluation_id} - Obtenha uma avaliação específica
  • GET /v1/speech-to-text/evaluation/human-agents - Liste agentes humanos
  • GET /v1/speech-to-text/evaluation/human-agents/{agent_id} - Obtenha um agente humano
  • DELETE /v1/speech-to-text/evaluation/human-agents/{agent_id} - Exclua um agente humano
  • GET /v1/speech-to-text/evaluation/analytics - Obtenha análises de avaliação
  • GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}/analytics - Obtenha análises de um critério específico
  • GET /v1/speech-to-text/evaluation/human-agents/{agent_id}/analytics - Obtenha análises de um agente humano específico

Endpoints atualizados

ElevenAgents

  • Obter URL assinada, Obter token de conversa

    • Adicionado o parâmetro de consulta environment (string, opcional) para resolução específica por ambiente

  • Listar agentes

    • Adicionado o parâmetro de consulta created_by_user_id (string, opcional, aceita @me)
    • show_only_owned_agents foi descontinuado em favor de created_by_user_id

  • Listar documentos da Base de conhecimento

    • Adicionado o parâmetro de consulta created_by_user_id (string, opcional, aceita @me)
    • show_only_owned_documents foi descontinuado em favor de created_by_user_id

  • Listar ferramentas

    • Adicionado o parâmetro de consulta created_by_user_id (string, opcional, aceita @me)
    • show_only_owned_documents foi descontinuado em favor de created_by_user_id

  • Obter trecho da Base de conhecimento

    • Adicionado o parâmetro de consulta embedding_model (string, opcional) para especificar o modelo de embedding para recuperação de trechos

  • Criar agente, Atualizar agente, Criar rascunho

    • Adicionado suporte a guardrail_trigger_action com os esquemas EndCallTriggerAction e RetryTriggerAction
    • Adicionado o nó AST conditional_operator às definições de expressões de workflow
    • Os esquemas de agentes agora aceitam ConvAIEnvVarLocator e EnvironmentAuthConnectionLocator para referenciar variáveis de ambiente em configurações de ferramentas

  • Chamada de saída via tronco SIP

    • Esquema da solicitação atualizado para acomodar novos campos relacionados ao ambiente

  • Simular conversa, Simular stream de conversa

    • Adicionado o campo simulation_environment ao esquema da solicitação

Alterações de esquema

Novos esquemas

  • ConvAIEnvironmentVariable, ConvAIEnvironmentVariableCreate, ConvAIEnvironmentVariableUpdate - Modelos de variáveis de ambiente compatíveis com tipos string, secreto e de conexão de autenticação
  • ConvAIEnvVarLocator, EnvironmentAuthConnectionLocator - Localizadores para referenciar variáveis de ambiente em configurações de ferramentas e servidores MCP
  • EndCallTriggerAction, RetryTriggerAction - Esquemas de ação de acionamento de guardrail para comportamentos de encerramento de chamada e nova tentativa com feedback
  • ConditionalOperator - Novo nó AST para expressões condicionais em workflows de agentes
  • AuthConnectionCreateRequest, AuthConnectionResponse, AuthConnectionDependencies - Esquemas de gerenciamento de conexões de autenticação do workspace com suporte para OAuth2, JWT, autenticação básica, bearer, cabeçalho personalizado, WhatsApp e métodos de autenticação gerenciados por integração
  • SpeechToTextEvaluation* - Conjunto de esquemas para critérios de avaliação de Speech to Text, avaliações, agentes humanos e análises

Esquemas modificados

  • MCPServerConfig, MCPServerConfigOutput - Adicionado suporte a referências ConvAIEnvVarLocator na configuração do servidor
  • CustomGuardrailConfig - Adicionado o campo trigger_action para configurar o comportamento de encerramento de chamada ou nova tentativa
  • Contributor - Adicionados os campos opcionais bio (string) e profile_id (string)
  • ASTLLMNode - Adicionado o campo value_schema; o campo prompt foi descontinuado em favor de value_schema
  • TelephonyDirection - Refatorado para uma enumeração compartilhada referenciada por vários modelos de conversa e telefonia