> 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

- **Rebase de branch**: Adicionado `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase` para fazer o rebase de uma branch na main mais recente, preservando as alterações específicas da branch. Os modelos pai de versões de agentes adicionam o campo opcional `rebased_from_version_id` (string) para rastrear a versão de origem após um rebase.
- **Filtragem de produto de conversas**: [Listar conversas](/docs/pt/api-reference/conversations/list) e [Pesquisar mensagens de conversas por texto](/docs/pt/api-reference/conversations/messages/text-search) adicionam o parâmetro de consulta opcional `conversation_product_type` (`agents` | `speech_engine`) para filtrar resultados por produto. Os modelos de conversa introduzem `ConversationProduct` para essa distinção.
- **Filtragem de encerramento de conversas**: [Listar conversas](/docs/pt/api-reference/conversations/list) adiciona o parâmetro de consulta opcional `termination_reasons` (array de strings) para filtrar conversas pela forma como foram encerradas.
- **Descoberta de tópicos por agente**: As configurações de plataforma de [Criar agente](/docs/pt/api-reference/agents/create) e [Atualizar agente](/docs/pt/api-reference/agents/update) adicionam o campo opcional `topic_discovery` (`TopicDiscoverySettings`) para configurar a descoberta de tópicos por agente.
- **Configuração de som de fundo**: Os modelos de configuração de plataforma e conversa de agentes adicionam o campo opcional `background_sound` (`BackgroundSoundConfig`) para áudio ambiente durante as conversas.
- **Termos ignorados na interrupção de turnos**: Os esquemas de configuração de turnos adicionam o campo opcional `interruption_ignore_terms` (array de strings) para suprimir a detecção de turnos em frases específicas.
- **Aleatorização de preenchimentos de tempo limite flexível**: A configuração de tempo limite flexível adiciona o campo opcional `randomize_fillers` (boolean) para alternar mensagens de preenchimento entre os tempos limites flexíveis. Os campos de substituição de mensagens de tempo limite flexível e de prompt do LLM agora oferecem suporte a variáveis dinâmicas.
- **Identificadores de usuário em transcrições**: Os modelos de mensagens de transcrição adicionam o campo opcional `user_identifier` (string) em mensagens escritas pelo usuário.
- **Condições de sucesso de simulação**: Os esquemas de teste de simulação de agentes adicionam o campo opcional `success_conditions` (array, com até 30 itens). O campo legado `success_condition` foi descontinuado em favor da forma de array.
- **Limite de repetição de testes de agentes**: [Executar testes no agente](/docs/pt/api-reference/tests/run-tests) aumenta o máximo de `repeat_count` de 20 para 50.
- **Valores permitidos dinâmicos no esquema de ferramentas**: As propriedades do esquema JSON de ferramentas do ElevenAgents adicionam o campo opcional `allowed_values_dynamic_variable` (string) para seleções de valores pelo LLM, verificadas pelo servidor e obtidas de variáveis dinâmicas.
- **Documentação de URL assinada do widget**: [Obter widget](/docs/pt/api-reference/widget/get) atualiza a documentação de `conversation_signature` para fazer referência a `/v1/convai/conversation/get_signed_url`.

### Música

- **Formatos de saída de maior qualidade**: [Gerar música](/docs/pt/api-reference/music/compose), [Gerar música detalhada](/docs/pt/api-reference/music/compose-detailed) e [Transmitir música](/docs/pt/api-reference/music/stream) adicionam `mp3_48000_240` e `mp3_48000_320` aos valores compatíveis de `output_format`. Quando `output_format` é `auto`, os modelos v2 agora usam `mp3_48000_192` como padrão em vez de `mp3_48000_128`.
- **Esclarecimento sobre a flag de duração das seções**: `respect_sections_durations` se aplica apenas com `composition_plan` em `music_v1`. Em `music_v2`, as durações das seções são sempre aplicadas e essa flag é ignorada.
- **Divisão do esquema de plano de composição**: O `composition_plan` de solicitações de música usa uma união `oneOf` de `MusicPrompt` e `CompositionPlan`. O primeiro é usado para planos de composição de `music_v1`, e o segundo para `music_v2`.

