> 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.

### ElevenAgents

- **Mocks de ferramentas específicos para testes**: Simulações de agentes e testes unitários agora podem definir `tool_mock_overrides`, indexados por ID de ferramenta, para substituir mocks compartilhados em um único teste. `ToolResponseMockConfig` também adiciona `is_error` opcional (booleano, padrão `false`) para que um mock possa testar caminhos de falha de ferramentas.
- **Mensagens de workflow traduzidas**: Mensagens literais de nós Say adicionam `text_translations`, um mapa de chaves de idioma para objetos `TranslatedString`. O campo é opcional na entrada e obrigatório na saída, portanto validadores estritos de resposta devem aceitá-lo.
- **Filtros de versão de conversa**: [Listar conversas](/docs/pt/api-reference/conversations/list) e [Pesquisar mensagens de conversa por texto](/docs/pt/api-reference/conversations/messages/text-search) adicionam o parâmetro de consulta opcional `version_id` (string) para filtrar resultados por versão do agente.
- **Ferramenta de sistema da base de conhecimento**: A configuração do agente adiciona uma ferramenta de sistema `knowledge_base` com `enabled_strategies` (`SearchStrategy[]`) configurável. As consultas RAG da base de conhecimento do agente adicionam `use_agent_defaults` opcional (booleano, padrão `true`); defina-o como `false` para usar configurações de recuperação neutras, mantendo o modelo de embedding do agente.
- **Detecção de atividade de voz do agente**: Os esquemas de criação, atualização, resposta e substituição de workflow de agentes adicionam a configuração `vad`. Atualmente, `VADConfig` oferece suporte a `background_voice_detection` (booleano, padrão `false`).
- **LLMs personalizados por WebSocket**: `CustomLLMAPIType` adiciona `websocket`.
- **Controles de memória para arquivos**: A configuração de entrada de arquivos do widget adiciona `max_files_in_memory` (inteiro, 1–30, padrão `10`). Arquivos além do limite são resumidos e liberados da memória; `max_files_per_conversation` deve ser `-1` ou, no mínimo, o limite de memória.
- **Redação de entrada DTMF**: `DTMFInputConfig` adiciona `redact_input` opcional (booleano, padrão `false`) para substituir dígitos do teclado do chamador em transcrições, registros de conversa e análises. Dígitos repetidos pelo agente ou transmitidos para ferramentas permanecem inalterados.

### Speech to Text

- **Detecção de entidades em tempo real**: O Scribe v2 Realtime adiciona a opção de consulta `entity_detection`. Ela aceita `all`, um tipo ou categoria de entidade, ou um array de tipos e categorias, e emite entidades detectadas em eventos `committed_transcript_entities`. Veja as categorias compatíveis no [guia de detecção de entidades](/docs/pt/eleven-api/guides/how-to/speech-to-text/batch/entity-detection).

### Vozes

- **Replicação de voz entre residências de dados**: Adicionamos `POST /v1/voices/{voice_id}/replicate-to-isolated-environment` para copiar uma voz do Instant Voice Clone ou Voice Design para um workspace no mesmo grupo de faturamento consolidado. As solicitações exigem `target_workspace_id` (string) e aceitam `preserve_voice_id` (booleano, padrão `true`); as respostas retornam o `voice_id` de destino.
- **Metadados de personagens**: As respostas de personagens adicionam `recommended_voice_ids` (array de strings, padrão `[]`), os metadados adicionam `role` anulável (`CharacterRole`) e `CharacterAge` substitui `middle-aged` por `middle_aged`.

### Lançamentos de SDKs

#### Pacotes

- [@elevenlabs/client@1.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.16.0), [@elevenlabs/react@1.11.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.11.0), [@elevenlabs/types@0.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.18.0), [@elevenlabs/react-native@1.2.17](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.17) e [@elevenlabs/convai-widget-core@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.0) - Adicionamos `onAgentReasoningResponsePart`, que recebe eventos de raciocínio do agente por streaming com os tipos `start`, `delta` e `stop`.
- [@elevenlabs/convai-widget-core@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.0) e [@elevenlabs/convai-widget-embed@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.15.0) - Adicionamos `show_resize_button` e o atributo de incorporação `show-resize-button`. Defina qualquer um como `false` para ocultar o controle de expandir e recolher do cabeçalho do widget.
- [@elevenlabs/client@1.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.17.0), [@elevenlabs/react@1.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.0), [@elevenlabs/types@0.19.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.19.0), [@elevenlabs/react-native@1.2.18](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.18) e [@elevenlabs/convai-widget-core@0.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.1) - Adicionamos a opção `enableLogging` a `Scribe.connect` e `useScribe`. Defini-la como `false` inicia uma sessão empresarial sem retenção. O tipo `session_started` do Scribe agora informa `enable_logging`; o campo não utilizado `disable_logging` foi removido.

#### Servidor MCP

- [v0.12.1](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.12.1) - Inclui as atualizações de ferramentas da v0.11 e uma atualização de dependências que resolve 44 alertas de segurança.
- [v0.11.0](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.11.0) - Adicionamos `simulate_conversation` com comportamento configurável de usuário simulado, critérios de avaliação, saída de transcrição e análise de aprovação/reprovação. A ferramenta `speech_to_text` agora usa `scribe_v2` por padrão, e `voice_clone` agora envia o conteúdo de arquivos de áudio em vez de strings de caminho.

### API

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

## Novos endpoints

### Vozes

- `POST /v1/voices/{voice_id}/replicate-to-isolated-environment`
  - Replica uma voz do Instant Voice Clone ou Voice Design no ambiente isolado de outro workspace
  - Exige `target_workspace_id` (string)
  - Aceita `preserve_voice_id` opcional (booleano, padrão `true`)
  - Retorna `voice_id` obrigatório (string)

## Endpoints atualizados

### ElevenAgents

- [Listar conversas](/docs/pt/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - Adicionado parâmetro de consulta opcional `version_id` (string)
- [Pesquisar mensagens de conversa por texto](/docs/pt/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - Adicionado parâmetro de consulta opcional `version_id` (string)
- `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query`
  - Adicionado campo de solicitação opcional `use_agent_defaults` (booleano, padrão `true`)

## Alterações de esquema

### ElevenAgents

- As cargas de simulação e testes unitários adicionam mapas opcionais `tool_mock_overrides`; `ToolResponseMockConfig` adiciona `is_error` opcional (booleano, padrão `false`)
- `SayNodeLiteralMessage` adiciona `text_translations` (mapa de `TranslatedString`); o campo é opcional na entrada e obrigatório na saída
- A configuração do agente adiciona `knowledge_base` (`KnowledgeBaseToolConfig`) e `vad` (`VADConfig`)
- `CustomLLMAPIType` adiciona `websocket`
- `FileInputConfig` adiciona `max_files_in_memory` (inteiro, 1–30, padrão `10`)
- `DTMFInputConfig` adiciona `redact_input` opcional (booleano, padrão `false`)
- A configuração de agente em tempo real agora usa `eleven_realtime_v1_mini` por padrão

### Vozes

- As respostas de personagens adicionam `recommended_voice_ids` (array de strings, padrão `[]`)
- Os metadados de personagens adicionam `role` anulável (`CharacterRole`)
- Incompatível: `CharacterAge` substitui `middle-aged` por `middle_aged`; clientes que enviam o valor antigo devem migrar

### Text to Speech

- Incompatível: removidos `AudioFilterId` e `audio_filter` dos esquemas de configuração de Text to Speech do ElevenAgents

</Accordion>