> 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

- **Análise de conversa com escopo**: Os critérios de avaliação e os itens de coleta de dados agora podem ser definidos com o escopo `conversation` (transcrição completa) ou `agent` (somente a parte em que um agente específico estava ativo). Adicionados o campo `scope` a `PromptEvaluationCriteria`, `data_collection_scopes` às [configurações da plataforma de agentes](/docs/pt/eleven-agents/customization/agent-analysis) e um novo array `scoped` de `ScopedAnalysisResult` na resposta de [análise da conversa](/docs/pt/api-reference/conversations/analysis/run-analysis). Isso é especialmente útil para workflows com vários agentes, nos quais cada agente deve ser avaliado de forma independente.

- **Gerenciamento de pastas de testes de agentes**: Agora os testes podem ser organizados em pastas. Novos endpoints para [criar](/docs/pt/api-reference/tests/test-folders/create), [recuperar](/docs/pt/api-reference/tests/test-folders/get), [atualizar](/docs/pt/api-reference/tests/test-folders/update) e [excluir](/docs/pt/api-reference/tests/test-folders/delete) pastas de testes, além de [mover em massa](/docs/pt/api-reference/tests/test-folders/move) testes entre pastas.

- **Substituições de ferramentas e base de conhecimento em workflows**: As substituições de nós de workflow de agentes agora oferecem suporte aos campos `tool_ids` e `knowledge_base` em `PromptAgentAPIModelOverrideConfig`, permitindo que os nós do workflow controlem quais ferramentas e documentos da base de conhecimento cada subagente pode acessar.

- **Modo `hide_all` do filtro de resposta **: Adicionada a opção `hide_all` a `ResponseFilterMode`, forçando o sistema a ocultar todos os campos de uma resposta de ferramenta do agente.

- **Agentes visitados no histórico da conversa**: A resposta de [obter conversa](/docs/pt/api-reference/conversations/get) agora inclui um array `visited_agents` de objetos `VisitedAgentRef` (com `agent_id` e `branch_id`), registrando quais agentes participaram de uma conversa com vários agentes.

- **Suporte a mensagens multimodais em hooks**: O hook `useConversationControls` agora expõe `sendMultimodalMessage`, e o tipo `MultimodalMessageInput` é exportado de `@elevenlabs/client`, facilitando o envio de imagens e outros conteúdos multimodais durante conversas.

### Speech to Text

- **Duração do áudio nas respostas**: A resposta de [converter fala em texto](/docs/pt/api-reference/speech-to-text/convert) agora inclui um campo `audio_duration_secs`, fornecendo a duração total do áudio transcrito sem exigir cálculo no lado do cliente.

### Vozes

- **Qualidade da gravação e status de revisão**: A resposta de [obter voz](/docs/pt/api-reference/voices/get) agora inclui os campos `recording_quality` (enum: `studio`, `good`, `ok`, `poor`, `bad`) e `labelling_status` (enum: `in_review`, `review_complete`), oferecendo visibilidade sobre a avaliação da qualidade da voz.

### Lançamentos de SDK

#### SDK JavaScript

- [v2.42.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.42.0) - Regeneração do Fern para o esquema da API de 7 de abril de 2026, incluindo análise com escopo, pastas de teste e suporte a entrada DTMF.

#### SDK Python

- [v2.42.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.42.0) - Regeneração do Fern para o esquema da API de 7 de abril de 2026, incluindo análise com escopo, pastas de teste e suporte a entrada DTMF.

#### SDK Swift

- [v3.1.2](https://github.com/elevenlabs/ElevenLabsSwift/releases/tag/v3.1.2) - Corrigido o despacho de categorias ObjC para métodos delegados do LiveKit, resolvendo possíveis falhas em integrações de agentes de voz baseadas em Swift.

#### Pacotes

- [@elevenlabs/client@1.1.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@1.1.1) - Exposto `sendMultimodalMessage` na API do cliente e exportado o tipo `MultimodalMessageInput` para enviar imagens e outros conteúdos multimodais durante conversas.

- [@elevenlabs/client@1.1.2](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@1.1.2), [@elevenlabs/react@1.0.3](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@1.0.3), [@elevenlabs/react-native@1.0.3](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@1.0.3), [@elevenlabs/types@0.9.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.9.1) - Corrigida a compatibilidade com ESM do Node.js ao adicionar extensões `.js` explícitas a todas as importações relativas e definir `"type": "module"` em `@elevenlabs/types`.

- [@elevenlabs/convai-widget-core@0.11.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.11.0) - Adicionada seleção automática de idioma com base no histórico do localStorage e nas preferências de idioma do navegador para o widget incorporável.

### API

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

## Novos endpoints

- [Criar pasta](/docs/pt/api-reference/tests/test-folders/create) - `POST /v1/convai/agent-testing/folders`
- [Obter pasta](/docs/pt/api-reference/tests/test-folders/get) - `GET /v1/convai/agent-testing/folders/{folder_id}`
- [Atualizar pasta](/docs/pt/api-reference/tests/test-folders/update) - `PATCH /v1/convai/agent-testing/folders/{folder_id}`
- [Excluir pasta](/docs/pt/api-reference/tests/test-folders/delete) - `DELETE /v1/convai/agent-testing/folders/{folder_id}`
- [Mover testes em massa para pasta](/docs/pt/api-reference/tests/test-folders/move) - `POST /v1/convai/agent-testing/bulk-move`

## Endpoints atualizados

### ElevenAgents

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

  - Adicionado o campo `data_collection_scopes` (objeto, opcional) a `AgentPlatformSettings` para controle do escopo de análise por item

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

  - Adicionado o campo `visited_agents` (array de `VisitedAgentRef`, opcional), que registra os agentes visitados durante conversas com vários agentes
  - Adicionado o campo `scoped` (array de `ScopedAnalysisResult`) à resposta de análise da conversa

- [Executar análise da conversa](/docs/pt/api-reference/conversations/analysis/run-analysis)

  - A resposta agora inclui resultados de análise `scoped` com detalhamentos de avaliação por agente

- Substituições de nós de workflow de agentes (`PromptAgentAPIModelOverrideConfig`)

  - Adicionado o campo `tool_ids` (array de strings, opcional) para restringir as ferramentas disponíveis por nó do workflow
  - Adicionado o campo `knowledge_base` (objeto, opcional) para substituir a base de conhecimento por nó do workflow

- Enum `ResponseFilterMode`

  - Adicionado o valor `hide_all`

- Padrão de `MockNoMatchBehavior`

  - Alterado o padrão de `call_real_tool` para `raise_error`

- Enum `ClientEvent`

  - Adicionado o valor `dtmf_request`

- Métricas de turno
  - Adicionado o campo `convai_tts_cascade` (string, anulável) a `ConversationTurnMetrics`

### Speech to Text

- [Converter fala em texto](/docs/pt/api-reference/speech-to-text/convert)
  - Adicionado o campo `audio_duration_secs` (número) aos modelos de resposta

### Vozes

- [Obter voz](/docs/pt/api-reference/voices/get), [Listar vozes](/docs/pt/api-reference/voices/search)
  - Adicionado o campo `recording_quality` (enum: `studio`, `good`, `ok`, `poor`, `bad`, anulável)
  - Adicionado o campo `recording_quality_reason` (string, anulável)
  - Adicionado o campo `labelling_status` (enum: `in_review`, `review_complete`, anulável)

### Texto para diálogo

- Resposta de [texto para diálogo](/docs/pt/api-reference/text-to-dialogue/convert)
  - Novo esquema `ToDialogueSettingsResponseModel` com os campos `stability` e `speed`

</Accordion>