### Dublagem

- **Filtros de lista de projetos**: [Listar dublagens](/docs/pt/api-reference/dubbing/list) adiciona os parâmetros de consulta de array opcionais `dubbing_statuses`, `dubbing_models`, `target_language_codes` e `creation_sources` para listagens filtradas. O parâmetro `order_by` agora aceita `name` além de `created_at`.

### Espaços de trabalho

- **Motivos de bloqueio e desativação**: Os modelos de espaço de trabalho e chave de API adicionam `LockReason` e os campos opcionais `disable_reason`. As configurações de grupo do espaço de trabalho adicionam o campo opcional `scim_frozen` (boolean) para o estado de congelamento gerenciado por SCIM.

### ElevenCreative Studio

- **Animações de legendas**: Os enums de animação de entrada e saída de legendas do Estúdio adicionam `pop`, `slide_up` e `slide_down`.

### Lançamentos de SDKs

#### SDK JavaScript

- [v2.54.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.54.0) - Regenerado a partir do esquema OpenAPI mais recente, com suporte do cliente para rebase de branch, filtros `conversation_product_type` e `termination_reasons` para lista e pesquisa por texto de conversas, filtros de múltiplos valores para lista de dublagens, tipos de `output_format` específicos para música, configurações de descoberta de tópicos e remoção de tipos exportados relacionados a coaching.
- [v2.53.1](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.53.1) - Restaurados valores opcionais em registros `DynamicVariablesConfig` que foram restringidos incorretamente na v2.53.0.

#### SDK Python

- [v2.54.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.54.0) - Regenerado a partir do esquema OpenAPI mais recente, com suporte do cliente para rebase de branch, filtros para lista e pesquisa por texto de conversas, filtros de múltiplos valores para lista de dublagens, atualizações de formato de saída de música, configurações de descoberta de tópicos e remoção de tipos exportados relacionados a coaching. `ElevenLabs` e `AsyncElevenLabs` agora aceitam o encaminhamento de `headers` e `follow_redirects` para o cliente base.

#### Pacotes

- [@elevenlabs/client@1.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.12.0) - Adicionado suporte a `overrides.asr.keywords` no cliente de navegador para que a priorização de palavras-chave de ASR por conversa possa ser enviada via `conversation_initiation_client_data`.
- [@elevenlabs/react@1.7.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.7.0) - Exposto `includeLanguageDetection` para sessões Scribe em tempo real, incluindo suporte do React `useScribe` para solicitar e ler metadados de idioma detectado.
- [@elevenlabs/react-native@1.2.9](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.9), [@elevenlabs/types@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.15.0), [@elevenlabs/convai-widget-core@0.14.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.4) e [@elevenlabs/convai-widget-embed@0.14.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.4) - Alinhamento de dependências com `@elevenlabs/client@1.12.0` e `@elevenlabs/types@0.15.0`.
- [@elevenlabs/client@1.12.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.12.1) - Exposto o auxiliar de upload de arquivos pelo ponto de entrada interno do Unity.
- [@elevenlabs/react@1.7.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.7.1), [@elevenlabs/react-native@1.2.10](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.10), [@elevenlabs/convai-widget-core@0.14.5](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.5) e [@elevenlabs/convai-widget-embed@0.14.5](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.5) - Alinhamento de dependências com `@elevenlabs/client@1.12.1`.

#### Servidor MCP

- [v0.10.0](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.10.0) - Adicionados o modelo e endpoints Music v2, anotações de ferramentas MCP para todas as 24 ferramentas, suporte ao Python 3.14, residência de dados em Singapura, aliases abreviados de residência na UE/Índia, tratamento de encerramento seguro para desconexões de clientes e correções para criação de prévias de voz e resolução de caminhos de diretório de saída.

