> 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

- **API de variáveis de ambiente**: Novos endpoints de [variáveis de ambiente](/docs/pt/eleven-agents/integrate/environment-variables) para gerenciar configurações no nível do workspace que os agentes podem consultar em tempo de execução por meio de templates `{{system_env__<label>}}`. Compatível com tipos de variável string, secreta e de conexão de autenticação, com substituições de valores por ambiente. Os endpoints incluem [criar](/docs/pt/api-reference/environment-variables/create), [listar](/docs/pt/api-reference/environment-variables/list), [obter](/docs/pt/api-reference/environment-variables/get) e [atualizar](/docs/pt/api-reference/environment-variables/update).

- **Gerenciamento de conexões de autenticação**: Nova API de conexões de autenticação no nível do workspace para gerenciar credenciais de autenticação usadas por ferramentas e integrações de agentes. Compatível com vários métodos de autenticação, incluindo credenciais de cliente OAuth2, JWT, autenticação básica, tokens bearer, cabeçalhos personalizados e fluxos de código de autorização OAuth2 gerenciados por integração. Os endpoints incluem operações de criação, listagem e exclusão.

- **Atualização de URL da Base de conhecimento**: Novo endpoint de [atualização](/docs/pt/api-reference/knowledge-base/refresh) (`POST /v1/convai/knowledge-base/{documentation_id}/refresh`) para buscar novamente e atualizar o conteúdo de documentos da Base de conhecimento originados de URLs. Os documentos da Base de conhecimento agora também aceitam configuração de sincronização automática com os campos `enable_auto_sync`, `auto_remove` e `auto_sync_info`.

- **Nova tentativa de guardrail com feedback**: Guardrails personalizados e de conteúdo agora aceitam [ações de acionamento](/docs/pt/eleven-agents/best-practices/guardrails) configuráveis com as opções `EndCallTriggerAction` e `RetryTriggerAction`. Quando configurado para tentar novamente, o agente gera uma nova resposta com feedback do sistema inserido, em até 3 tentativas. Os placeholders disponíveis incluem `{{trigger_reason}}` e `{{agent_message}}` para orientações contextuais de nova tentativa.

- **Variável de sistema do histórico de conversas**: Adicionamos uma nova variável dinâmica `system__conversation_history` que fornece um histórico de conversas serializado em JSON, avaliado sob demanda, em tempo de execução. Isso é útil para passar o contexto completo da conversa para ferramentas, webhooks ou transferências para subagentes.

- **Tipo de conteúdo da ferramenta de webhook**: As ferramentas de servidor agora aceitam um [tipo de conteúdo](/docs/pt/eleven-agents/customization/tools/server-tools) configurável para parâmetros do corpo do webhook, permitindo escolher entre os formatos `application/json` e `application/x-www-form-urlencoded`. O formato codificado em URL é útil para integração com sistemas legados, endpoints de token OAuth e processadores de pagamento.

- **Mensagens enviadas pelo WhatsApp**: Atualizamos a integração com o WhatsApp com um novo [diálogo de mensagens enviadas](/docs/pt/eleven-agents/whatsapp) no dashboard, permitindo que os agentes enviem mensagens, além de fazer chamadas, pelo canal do WhatsApp.

- **Filtros de listagem de agentes e recursos**: Os endpoints [listar agentes](/docs/pt/api-reference/agents/list), [listar documentos da Base de conhecimento](/docs/pt/api-reference/knowledge-base/list) e [listar ferramentas](/docs/pt/api-reference/tools/list) agora aceitam um parâmetro de consulta `created_by_user_id` (use `@me` para o usuário atual). Os parâmetros anteriores `show_only_owned_agents` e `show_only_owned_documents` foram descontinuados.

- **Expressões condicionais de workflow**: Adicionamos um novo nó AST `conditional_operator` ao esquema de expressões de workflow, permitindo lógica de ramificação nas definições de workflow de agentes.

### Música

