Changelog

July 28, 2025

Espaços de trabalho

  • Gerenciamento de chaves de API de contas de serviço: Adicionamos endpoints abrangentes de API para gerenciar chaves de API de contas de serviço, incluindo recursos de criação, recuperação, atualização e exclusão. Consulte a documentação sobre Contas de Serviço.

Plataforma de Agentes

  • Migração de webhook pós-chamada: O formato do webhook pós-chamada está sendo migrado para que os manipuladores de webhook possam ser gerados automaticamente nos SDKs. Esta não é uma alteração incompatível e nenhuma ação adicional é necessária se o seu manipulador atual aceitar campos adicionais. Consulte mais informações aqui.
  • Melhorias na transferência de agentes: Corrigimos a variável de sistema system_agent_id para que seja atualizada corretamente após transferências entre agentes, garantindo o acompanhamento preciso do contexto da conversa. Adicionamos a nova variável system_current_agent_id para acompanhar o agente ativo atual. Saiba mais sobre variáveis dinâmicas.
  • Página pública de agente aprimorada: Adicionamos funcionalidade de entrada de texto e suporte a variáveis dinâmicas à página pública para conversar com o agente. Agora você pode transmitir variáveis dinâmicas por parâmetros de URL (por exemplo, ?var_username=value) e usar a entrada de texto durante conversas por voz. Consulte o guia de variáveis dinâmicas.
  • Detecção de caixa postal: Adicionamos a detecção de caixa postal como uma ferramenta integrada para agentes da ElevenLabs, melhorando o atendimento de chamadas. Saiba mais sobre a detecção de caixa postal.
  • Filtragem de conversas: Adicionamos o parâmetro de consulta user_id ao endpoint de lista de conversas para filtrar conversas por usuário que as iniciou.

Speech to Text

  • Transcrição multicanal: Adicionamos o parâmetro use_multi_channel ao endpoint de transcrição para processar arquivos de áudio com vários falantes em canais separados. Oferece suporte a até 5 canais com resultados de transcrição por canal. Consulte o guia multicanal.

ElevenCreative Studio

  • Suporte a legendas: Adicionamos a funcionalidade de legendas aos projetos do ElevenCreative Studio com as novas propriedades captions_enabled e caption_style para podcasts e projetos gerais. Saiba mais sobre o ElevenCreative Studio.

SDKs

Atualizações do esquema da API

Novos endpoints

  • Gerenciamento de contas de serviço: Adicionados 5 novos endpoints para gerenciar chaves de API de contas de serviço:
    • GET /v1/service-accounts/{service_account_user_id}/api-keys - Recuperar chaves de API da conta de serviço
    • POST /v1/service-accounts/{service_account_user_id}/api-keys - Criar chave de API da conta de serviço
    • DELETE /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id} - Excluir chave de API da conta de serviço
    • PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id} - Atualizar chave de API da conta de serviço
    • GET /v1/service-accounts - Obter contas de serviço do espaço de trabalho

Endpoints removidos

  • Endpoints de projetos legados: Removidos 22 endpoints descontinuados de gerenciamento de projetos como parte da consolidação da API do ElevenCreative Studio:
    • Todos os endpoints /v1/projects/* (substituídos por /v1/studio/projects/*)
    • Endpoints legados de Texto para Voz (/v1/text-to-voice/create-voice-from-preview, /v1/text-to-voice/remixing-sessions/*)
    • Endpoints legados da base de conhecimento ConvAI

Endpoints atualizados

Speech to Text

  • Suporte multicanal: Atualizado o endpoint /v1/speech-to-text:
    • Adicionado o parâmetro use_multi_channel para processar arquivos de áudio com vários falantes
    • Modificada a estrutura de resposta para incluir as propriedades opcionais language_code, language_probability, text e words

Plataforma de Agentes

  • Configuração de agente aprimorada: Atualizados os endpoints de criação e gerenciamento de agentes:
    • Adicionada detecção de caixa postal às ferramentas integradas
    • Configuração de RAG aprimorada com o parâmetro max_retrieved_rag_chunks_count
    • Endpoint de token de conversa aprimorado com os parâmetros source e version
    • Adicionada filtragem por user_id ao endpoint de lista de conversas

Projetos do ElevenCreative Studio

  • Suporte a legendas: Atualizados os endpoints de projetos do ElevenCreative Studio para incluir:
    • Propriedade captions_enabled para ativar/desativar legendas
    • Propriedade caption_style para configuração global de estilo das legendas

Texto para Voz

  • Geração de voz aprimorada: Endpoints de criação de voz aprimorados com:
    • Controle de loudness (intervalo de -1 a 1, sendo que 0 corresponde a -24 LUFS)
    • Parâmetro quality para equilibrar qualidade de saída e variedade
    • Parâmetro guidance_scale para controlar a criatividade da IA e a aderência ao prompt