Changelog

Novos endpoints

• Buscar mensagens de conversas por texto - GET /v1/convai/conversations/messages/text-search - Realize uma busca de texto completo ou aproximada nas mensagens da transcrição da conversa
• Buscar mensagens de conversas de forma inteligente - GET /v1/convai/conversations/messages/smart-search - Realize uma busca semântica nas mensagens de conversas usando embeddings
• Listar LLMs disponíveis - GET /v1/convai/llm/list - Recupere LLMs disponíveis com informações de descontinuação, recursos e limites de contexto
• Enviar arquivo para conversa - POST /v1/convai/conversations/{conversation_id}/files - Envie arquivos para o contexto de uma conversa
• Excluir arquivo de conversa - DELETE /v1/convai/conversations/{conversation_id}/files/{file_id} - Remova um arquivo enviado de uma conversa

Endpoints removidos

Os seguintes endpoints legados de geração de voz foram removidos:

• GET /v1/voice-generation/generate-voice/parameters - Parâmetros de geração de voz
• POST /v1/voice-generation/generate-voice - Gerar uma voz aleatória
• POST /v1/voice-generation/create-voice - Criar uma voz gerada anteriormente

Use os endpoints Design de voz e Remix de voz em vez disso.

Endpoints atualizados

ElevenAgents

• Criar agente, Atualizar agente, Obter agente

  • Adicionado o campo coaching_settings para configuração de treinamento do agente
  • Adicionado conversation_history_redaction em platform_settings.privacy, com tipos de entidade configuráveis
  • Adicionadas novas proteções: focus e prompt_injection em platform_settings.guardrails
  • Removida a proteção alignment de platform_settings.guardrails
  • Adicionado qwen3_embedding_4b como opção de modelo de embedding na configuração RAG
  • Descrições de campos numéricos atualizadas para mais clareza sobre intervalos e valores padrão

• Criar servidor MCP, Atualizar servidor MCP, Obter servidor MCP

  • Adicionado o campo auth_connection (opcional) para ativar OAuth e métodos avançados de autenticação
  • Adicionado o campo secret_token ao endpoint PATCH para compatibilidade retroativa
  • A conexão de autenticação tem precedência sobre secret_token quando ambos são fornecidos

• Criar configuração de ferramenta MCP, Atualizar configuração de ferramenta MCP, Obter configuração de ferramenta MCP

  • Adicionado o campo input_overrides - permite substituir parâmetros de entrada da ferramenta por constantes, variáveis dinâmicas ou valores gerados por LLM

• Criar índice RAG, Excluir índice RAG

  • Adicionado qwen3_embedding_4b ao enum embedding_model

• Obter conversas

  • Descontinuado o parâmetro de consulta search (use os novos endpoints de busca dedicados)

• Obter conversa

  • Adicionado o campo hiding_reason para indicar por que uma conversa pode estar oculta
  • Entradas da transcrição da conversa estendidas para aceitar metadados file_input com o novo tipo ChatSourceMedium (áudio, texto, imagem, arquivo)

• Simular conversa, Transmitir simulação de conversa

  • Todos os campos de configuração aninhados foram atualizados com descrições e intervalos de validação aprimorados

• Obter ramificações de agentes, Atualizar ramificação de agente

  • Descrição do campo current_live_percentage atualizada para mais clareza

• Obter configurações do ElevenAgents, Atualizar configurações do ElevenAgents

  • Campo rag_retention_period_days atualizado com uma descrição aprimorada

Espaços de trabalho

• Atualizar webhook

  • Adicionado o campo retry_enabled (booleano, opcional) - ativa novas tentativas automáticas para falhas transitórias (5xx, 429, tempo esgotado)

• Obter recurso do espaço de trabalho, Compartilhar recurso do espaço de trabalho, Cancelar compartilhamento de recurso do espaço de trabalho

  • Adicionado songs ao enum resource_type para permitir o compartilhamento de músicas no espaço de trabalho

• Obter usuário

  • Adicionado o campo obrigatório seat_type com valores de enum: workspace_admin, workspace_member, workspace_lite_member

Música

• Gerar música, Gerar música detalhada, Transmitir música
  • Descrição do parâmetro seed esclarecida: Semente aleatória para inicialização da geração de música. Fornecer a mesma semente com parâmetros idênticos ajuda a obter resultados mais consistentes, mas a reprodutibilidade exata não é garantida e as saídas podem mudar entre atualizações do sistema. Não pode ser usado com o parâmetro prompt.

Texto para voz

• Criar prévias de voz, Criar voz, Remixar voz
  • Descrição do parâmetro loudness atualizada: Controla o nível de volume da voz gerada. -1 é o mais baixo, 1 é o mais alto e 0 corresponde a aproximadamente -24 LUFS
  • Descrição do parâmetro guidance_scale atualizada: Controla o quanto a IA segue o prompt. Números menores dão à IA mais liberdade para criar, enquanto números maiores fazem com que ela siga mais o prompt. Números altos podem deixar a voz artificial ou robótica. Prompts mais longos e detalhados funcionam melhor com uma escala de orientação menor.
  • Descrição do parâmetro quality atualizada para a criação de prévias de voz

Vozes

• Obter vozes, Obter configurações de voz, Obter configurações de voz padrão, Editar configurações de voz
  • Descrição do parâmetro style atualizada: Determina a exageração do estilo da voz. Tenta amplificar o estilo do falante original. Consome recursos computacionais adicionais e pode aumentar a latência se definido como qualquer valor diferente de 0
  • Descrição do parâmetro speed atualizada: Ajusta a velocidade da voz. 1.0 é o padrão, valores menores que 1.0 desaceleram a fala e valores maiores que 1.0 a aceleram