- **Music Marketplace**: Nova documentação do [Music Marketplace](/docs/pt/overview/capabilities/music/marketplace), que aborda o marketplace para licenciar músicas geradas por IA, incluindo tipos de uso, pagamentos a criadores e detalhes de licenciamento.

### Lançamentos de SDKs

#### SDK Python

- [v2.40.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.40.0) - Adicionado suporte ao parâmetro `environment` para conversas do ElevenAgents, permitindo conexões de agentes específicas por ambiente. Regeneração do Fern para corresponder ao esquema de API mais recente, incluindo variáveis de ambiente, conexões de autenticação, atualização da Base de conhecimento e ações de acionamento de guardrail.

#### SDK JavaScript

- [v2.40.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.40.0) - Adicionado o tipo de evento WebSocket `multimodal_message` para conversas em tempo real do ElevenAgents. Regeneração do Fern para corresponder ao esquema de API mais recente, incluindo variáveis de ambiente, conexões de autenticação, atualização da Base de conhecimento e ações de acionamento de guardrail.

#### SDK iOS

- [v3.1.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.1.1) - Adicionado suporte ao parâmetro `environment` para conexões de agentes específicas por ambiente. Corrigido um erro de compilação do visionOS ao atualizar o requisito da plataforma para v2.

#### Pacotes

- [@elevenlabs/types@0.6.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.6.1) - Adicionado o tipo de evento WebSocket `multimodal_message` para conversas em tempo real do ElevenAgents.
- [@elevenlabs/client@0.15.2](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@0.15.2) - Adicionado suporte ao evento WebSocket `multimodal_message`.
- [@elevenlabs/react@0.14.3](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@0.14.3) - Adicionado suporte ao evento WebSocket `multimodal_message`.
- [@elevenlabs/convai-widget-core@0.10.4](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.10.4), [@elevenlabs/convai-widget-core@0.10.5](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.10.5) - Atualizado para `@elevenlabs/client@0.15.2`.
- [@elevenlabs/convai-widget-embed@0.10.4](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.10.4), [@elevenlabs/convai-widget-embed@0.10.5](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.10.5) - Atualizado para `@elevenlabs/client@0.15.2`.

#### Candidato a lançamento dos pacotes v1.0.0

O primeiro candidato a lançamento da v1.0.0 dos SDKs de cliente do ElevenAgents já está disponível. Este é um grande lançamento com alterações incompatíveis que melhoram a superfície da API, adicionam hooks granulares do React para melhor desempenho de renderização e unificam o SDK React Native com o SDK React.

Para testar o candidato a lançamento:

```bash
npm install @elevenlabs/client@next @elevenlabs/react@next @elevenlabs/react-native@next
```

