> 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. ### Plataforma de Agentes - **Ramificações e implantações de agentes**: Adicionado um sistema completo de controle de versões para agentes, permitindo que as equipes criem ramificações, iterem nas configurações dos agentes de forma isolada e mesclem as alterações quando estiverem prontas. Os novos endpoints incluem `POST /v1/convai/agents/{agent_id}/branches` para criar ramificações, `POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge` para mesclar e `POST /v1/convai/agents/{agent_id}/deployments` para criar implantações. Rascunhos também podem ser criados e excluídos pelos novos endpoints de rascunhos. Consulte a documentação de [Ramificações](/docs/pt/api-reference/agents/branches/list) e [Implantações](/docs/pt/api-reference/agents/deployments/create) para mais detalhes. - **Gerenciamento de contas do WhatsApp**: Adicionados endpoints `PATCH` e `DELETE` para contas do WhatsApp Business, permitindo atualizar e remover dos agentes as contas conectadas do WhatsApp. - **Nome do agente na conversa**: O endpoint [Obter conversa](/docs/pt/api-reference/conversations/get) agora retorna `agent_name` na resposta para facilitar a identificação do agente que conduziu uma conversa. - **Acompanhamento de tipos de erro**: Adicionado o campo `error_type` aos modelos de eventos de conversa para melhorar a depuração e a categorização de erros. ### Base de conhecimento - **Gerenciamento de pastas**: Adicionado suporte para organizar documentos da base de conhecimento em pastas. Os novos endpoints incluem [Criar pasta](/docs/pt/api-reference/knowledge-base/create-folder) para criar pastas, [Mover documento](/docs/pt/api-reference/knowledge-base/move-document) para mover documentos individuais e [Mover em massa](/docs/pt/api-reference/knowledge-base/bulk-move) para mover vários documentos de uma vez. ### Ferramentas - **Listagem de ferramentas aprimorada**: O endpoint [Obter ferramentas](/docs/pt/api-reference/tools/list) agora oferece suporte a filtragem e paginação com novos parâmetros de consulta, incluindo `search`, `page_size`, `types`, `sort_by`, `sort_direction` e `cursor`. A resposta agora inclui os campos `next_cursor` e `has_more` para paginação. ### Música - **Melhorias nos metadados da música**: Adicionados os campos `bpm` e `time_signature` aos metadados da música para fornecer informações mais completas de análise de áudio. ### ElevenCreative Studio - **Modelos de estilo de legenda**: Adicionado o campo `caption_style_template_overrides` aos modelos de projeto, permitindo personalizar o estilo das legendas por modelo. - **Tipo de projeto de dublagem de vídeo**: Adicionado `dub_video` ao enum de tipo de criação de projeto. - **Metadados de publicação**: Adicionado o carimbo de data e hora `last_updated_from_project_unix` aos metadados de publicação e de projeto. ### Workspaces - **Gerenciamento de tipos de assento**: Introduzido o novo enum `SeatType` com os campos `seat_type` e `workspace_seat_type`, descontinuando os campos anteriores `workspace_permission` e `workspace_role`. - **Permissão de análises do workspace**: Adicionado `workspace_analytics_full_read` ao enum `PermissionType` para controle de acesso granular às análises. ### Lançamentos de SDK #### SDK Python - [v2.32.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.32.0) - Adicionados endpoints de ramificações, implantações e rascunhos de agentes, gerenciamento de pastas da base de conhecimento, listagem de ferramentas aprimorada com filtragem e paginação, e gerenciamento de tipos de assento #### SDK JavaScript - [v2.33.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.33.0) - Adicionados endpoints de ramificações, implantações e rascunhos de agentes, gerenciamento de pastas da base de conhecimento, listagem de ferramentas aprimorada com filtragem e paginação, e gerenciamento de tipos de assento ### API ## Novos endpoints - [Listar ramificações de agentes](/docs/pt/api-reference/agents/branches/list) - `GET /v1/convai/agents/{agent_id}/branches` - Lista todas as ramificações de um agente - [Criar ramificação de agente](/docs/pt/api-reference/agents/branches/create) - `POST /v1/convai/agents/{agent_id}/branches` - Cria uma nova ramificação para um agente - [Obter ramificação de agente](/docs/pt/api-reference/agents/branches/get) - `GET /v1/convai/agents/{agent_id}/branches/{branch_id}` - Obtém uma ramificação específica - [Atualizar ramificação de agente](/docs/pt/api-reference/agents/branches/update) - `PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}` - Atualiza a configuração da ramificação - [Mesclar ramificação de agente](/docs/pt/api-reference/agents/branches/merge) - `POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge` - Mescla uma ramificação em uma ramificação de destino - [Criar implantação](/docs/pt/api-reference/agents/deployments/create) - `POST /v1/convai/agents/{agent_id}/deployments` - Cria ou atualiza implantações de agentes - [Criar rascunho](/docs/pt/api-reference/agents/drafts/create) - `POST /v1/convai/agents/{agent_id}/drafts` - Cria um rascunho de agente - [Excluir rascunho](/docs/pt/api-reference/agents/drafts/delete) - `DELETE /v1/convai/agents/{agent_id}/drafts` - Exclui um rascunho de agente - [Criar pasta](/docs/pt/api-reference/knowledge-base/create-folder) - `POST /v1/convai/knowledge-base/folder` - Cria uma pasta para agrupar documentos - [Mover documento](/docs/pt/api-reference/knowledge-base/move-document) - `POST /v1/convai/knowledge-base/{document_id}/move` - Move um documento para uma pasta - [Mover em massa](/docs/pt/api-reference/knowledge-base/bulk-move) - `POST /v1/convai/knowledge-base/bulk-move` - Move vários documentos para uma pasta ## Endpoints atualizados ### Plataforma de Agentes - [Obter ferramentas](/docs/pt/api-reference/tools/list) - Adicionado o parâmetro de consulta `search` (string, opcional) para filtrar ferramentas pelo prefixo do nome - Adicionado o parâmetro de consulta `page_size` (inteiro, opcional, máximo 100, padrão 30) - Adicionado o parâmetro de consulta `show_only_owned_documents` (booleano, opcional, padrão false) - Adicionado o parâmetro de consulta `types` (array, opcional) para filtrar por tipo de ferramenta - Adicionado o parâmetro de consulta `sort_by` (enum, opcional) para ordenar os resultados - Adicionado o parâmetro de consulta `sort_direction` (enum, opcional) para a ordem de classificação - Adicionado o parâmetro de consulta `cursor` (string, opcional) para paginação - A resposta agora inclui os campos `next_cursor` (string) e `has_more` (booleano, obrigatório) - [Criar agente](/docs/pt/api-reference/agents/create) - Esquema da solicitação atualizado com suporte a ramificações - [Obter conversa](/docs/pt/api-reference/conversations/get) - Adicionado `agent_name` (string, opcional) ao modelo de resposta - [Criar rascunho de agente](/docs/pt/api-reference/agents/drafts/create) - O campo `tags` passou a ser opcional e foi removido dos campos obrigatórios ### Dicionários de pronúncia - [Adicionar regras](/docs/pt/api-reference/pronunciation-dictionaries/rules/add) - Descrição atualizada para esclarecer que regras com valores `string_to_replace` duplicados serão substituídas ### Workspaces - [Adicionar convite ao workspace](/docs/pt/api-reference/workspace/invites/create), [Adicionar membro ao workspace](/docs/pt/api-reference/workspace/invites/create) - Adicionado o campo `seat_type` (enum, opcional) - Descontinuados os campos `workspace_permission` e `workspace_role` em favor de `seat_type` ### ElevenCreative Studio - [Criar projeto](/docs/pt/api-reference/studio/add-project) - Adicionado o campo `create_publishing_read` (booleano, opcional) - Adicionado `dub_video` ao enum de tipo de projeto - [Obter projeto](/docs/pt/api-reference/studio/get-project), [Atualizar projeto](/docs/pt/api-reference/studio/edit-project) - Adicionado `caption_style_template_overrides` (objeto, opcional) para estilo de legenda personalizado ## Alterações de esquema ### Novos esquemas - `AgentBranch`, `AgentBranchInput`, `AgentBranchOutput` - Configuração de ramificações para agentes - `AgentDeployment`, `AgentDeploymentInput` - Configuração de implantações para agentes - `AgentVersion` - Informações sobre a versão do agente - `BranchProtectionStatus` - Configurações de proteção de ramificação - `SeatType` - Enum para tipos de assento no workspace - `ToolSortBy` - Enum para opções de ordenação de ferramentas - `ToolTypeFilter` - Enum para filtrar ferramentas por tipo - `CaptionStyleModel` - Configuração de estilo de legenda ### Esquemas modificados - `ToolsResponseModel` - Adicionados os campos `next_cursor` e `has_more` para paginação - `SongMetadata` - Adicionados os campos `bpm` (número) e `time_signature` (string) - `GetConversationResponseModel` - Adicionado o campo `agent_name` - `PermissionType` - Adicionado o valor de enum `workspace_analytics_full_read` - `ProjectCreationType` - Adicionado o valor de enum `dub_video` - Vários modelos de eventos - Adicionado o campo `error_type` para categorização de erros