> 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.
import { YoutubeEmbed } from "../../../components/YoutubeEmbed";
### CLI da ElevenLabs
A [CLI da ElevenLabs v1.0.0](https://github.com/elevenlabs/cli/releases/tag/v1.0.0) já está disponível. Todas as operações da API da ElevenLabs estão disponíveis como subcomandos, com saída em JSON, tabela, YAML e CSV, paginação automática e preenchimento de comandos no shell.
A CLI também oferece workflows de configuração local para o ElevenAgents. Armazene configurações de agentes, ferramentas e testes como arquivos, sincronize-as com comandos push e pull, gerencie branches, execute testes, instale componentes de interface da ElevenLabs e selecione uma região de residência de dados.
Instale a CLI, autentique-se e gerencie agentes como código.
### Procedimentos
Os procedimentos agora estão disponíveis de forma geral no ElevenAgents. Um procedimento contém instruções específicas para uma tarefa e um gatilho que determina quando elas se aplicam. Durante uma conversa, o agente carrega o procedimento relevante, permitindo que um agente execute tarefas distintas sem incluir todas as instruções no prompt de sistema.
Use procedimentos de formato livre quando o agente puder adaptar a redação ou a ordem das instruções. Use procedimentos estruturados quando as etapas precisarem ser executadas em uma ordem definida. Os dois tipos podem ser usados junto com workflows no mesmo agente.
Saiba quando usar procedimentos e como eles se comparam a prompts e workflows.
Escreva instruções em linguagem natural que o agente pode adaptar à conversa.
Defina etapas tipadas que o agente segue em uma ordem consistente.
### ElevenAgents
- **Tickets de triagem de conversas**: adicionamos APIs para criar tickets sobre o desempenho de agentes, criar tickets manuais de acompanhamento, listar tickets, atribuir membros do workspace, atualizar status e responsável, além de adicionar comentários no nível do ticket ou do turno.
- **Observabilidade de conversas**: os clientes em tempo real podem receber um evento `context_usage` após cada turno concluído do agente. O evento informa o modelo, a contagem de tokens do prompt e o limite de contexto do modelo.
### Lançamentos de SDKs
#### SDK JavaScript
- [v2.65.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.65.0) - Adicionados clientes e tipos para tickets de triagem de conversas e resumos leves de conversas. As APIs de conversa adicionam filtros de procedimento, chamada de ferramenta inválida e ordenação; as APIs de procedimento adicionam seleção de versão do agente; as APIs de tópicos adicionam controles de detalhes de avaliação e ordenação por frustração. O lançamento também adiciona campos de frequência de atualização da base de conhecimento, ambiente de teste e integração de alertas, além de tipos de mensagens de Dubbing em tempo real.
#### SDK Python
- [v2.65.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.65.0) - Adicionados clientes e tipos para tickets de triagem de conversas e resumos leves de conversas. As APIs de conversa adicionam filtros de procedimento, chamada de ferramenta inválida e ordenação; as APIs de procedimento adicionam seleção de versão do agente; as APIs de tópicos adicionam controles de detalhes de avaliação e ordenação por frustração. O lançamento também adiciona campos de frequência de atualização da base de conhecimento, ambiente de teste e integração de alertas, além de preservar campos multipart repetidos para `keyterms` do Speech to Text e `webhook_ids` do Dubbing.
#### SDK Swift
- [v3.3.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.0) - Adicionados parsing tipado de erros do cliente, tratamento de `expects_response` e resultados de ferramentas com segurança de tipos. A inicialização do WebRTC agora fica pronta quando o agente entra, em vez de aguardar a assinatura da faixa de áudio. O lançamento também reforça o tratamento de URLs, elimina o ruído de eventos desconhecidos e remove a alocação de threads em tempo real do processamento de silenciamento por software.
#### Pacotes
- [@elevenlabs/client@1.19.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.19.1), [@elevenlabs/react@1.12.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.3), [@elevenlabs/react-native@1.2.21](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.21), [@elevenlabs/convai-widget-core@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.2) e [@elevenlabs/convai-widget-embed@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.2) - A captura de saída do WebRTC agora usa caminhos AudioWorklet auto-hospedados sob políticas rígidas de segurança de conteúdo. O cache de worklets inclui a fonte solicitada, impedindo que uma URL inline anterior substitua um caminho auto-hospedado. Os erros de configuração do React Native agora apontam para `@elevenlabs/react-native`.
- [@elevenlabs/client@1.20.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.20.0), [@elevenlabs/react@1.12.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.4), [@elevenlabs/react-native@1.2.22](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.22), [@elevenlabs/convai-widget-core@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.3) e [@elevenlabs/convai-widget-embed@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.3) - Adicionada a opção `webRtc.iceTransportPolicy`. Defina-a como `relay` para restringir os candidatos ICE do WebRTC a retransmissores TURN em redes que bloqueiam tráfego UDP direto.
- [@elevenlabs/client@1.21.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.21.0), [@elevenlabs/react@1.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.13.0), [@elevenlabs/types@0.21.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.21.1), [@elevenlabs/react-native@1.2.23](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.23), [@elevenlabs/convai-widget-core@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.4) e [@elevenlabs/convai-widget-embed@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.4) - Adicionados o callback `onContextUsage` e o tipo `ContextUsageEvent`. O React expõe o callback por meio de `useConversation`. O React Native agora é resolvido pela condição de exportação do pacote, em vez da detecção de variáveis globais do navegador.
- [@elevenlabs/client@1.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.22.0), [@elevenlabs/react@1.14.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.14.0), [@elevenlabs/types@0.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.22.0), [@elevenlabs/react-native@1.2.24](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.24), [@elevenlabs/convai-widget-core@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.17.0) e [@elevenlabs/convai-widget-embed@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.17.0) - Adicionado conteúdo avançado na primeira mensagem com respostas de botões atribuídas, `onExternalAgentDisconnected` e `onMCPToolApprovalRequest`. O WebRTC agora usa o dispositivo de entrada selecionado, preserva o estado de silenciamento ao trocar de microfone e falha na configuração caso os dados de inicialização não possam ser enviados. O widget adiciona o status da fila de concorrência, seleção opcional de idioma no acionador recolhido e renderização da primeira mensagem para agentes compatíveis com texto e voz.
### API
## Novos endpoints
### ElevenAgents
- Adicionados nove endpoints de tickets de triagem de conversas:
- [Criar ticket de conversa](/docs/pt/api-reference/triage-tickets/create-agent-conversation-ticket-route) - `POST /v1/convai/triage-tickets`. A solicitação requer `conversation_id` (string) e aceita `qa_comment` (string anulável, de 1 a 10.000 caracteres) e até 200 comentários de turno.
- [Listar tickets](/docs/pt/api-reference/triage-tickets/list-agent-conversation-tickets-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets`, com paginação por cursor.
- [Criar ticket manual](/docs/pt/api-reference/triage-tickets/create-manual-agent-ticket-route) - `POST /v1/convai/agents/{agent_id}/triage-tickets`. A solicitação requer `qa_comment` (string, de 1 a 10.000 caracteres).
- [Listar usuários atribuíveis](/docs/pt/api-reference/triage-tickets/get-assignable-users-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users`. A resposta lista membros do workspace que não são contas de serviço e indica se cada membro tem acesso ao agente.
- [Obter ticket](/docs/pt/api-reference/triage-tickets/get-agent-conversation-ticket-route) - `GET /v1/convai/triage-tickets/{agentqa_ticket_id}`.
- [Atualizar ticket](/docs/pt/api-reference/triage-tickets/update-agent-conversation-ticket-route) - `PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}`. A solicitação aceita `status` opcional e `assignee_user_id` anulável.
- [Excluir ticket](/docs/pt/api-reference/triage-tickets/delete-agent-conversation-ticket-route) - `DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}`.
- [Adicionar comentário](/docs/pt/api-reference/triage-tickets/add-ticket-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments`. A solicitação requer `comment` (string, de 1 a 10.000 caracteres).
- [Adicionar comentário de turno](/docs/pt/api-reference/triage-tickets/add-turn-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments`. A solicitação requer `turn_index` com base zero (inteiro) e `comment` (string, de 1 a 10.000 caracteres).
## Endpoints atualizados
### ElevenAgents
- [Obter URL assinada](/docs/pt/api-reference/conversations/get-signed-url) - `GET /v1/convai/conversation/get-signed-url`
- Adicionado `debug_events_request` opcional (booleano, padrão `false`). Eventos de depuração exigem acesso de editor ao agente.
- [Obter token WebRTC](/docs/pt/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
- Adicionado `debug_events_request` opcional (booleano, padrão `false`). A rota legada `GET /v1/convai/conversation/get_signed_url` aceita o mesmo parâmetro.
- [Listar conversas](/docs/pt/api-reference/conversations/list) - `GET /v1/convai/conversations`
- Adicionado `triggered_procedure_ids` opcional (array de strings anulável, máximo de 50) para corresponder a conversas em que qualquer procedimento especificado foi executado.
- Adicionado `include_invalid_tool_calls` opcional (booleano, padrão `false`) para incluir chamadas de ferramentas que não foram executadas.
- Adicionado `sort_direction` opcional (`asc` ou `desc`, padrão `desc`) para o horário de início da chamada.
- [Pesquisar mensagens de conversa por texto](/docs/pt/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
- Adicionado `triggered_procedure_ids` opcional (array de strings anulável, máximo de 50).
- Adicionado `include_invalid_tool_calls` opcional (booleano, padrão `false`).
- [Obter tópicos de conversa do agente](/docs/pt/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
- Adicionado `include_evaluation_criteria` opcional (booleano, padrão `true`).
- Adicionado `frustration` a `sort_by`.
- As respostas de tópicos adicionam `success_rate` anulável (número), enquanto a resposta geral adiciona `aggregated_run_count` (inteiro, padrão `0`).
- `from_unix_secs` é arredondado para baixo até o início do dia UTC correspondente. Um intervalo limitado agrega execuções diárias de descoberta concluídas; omitir ambos os limites retorna a execução mais recente.
- [Listar procedimentos](/docs/pt/api-reference/agents/procedures/list) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`) e [Obter procedimento](/docs/pt/api-reference/agents/procedures/get) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`)
- Adicionado `agent_version_id` opcional anulável (string) para recuperar procedimentos de uma versão específica do agente.
- [Criar teste](/docs/pt/api-reference/tests/create) e [Atualizar teste](/docs/pt/api-reference/tests/update)
- Adicionado `environment` opcional anulável (string) aos esquemas de teste unitário de resposta, simulação e chamada de ferramenta. O valor seleciona URLs, cabeçalhos e conexões de autenticação específicos do ambiente; o padrão é `production`.
- [Criar documento a partir de URL](/docs/pt/api-reference/knowledge-base/create-from-url), [Criar tarefa de rastreamento](/docs/pt/api-reference/knowledge-base/create-crawl-job) e [Criar pasta](/docs/pt/api-reference/knowledge-base/create-folder)
- Adicionado `minimum_frequency_days` opcional anulável (inteiro, de 1 a 180) para sincronização automática. O padrão é `7`, e uma frequência mais restritiva da pasta pai tem precedência.
### Música
- [Listar Finetunes de música](/docs/pt/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
- Aumentado o máximo de `page_size` de 100 para 150. O padrão permanece 50.
## Alterações no esquema
### ElevenAgents
- As solicitações de atualização de agente adicionam `procedures` opcional anulável (`object`). Cada valor requer `procedure_id` e `version_id` (strings). Um objeto vazio remove todos os procedimentos.
- A configuração de inicialização de conversa adiciona `enable_procedure_ids_from_client` (booleano, padrão `false`). Os dados de inicialização adicionam `procedure_ids` opcional anulável (array de strings); um array vazio desativa todos os procedimentos para o agente inicial.
- `ClientEvent` adiciona `context_usage`.
- As substituições de tempo limite flexível adicionam `additional_soft_timeout_messages` opcional anulável (array de strings).
- Valores constantes nos modelos de análise e substituição de esquema agora aceitam `null`.
- Os padrões da configuração do widget para `mic_muting_enabled` e `transcript_enabled` foram alterados de `false` para `true`. Defina-os explicitamente como `false` para preservar o comportamento anterior.
### Workspace
- As respostas de [Obter usuário](/docs/pt/api-reference/user/get) removeram `xi_api_key` de `UserResponseModel`.
- `ResourceMetadataResponseModel.role_to_group_ids` agora aceita IDs de função personalizados como chaves, em vez de restringir as chaves a `admin`, `editor`, `commenter` e `viewer`.
- As respostas de publicação direta adicionam `restricted_to_user_email_domains` opcional anulável (array de strings).
- As respostas de alteração de assinatura pendente adicionam `go` a `next_tier`.