### API

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

## Novos endpoints

### ElevenAgents

- `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase` - Faz o rebase de uma branch na main mais recente, preservando as alterações específicas da branch

## Endpoints atualizados

### ElevenAgents

- [Listar conversas](/docs/pt/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - Adicionado o parâmetro de consulta opcional `conversation_product_type` (`agents` | `speech_engine`)
  - Adicionado o parâmetro de consulta opcional `termination_reasons` (array de strings)
- [Pesquisar mensagens de conversas por texto](/docs/pt/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - Adicionado o parâmetro de consulta opcional `conversation_product_type` (`agents` | `speech_engine`)
- [Obter widget](/docs/pt/api-reference/widget/get) - `GET /v1/convai/agents/{agent_id}/widget`
  - Atualizada a documentação de `conversation_signature` para fazer referência a `/v1/convai/conversation/get_signed_url`
- [Executar testes no agente](/docs/pt/api-reference/tests/run-tests) - `POST /v1/convai/agents/{agent_id}/run-tests`
  - Aumentado o máximo de `repeat_count` de 20 para 50

### Dublagem

- [Listar dublagens](/docs/pt/api-reference/dubbing/list) - `GET /v1/dubbing`
  - Adicionados os parâmetros de consulta opcionais `dubbing_statuses`, `dubbing_models`, `target_language_codes` e `creation_sources`
  - `order_by` agora aceita `name` além de `created_at`

### Música

- [Gerar música](/docs/pt/api-reference/music/compose), [Gerar música detalhada](/docs/pt/api-reference/music/compose-detailed) e [Transmitir música](/docs/pt/api-reference/music/stream)
  - Adicionados `mp3_48000_240` e `mp3_48000_320` aos valores compatíveis de `output_format`
  - O formato de saída `auto` seleciona `mp3_48000_192` para modelos v2 (antes, `mp3_48000_128`)

## Alterações de esquema

### ElevenAgents

- Branches e versões de agentes
  - Adicionado o campo opcional `rebased_from_version_id` nos modelos pai de versões de agentes
- Configuração de plataforma e conversa
  - Adicionado o campo opcional `topic_discovery` (`TopicDiscoverySettings`) nos modelos de solicitação e resposta de configurações de plataforma
  - Adicionado o campo opcional `background_sound` (`BackgroundSoundConfig`)
- Configuração de turnos e tempos limite
  - Adicionado o campo opcional `interruption_ignore_terms` (array de strings) nos esquemas de configuração de turnos
  - Adicionado o campo opcional `randomize_fillers` (boolean) na configuração de tempo limite flexível
- Transcrições e simulação
  - Adicionado o campo opcional `user_identifier` (string) nas mensagens de usuário da transcrição
  - Adicionado o campo opcional `success_conditions` (array, máximo de 30); `success_condition` foi descontinuado
- Propriedades do esquema JSON de ferramentas
  - Adicionado o campo opcional `allowed_values_dynamic_variable` (string)

### Música

- Planos de composição
  - O campo de solicitação `composition_plan` usa `oneOf` (`MusicPrompt` | `CompositionPlan`)
  - Esclarecido o comportamento de `respect_sections_durations` para `music_v1` versus `music_v2`

### Espaços de trabalho

- Adicionados o enum `LockReason` e os campos opcionais `disable_reason`
- Adicionado o campo opcional `scim_frozen` (boolean) nas configurações de grupo do espaço de trabalho

### ElevenCreative Studio

- Os enums de animação de legendas adicionam `pop`, `slide_up` e `slide_down`

## Esquemas removidos

### ElevenAgents

- Removidos os esquemas de configuração relacionados a coaching (`CoachedAgentSettings`, `CoachingAgentSettings`, `NoCoachingSettings`)

</Accordion>