> 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

- **Endpoint de usuários de conversas**: Adicionado o endpoint [Obter usuários de conversas](/docs/pt/api-reference/users/list) (`GET /v1/convai/users`) para listar usuários que tiveram conversas com seus agentes. Compatível com paginação e filtragem por agente, intervalo de tempo e outros critérios.
- **Versionamento de agentes**: Busque configurações específicas de agentes por versão usando os novos parâmetros de consulta `version_id` e `branch_id` no endpoint [Obter agente](/docs/pt/api-reference/agents/get). O endpoint [Atualizar agente](/docs/pt/api-reference/agents/update) agora também aceita um parâmetro `branch_id` para atualizações específicas de uma ramificação.
- **Ferramenta de busca na documentação**: Adicionado `search_documentation` como uma nova ferramenta de sistema integrada para RAG (geração aumentada por recuperação). Configure a recuperação de múltiplas fontes com os esquemas `MultiSourceConfigJson`, `SourceConfigJson` e `SourceRetrievalConfig`. Compatível com estratégias de mesclagem configuráveis pelo enum `MergingStrategy`.
- **Suporte a ferramentas MCP**: Adicionado `mcp` como um novo tipo de ferramenta, junto com ferramentas de webhook, cliente e sistema. Configure ferramentas MCP usando o novo esquema `MCPToolConfig` nas definições de ferramentas do seu agente.
- **Proteções de conteúdo**: Adicionadas proteções de moderação de conteúdo ao `GuardrailsV1`, com limites configuráveis para diferentes categorias de conteúdo: sexual, violência, assédio, automutilação, palavrões, religião/política e conteúdo médico/jurídico. Use os novos esquemas `ContentGuardrail` e `ContentConfig`.
- **Modo expressivo**: Adicionado o campo `expressive_mode` (booleano) aos esquemas de configuração de agentes para orientar automaticamente seu agente a aproveitar ao máximo o novo modelo conversacional v3.
- **Dígitos pós-discagem**: As transferências de números de telefone agora aceitam `post_dial_digits` para enviar tons DTMF após a conexão. Configurável como valores estáticos ou variáveis dinâmicas.
- **Tipos de teste de agentes**: Os testes de agentes agora aceitam três tipos distintos de teste com esquemas dedicados: `llm` (avaliação de resposta), `tool` (verificação de chamada de ferramenta) e `simulation` (simulação completa de conversa). Os testes de simulação incluem os campos de configuração `simulation_scenario` e `simulation_max_turns`.

### Dicionários de pronúncia

- **Regras na resposta da API**: O endpoint [Obter dicionário de pronúncia](/docs/pt/api-reference/pronunciation-dictionaries/get) agora retorna um array `rules` com detalhes completos das regras. A resposta usa o novo esquema `GetPronunciationDictionaryWithRulesResponseModel`, com `PronunciationDictionaryAliasRuleResponseModel` e `PronunciationDictionaryPhonemeRuleResponseModel` para os tipos de regra.

### Base de conhecimento

- **Exclusão de pastas**: O endpoint [Excluir documento da base de conhecimento](/docs/pt/api-reference/knowledge-base/delete) agora permite excluir pastas além de documentos. Ao excluir pastas, defina `force=true` para ativar a exclusão recursiva de todos os documentos e subpastas contidos.

### Lançamentos de SDKs

#### SDK Python

- [v2.36.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.36.0) - Adicionados endpoint de usuários de conversas, versionamento de agentes, ferramenta de busca na documentação, suporte a ferramentas MCP, proteções de conteúdo e tipos de teste de agentes

#### SDK JavaScript

- [v2.36.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.36.0) - Adicionadas assinaturas sobrecarregadas de `convert` a `speechToText.convert()` para melhorar a inferência de tipos com base nos parâmetros da solicitação (acesse `.text`, `.transcripts` ou campos de webhook sem estreitamento manual de tipo), além de endpoint de usuários de conversas, versionamento de agentes, ferramenta de busca na documentação, suporte a ferramentas MCP, proteções de conteúdo e tipos de teste de agentes

#### Pacotes de widget