Uma skill [`elevenlabs:sdk-migration`](https://github.com/elevenlabs/packages/blob/main/.agents/skills/elevenlabs%3Asdk-migration/SKILL.md) está disponível para ajudar assistentes de programação com IA a migrar automaticamente sua base de código para as novas APIs. Adicione-a ao seu projeto no Claude Code, Cursor ou Windsurf para receber suporte guiado à migração.

Principais mudanças na v1.0.0:

- **`@elevenlabs/client`**: `Conversation` agora é um objeto de namespace e alias de tipo para `TextConversation | VoiceConversation`, em vez de uma classe. As classes `Input` e `Output` foram substituídas pelas interfaces `InputController` e `OutputController`, com novos métodos de conveniência na instância de conversa (`setMicMuted()`, `setVolume()`, `getInputByteFrequencyData()`, `getOutputByteFrequencyData()`). `changeInputDevice()` e `changeOutputDevice()` agora retornam `void`.
- **`@elevenlabs/react`**: `useConversation` agora exige um ancestral `ConversationProvider`. Novos hooks granulares para re-renderização detalhada: `useConversationControls()`, `useConversationStatus()`, `useConversationInput()`, `useConversationMode()`, `useConversationFeedback()`. Novo hook `useConversationClientTool()` para registrar dinamicamente ferramentas de cliente a partir de componentes React com total segurança de tipos.
- **`@elevenlabs/react-native`**: Reescrita completa da API, substituindo `ElevenLabsProvider` e `useConversation` por `ConversationProvider` e os mesmos hooks granulares de `@elevenlabs/react`. Polyfills de WebRTC e a configuração nativa de AudioSession são aplicados automaticamente na importação.

Veja as notas de lançamento completas e os guias de migração:

- [@elevenlabs/client@1.0.0-rc.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@1.0.0-rc.1)
- [@elevenlabs/react@1.0.0-rc.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@1.0.0-rc.1)
- [@elevenlabs/react-native@1.0.0-rc.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@1.0.0-rc.1)
- [@elevenlabs/types@0.7.0-rc.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.7.0-rc.0)

### API

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

## Novos endpoints

### ElevenAgents

- [Criar variável de ambiente](/docs/pt/api-reference/environment-variables/create) - `POST /v1/convai/environment-variables` - Crie uma nova variável de ambiente com tipo string, secreto ou de conexão de autenticação
- [Listar variáveis de ambiente](/docs/pt/api-reference/environment-variables/list) - `GET /v1/convai/environment-variables` - Liste todas as variáveis de ambiente no workspace
- [Obter variável de ambiente](/docs/pt/api-reference/environment-variables/get) - `GET /v1/convai/environment-variables/{env_var_id}` - Obtenha uma variável de ambiente específica
- [Atualizar variável de ambiente](/docs/pt/api-reference/environment-variables/update) - `PATCH /v1/convai/environment-variables/{env_var_id}` - Atualize uma variável de ambiente, incluindo a remoção de valores por ambiente via `null`
- [Atualizar conteúdo de documento por URL](/docs/pt/api-reference/knowledge-base/refresh) - `POST /v1/convai/knowledge-base/{documentation_id}/refresh` - Busque novamente o conteúdo de documentos da Base de conhecimento originados de URLs

### Workspaces

- `POST /v1/workspace/auth-connections` - Crie uma conexão de autenticação do workspace com suporte para OAuth2, JWT, autenticação básica, bearer, cabeçalho personalizado e métodos de autenticação gerenciados por integração
- `GET /v1/workspace/auth-connections` - Liste todas as conexões de autenticação do workspace com informações de dependências (ferramentas, servidores MCP, conexões de integração)
- `DELETE /v1/workspace/auth-connections/{auth_connection_id}` - Exclua uma conexão de autenticação do workspace

### Speech to Text

- `GET /v1/speech-to-text/evaluation/eval-criteria` - Liste critérios de avaliação
- `POST /v1/speech-to-text/evaluation/eval-criteria` - Crie um critério de avaliação
- `GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}` - Obtenha um critério de avaliação específico
- `PATCH /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}` - Atualize um critério de avaliação
- `DELETE /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}` - Exclua um critério de avaliação
- `POST /v1/speech-to-text/evaluation/evaluations` - Acione uma avaliação
- `GET /v1/speech-to-text/evaluation/evaluations` - Liste avaliações
- `GET /v1/speech-to-text/evaluation/evaluations/{evaluation_id}` - Obtenha uma avaliação específica
- `GET /v1/speech-to-text/evaluation/human-agents` - Liste agentes humanos
- `GET /v1/speech-to-text/evaluation/human-agents/{agent_id}` - Obtenha um agente humano
- `DELETE /v1/speech-to-text/evaluation/human-agents/{agent_id}` - Exclua um agente humano
- `GET /v1/speech-to-text/evaluation/analytics` - Obtenha análises de avaliação
- `GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}/analytics` - Obtenha análises de um critério específico
- `GET /v1/speech-to-text/evaluation/human-agents/{agent_id}/analytics` - Obtenha análises de um agente humano específico

## Endpoints atualizados

### ElevenAgents

- [Obter URL assinada](/docs/pt/api-reference/conversations/get-signed-url), [Obter token de conversa](/docs/pt/api-reference/conversations/get-webrtc-token)

  - Adicionado o parâmetro de consulta `environment` (string, opcional) para resolução específica por ambiente

- [Listar agentes](/docs/pt/api-reference/agents/list)

  - Adicionado o parâmetro de consulta `created_by_user_id` (string, opcional, aceita `@me`)
  - `show_only_owned_agents` foi descontinuado em favor de `created_by_user_id`

- [Listar documentos da Base de conhecimento](/docs/pt/api-reference/knowledge-base/list)

  - Adicionado o parâmetro de consulta `created_by_user_id` (string, opcional, aceita `@me`)
  - `show_only_owned_documents` foi descontinuado em favor de `created_by_user_id`

- [Listar ferramentas](/docs/pt/api-reference/tools/list)

  - Adicionado o parâmetro de consulta `created_by_user_id` (string, opcional, aceita `@me`)
  - `show_only_owned_documents` foi descontinuado em favor de `created_by_user_id`

- [Obter trecho da Base de conhecimento](/docs/pt/api-reference/knowledge-base/get-chunk)

  - Adicionado o parâmetro de consulta `embedding_model` (string, opcional) para especificar o modelo de embedding para recuperação de trechos

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

  - Adicionado suporte a `guardrail_trigger_action` com os esquemas `EndCallTriggerAction` e `RetryTriggerAction`
  - Adicionado o nó AST `conditional_operator` às definições de expressões de workflow
  - Os esquemas de agentes agora aceitam `ConvAIEnvVarLocator` e `EnvironmentAuthConnectionLocator` para referenciar variáveis de ambiente em configurações de ferramentas

- [Chamada de saída via tronco SIP](/docs/pt/api-reference/sip-trunk/outbound-call)

  - Esquema da solicitação atualizado para acomodar novos campos relacionados ao ambiente

- [Simular conversa](/docs/pt/api-reference/agents/simulate-conversation), [Simular stream de conversa](/docs/pt/api-reference/agents/simulate-conversation-stream)

  - Adicionado o campo `simulation_environment` ao esquema da solicitação

## Alterações de esquema

### Novos esquemas

- `ConvAIEnvironmentVariable`, `ConvAIEnvironmentVariableCreate`, `ConvAIEnvironmentVariableUpdate` - Modelos de variáveis de ambiente compatíveis com tipos string, secreto e de conexão de autenticação
- `ConvAIEnvVarLocator`, `EnvironmentAuthConnectionLocator` - Localizadores para referenciar variáveis de ambiente em configurações de ferramentas e servidores MCP
- `EndCallTriggerAction`, `RetryTriggerAction` - Esquemas de ação de acionamento de guardrail para comportamentos de encerramento de chamada e nova tentativa com feedback
- `ConditionalOperator` - Novo nó AST para expressões condicionais em workflows de agentes
- `AuthConnectionCreateRequest`, `AuthConnectionResponse`, `AuthConnectionDependencies` - Esquemas de gerenciamento de conexões de autenticação do workspace com suporte para OAuth2, JWT, autenticação básica, bearer, cabeçalho personalizado, WhatsApp e métodos de autenticação gerenciados por integração
- `SpeechToTextEvaluation*` - Conjunto de esquemas para critérios de avaliação de Speech to Text, avaliações, agentes humanos e análises

### Esquemas modificados

- `MCPServerConfig`, `MCPServerConfigOutput` - Adicionado suporte a referências `ConvAIEnvVarLocator` na configuração do servidor
- `CustomGuardrailConfig` - Adicionado o campo `trigger_action` para configurar o comportamento de encerramento de chamada ou nova tentativa
- `Contributor` - Adicionados os campos opcionais `bio` (string) e `profile_id` (string)
- `ASTLLMNode` - Adicionado o campo `value_schema`; o campo `prompt` foi descontinuado em favor de `value_schema`
- `TelephonyDirection` - Refatorado para uma enumeração compartilhada referenciada por vários modelos de conversa e telefonia

</Accordion>