> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# 23 de fevereiro de 2026

### ElevenAgents

- **OAuth e autenticação avançada para servidores MCP**: Os servidores MCP agora aceitam conexões de autenticação do espaço de trabalho, permitindo OAuth2 Client Credentials, Basic Auth, Bearer Auth, JWT e autenticação por cabeçalho personalizado. Selecione uma conexão de autenticação ao criar ou editar um servidor MCP para gerenciar automaticamente a atualização de tokens e os cabeçalhos de autenticação. Consulte a [documentação de servidores MCP](/docs/pt/eleven-agents/customization/tools/mcp) para mais detalhes.
- **Endpoint de informações de LLM**: Adicionado um novo endpoint para listar LLMs disponíveis com status de descontinuação, recursos e limites de contexto. Isso permite que os clientes descubram programaticamente quais modelos estão disponíveis e quais estão sendo descontinuados. Consulte [Listar LLMs disponíveis](/docs/pt/api-reference/llm/list) para mais detalhes.
- **Ocultação de informações no histórico de conversas**: Adicionado suporte para ocultar informações sensíveis de transcrições, áudios e análises de conversas antes do armazenamento. Configure tipos específicos de entidade a ocultar, como nomes e endereços de e-mail, usando a nova configuração `conversation_history_redaction` na configuração de privacidade do agente. Consulte a [página da documentação](/docs/pt/eleven-agents/customization/privacy/conversation-history-redaction) para mais detalhes.
- **Proteções aprimoradas**: Introduzidos dois novos tipos de proteção para agentes:
  - `focus`: Ajuda a manter as conversas no assunto
  - `prompt_injection`: Detecta e impede tentativas de injeção de prompt
  - Observação: a proteção `alignment` foi removida
- **Endpoints de busca em conversas**: Adicionados dois novos endpoints para buscar mensagens de conversas:
  - [Busca textual](/docs/pt/api-reference/conversations/messages/text-search) - Busca de texto completo e aproximada nas mensagens da transcrição
  - [Busca inteligente](/docs/pt/api-reference/conversations/messages/search) - Busca semântica usando embeddings
- **Upload de arquivos em conversas**: Adicionados endpoints para enviar e gerenciar arquivos em conversas:
  - [Enviar arquivo](/docs/pt/api-reference/conversations/upload-file) - Envie arquivos para uma conversa
  - [Excluir arquivo](/docs/pt/api-reference/conversations/delete-file) - Remova arquivos enviados
- **Novo modelo de embedding**: Adicionado suporte ao modelo de embedding `qwen3_embedding_4b` na indexação RAG da base de conhecimento.

### Espaços de trabalho

- **Permissão para geração de imagens e vídeos**: Administradores do espaço de trabalho agora podem controlar o acesso aos recursos de geração de imagens e vídeos. Essa nova permissão permite restringir quais membros do espaço de trabalho podem usar esses recursos. Configure-a nas configurações do espaço de trabalho, em permissões de membros.

### Música

- **Compartilhamento no espaço de trabalho**: Agora é possível compartilhar músicas em espaços de trabalho. O tipo de recurso `songs` foi adicionado aos endpoints de compartilhamento de recursos do espaço de trabalho.

### Lançamentos de SDKs

#### SDK JavaScript

- [v2.36.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.36.0) - Adicionadas assinaturas de método `convert` sobrecarregadas ao wrapper de Speech to Text para melhorar a segurança de tipos e a usabilidade. SDK atualizado para incluir as alterações mais recentes no esquema da API, incluindo endpoint de listagem de LLMs, busca em conversas e suporte a conexão de autenticação MCP.

#### SDK Python

- [v2.36.1](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.36.1) - Adicionados parâmetros ausentes de geração de música, incluindo `seed`, `loudness`, `quality` e `guidance_scale`, para garantir paridade completa de recursos com a API.
- [v2.36.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.36.0) - Renomeadas as referências do pacote de "Conversational AI" para "ElevenAgents" para refletir a reformulação da marca do produto. SDK atualizado para incluir as alterações mais recentes no esquema da API, incluindo endpoint de listagem de LLMs, busca em conversas e suporte a conexão de autenticação MCP.

#### Pacotes

- [@elevenlabs/convai-widget-core@0.9.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.9.0) - Widget principal atualizado com os recursos e melhorias mais recentes
- [@elevenlabs/convai-widget-embed@0.9.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.9.0) - Widget incorporável atualizado com os recursos e melhorias mais recentes
- [@elevenlabs/react-native@0.5.10](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@0.5.10) - Atualizações do SDK React Native
- [@elevenlabs/types@0.5.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.5.0) - Pacote de tipos TypeScript atualizado