- [@elevenlabs/convai-widget-core@0.9.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.9.0) - Adicionados indicador de status de uso de ferramentas pelo agente e novo selo de status para chamadas de ferramentas de longa duração; corrigida a remoção de tags de emoção e o envio de avaliações e feedback para incorporação de widget por URL assinada
- [@elevenlabs/convai-widget-embed@0.9.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.9.0) - Adicionados indicador de status de uso de ferramentas pelo agente e novo selo de status para chamadas de ferramentas de longa duração; corrigida a remoção de tags de emoção

### API

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

## Novos endpoints

- [Obter usuários de conversas](/docs/pt/api-reference/users/list) - `GET /v1/convai/users` - Lista usuários que tiveram conversas com seus agentes

## Endpoints atualizados

### ElevenAgents

- [Obter agente](/docs/pt/api-reference/agents/get)
  - Adicionado o parâmetro de consulta `version_id` (string, opcional) para buscar uma versão específica do agente
  - Adicionado o parâmetro de consulta `branch_id` (string, opcional) para buscar de uma ramificação específica
- [Atualizar agente](/docs/pt/api-reference/agents/update)
  - Adicionado o parâmetro de consulta `branch_id` (string, opcional) para atualizações específicas de uma ramificação
- [Criar agente](/docs/pt/api-reference/agents/create)
  - Adicionado `search_documentation` às ferramentas de sistema com configuração RAG de múltiplas fontes
  - Adicionado o tipo de ferramenta `mcp` ao discriminador de ferramentas
  - Adicionado o campo `content` ao `GuardrailsV1` para proteções de moderação de conteúdo
  - Adicionado o campo `expressive_mode` (booleano) à configuração do agente
- [Criar teste de agente](/docs/pt/api-reference/tests/create), [Atualizar teste de agente](/docs/pt/api-reference/tests/update), [Obter teste de agente](/docs/pt/api-reference/tests/get)
  - Alterados para esquemas de união discriminada com o campo `type` (`llm`, `tool`, `simulation`)
  - Adicionados os campos `simulation_scenario` e `simulation_max_turns` para testes de simulação

### Dicionários de pronúncia

- [Obter dicionário de pronúncia](/docs/pt/api-reference/pronunciation-dictionaries/get)
  - Esquema de resposta alterado para `GetPronunciationDictionaryWithRulesResponseModel` com array `rules`

### Base de conhecimento

- [Excluir documento da base de conhecimento](/docs/pt/api-reference/knowledge-base/delete)
  - Descrição do parâmetro `force` atualizada para abranger a exclusão de pastas com comportamento recursivo

## Alterações de esquema

### Novos esquemas

- `GetPronunciationDictionaryWithRulesResponseModel` - Modelo de resposta com array de regras incorporado
- `PronunciationDictionaryAliasRuleResponseModel` - Regra de alias com `string_to_replace` e `alias`
- `PronunciationDictionaryPhonemeRuleResponseModel` - Regra de fonema com `string_to_replace`, `phoneme` e `alphabet`
- `MultiSourceConfigJson` - Configuração RAG de múltiplas fontes
- `SourceConfigJson` - Configuração individual de fonte para RAG
- `SourceRetrievalConfig` - Configuração de recuperação para fontes RAG
- `MergingStrategy` - Enum para estratégias de mesclagem de resultados RAG
- `MCPToolConfig` - Configuração para ferramentas MCP
- `ContentGuardrail-Input`, `ContentGuardrail-Output` - Configuração de proteção de moderação de conteúdo
- `ContentConfig` - Configuração de limites por categoria de conteúdo
- `TestType` - Enum com os valores `llm`, `tool`, `simulation`
- `CreateAgentTestResponseModel` - Resposta para criação de teste
- `LLMResponseTest*`, `ToolCallTest*`, `SimulationTest*` - Esquemas de teste por tipo que substituem os modelos legados `Create/Get/UpdateUnitTest*`

### Esquemas modificados

- `GuardrailsV1-Input`, `GuardrailsV1-Output` - Adicionado o campo `content` para proteções de conteúdo
- `AgentConfig` - Adicionado o campo `expressive_mode` (booleano)
- `PhoneNumberTransferConfig` - Adicionado o campo `post_dial_digits` (string ou variável dinâmica)
- `DistributionTerritories` - Restrição de itens flexibilizada para permitir strings de território arbitrárias

</Accordion>