### API

<Accordion title="Ver alterações da API">

## Novos endpoints

- [Buscar mensagens de conversas por texto](/docs/pt/api-reference/conversations/messages/text-search) - `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](/docs/pt/api-reference/conversations/messages/search) - `GET /v1/convai/conversations/messages/smart-search` - Realize uma busca semântica nas mensagens de conversas usando embeddings
- [Listar LLMs disponíveis](/docs/pt/api-reference/llm/list) - `GET /v1/convai/llm/list` - Recupere LLMs disponíveis com informações de descontinuação, recursos e limites de contexto
- [Enviar arquivo para conversa](/docs/pt/api-reference/conversations/upload-file) - `POST /v1/convai/conversations/{conversation_id}/files` - Envie arquivos para o contexto de uma conversa
- [Excluir arquivo de conversa](/docs/pt/api-reference/conversations/delete-file) - `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](/docs/pt/api-reference/text-to-voice/design) e [Remix de voz](/docs/pt/api-reference/text-to-voice/remix) em vez disso.

## Endpoints atualizados

### ElevenAgents

- [Criar agente](/docs/pt/api-reference/agents/create), [Atualizar agente](/docs/pt/api-reference/agents/update), [Obter agente](/docs/pt/api-reference/agents/get)

  - 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](/docs/pt/api-reference/mcp/create), [Atualizar servidor MCP](/docs/pt/api-reference/mcp/update), [Obter servidor MCP](/docs/pt/api-reference/mcp/get)

  - 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](/docs/pt/api-reference/mcp/tool-configuration/create), [Atualizar configuração de ferramenta MCP](/docs/pt/api-reference/mcp/tool-configuration/update), [Obter configuração de ferramenta MCP](/docs/pt/api-reference/mcp/tool-configuration/get)

  - 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](/docs/pt/api-reference/knowledge-base/compute-rag-index), [Excluir índice RAG](/docs/pt/api-reference/knowledge-base/delete-rag-index)

  - Adicionado `qwen3_embedding_4b` ao enum `embedding_model`

- [Obter conversas](/docs/pt/api-reference/conversations/get-conversations)

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

- [Obter conversa](/docs/pt/api-reference/conversations/get)

  - 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](/docs/pt/api-reference/agents/simulate-conversation), [Transmitir simulação de conversa](/docs/pt/api-reference/agents/simulate-conversation-stream)

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

- [Obter ramificações de agentes](/docs/pt/api-reference/agents/branches/get), [Atualizar ramificação de agente](/docs/pt/api-reference/agents/branches/update)

  - Descrição do campo `current_live_percentage` atualizada para mais clareza

- [Obter configurações do ElevenAgents](/docs/pt/api-reference/workspace/get), [Atualizar configurações do ElevenAgents](/docs/pt/api-reference/workspace/update)
  - Campo `rag_retention_period_days` atualizado com uma descrição aprimorada

### Espaços de trabalho

- [Atualizar webhook](/docs/pt/api-reference/webhooks/update)

  - 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](/docs/pt/api-reference/workspace/resources/get), [Compartilhar recurso do espaço de trabalho](/docs/pt/api-reference/workspace/resources/share), [Cancelar compartilhamento de recurso do espaço de trabalho](/docs/pt/api-reference/workspace/resources/unshare)

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

- [Obter usuário](/docs/pt/api-reference/user/get)
  - Adicionado o campo obrigatório `seat_type` com valores de enum: `workspace_admin`, `workspace_member`, `workspace_lite_member`

### Música

- [Gerar música](/docs/pt/api-reference/music/compose), [Gerar música detalhada](/docs/pt/api-reference/music/compose-detailed), [Transmitir música](/docs/pt/api-reference/music/stream)
  - 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](/docs/pt/api-reference/legacy/voices/create-previews), [Criar voz](/docs/pt/api-reference/text-to-voice/design), [Remixar voz](/docs/pt/api-reference/text-to-voice/remix)
  - 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](/docs/pt/api-reference/voices/get-all), [Obter configurações de voz](/docs/pt/api-reference/voices/settings/get), [Obter configurações de voz padrão](/docs/pt/api-reference/voices/settings/get-default), [Editar configurações de voz](/docs/pt/api-reference/voices/settings/update)
  - 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

</Accordion>