ElevenAgents

  • Substituições de branch e ambiente no WhatsApp: Mensagens de WhatsApp enviadas e chamadas realizadas agora respeitam branch_id e environment enviados em conversation_initiation_client_data. As substituições são validadas antes de qualquer envio — uma branch ou ambiente desconhecido é rejeitado com um erro — e persistem durante a conversa, para que a resposta de um cliente seja retomada na branch e no ambiente solicitados. Veja exemplos no guia do WhatsApp.
  • APIs de procedimentos: Adicionamos oito operações públicas com escopo de branch para gerenciar procedimentos. Você pode criar, listar, recuperar e remover procedimentos; criar, recuperar ou descartar alterações em rascunho; e compilar rascunhos de procedimentos em um workflow de agente. A criação de procedimentos aceita name, content, type e trigger. Um trigger vazio cria um subprocedimento, enquanto um gatilho omitido ou null é derivado do conteúdo do procedimento.
  • Tarefas de rastreamento da base de conhecimento: Adicionamos APIs para criar, listar, inspecionar e cancelar tarefas de rastreamento. As solicitações de criação exigem url (string) e oferecem suporte a profundidade de rastreamento, limites de páginas, padrões de URL, URLs de sitemap, posicionamento em pastas, sincronização automática e remoção de documentos indisponíveis.
  • Gerenciamento em massa da base de conhecimento: Adicionamos verificações de dependências em massa e exclusão em massa para 1–20 IDs únicos de documentos ou pastas. As verificações de dependências oferecem suporte a paginação e dependent_type; a exclusão retorna sucesso ou falha independentes para cada ID. Definir force: true também remove dependências e exclui recursivamente pastas não vazias.
  • Exportação de resultados de chamadas em lote: Adicionamos Exportar resultados de chamadas em lote para baixar destinatários e resultados de conversas de um lote concluído como CSV.
  • Filtros de conversa e dados de análise: Listar conversas e Pesquisar mensagens de conversa por texto adicionam os filtros opcionais de array visited_agent_ids e visited_agent_branch_ids, cada um limitado a 50 valores. As solicitações de listagem também aceitam data_collection_ids e evaluation_criteria_ids para incluir os resultados correspondentes em cada resumo de conversa. Os resumos adicionam data_collection_results, evaluation_criteria_results e tag_ids opcionais.
  • Configuração de análise por referência: As configurações da plataforma de agentes adicionam o campo opcional e anulável analysis_items, tipado como AgentAnalysisItems, para anexar itens de avaliação e coleta de dados por referência. Um valor null indica que o agente ainda usa os campos inline legados; um valor vazio indica um agente migrado sem itens anexados.
  • Metadados de dependência de procedimentos: As referências a procedimentos adicionam trigger (string) e arrays para referenced_tool_ids, referenced_kb_ids, referenced_procedure_ids e referenced_dynamic_variables.
  • Resposta de token WebRTC: As respostas de Obter token WebRTC agora exigem conversation_id (string), além de token. Esta é uma alteração incompatível de esquema para clientes que validam ou desserializam o formato da resposta.
  • Resultados de RAG da base de conhecimento: KnowledgeBaseRagToolResultModel adiciona chunks (KnowledgeBaseRagChunkModel[]) para o modo de resultado de RAG no resultado da ferramenta.

Estúdio

  • Status de projeto em rascunho: ProjectCreationMetaResponseModel.status adiciona draft. O tipo de criação de projeto agora usa o enum compartilhado ProjectCreationMetaType com os mesmos valores existentes.

Vozes

  • Sotaques de voz: Adicionamos GET /v1/voices/accents para listar os sotaques disponíveis na biblioteca de vozes compartilhada. Os resultados podem ser filtrados por language e model_id, e cada sotaque retorna accent, language, code e name legível por humanos. O valor de accent pode ser passado para o parâmetro de consulta accent em Obter vozes compartilhadas para filtrar vozes compartilhadas.

Workspaces

  • Relatórios de uso de webhooks: WebhookUsageType adiciona Flows.

Lançamentos de SDKs

SDK JavaScript

  • v2.60.0 - Adicionamos voices.accents.get para listar sotaques de voz na biblioteca de vozes compartilhada, além das APIs de procedimentos do ElevenAgents, tarefas de rastreamento da base de conhecimento, gerenciamento em massa e configuração de análise por referência do esquema mais recente.

SDK Python

  • v2.60.0 - Adicionamos as APIs de sotaques de voz, procedimentos do ElevenAgents, tarefas de rastreamento da base de conhecimento e gerenciamento em massa do esquema mais recente. Também corrigimos a inicialização de AsyncConversation para que ela não bloqueie mais e ajustamos os campos multipart de listas de primitivas para serem enviados como campos de formulário repetidos.

Pacotes

API

Novos endpoints

ElevenAgents

  • POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
    • Cria um procedimento e retorna seu procedure_id (string)
    • Aceita name opcional (string, máximo de 200 caracteres), content (string), type (ProcedureType, padrão free_form) e trigger (string anulável)
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
    • Lista procedimentos da branch com procedure_id, version_id, name, type, trigger e has_draft
    • Exclui o conteúdo dos procedimentos; recupere um procedimento individual para ler seu conteúdo
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
    • Aceita version_id opcional (string); caso contrário, retorna a versão no topo da branch
    • Retorna name, content, type e trigger
  • DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
    • Remove o procedimento do conjunto de trabalho em rascunho da branch
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Retorna o rascunho atual do procedimento
  • PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Cria ou atualiza um rascunho
    • Exige name (string, máximo de 200 caracteres), content (string, máximo de 50.000 caracteres) e type (ProcedureType); aceita trigger opcional (string anulável)
  • DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Descarta as alterações do rascunho e redefine o procedimento para a versão confirmada
  • POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/compile
    • Compila rascunhos de procedimentos em um AgentWorkflowResponseModel
  • Criar tarefa de rastreamento - POST /v1/convai/knowledge-base/crawl
    • Exige url (string)
    • Aceita max_depth opcional (inteiro, 1–5, padrão 3), max_pages (inteiro, 1–10.000, padrão 1000), pattern (string), sitemap_urls (array de strings), parent_folder_id (string), enable_auto_sync (booleano, padrão false) e auto_remove (booleano, padrão false)
  • Listar tarefas de rastreamento - GET /v1/convai/knowledge-base/crawl
    • Aceita include_job_ids opcional (array de strings), page_size (inteiro, 1–100, padrão 30) e cursor (string)
  • Obter tarefa de rastreamento - GET /v1/convai/knowledge-base/crawl/{crawl_job_id}
  • Cancelar tarefa de rastreamento - POST /v1/convai/knowledge-base/crawl/{crawl_job_id}/cancel
  • Obter agentes dependentes para vários documentos - POST /v1/convai/knowledge-base/dependent-agents
    • Exige document_ids (array de 1–20 strings únicas)
    • Aceita dependent_type opcional (KnowledgeBaseDependentType, padrão all), page_size (inteiro, 1–100, padrão 30) e cursor (string)
  • Excluir documentos da base de conhecimento em massa - POST /v1/convai/knowledge-base/bulk-delete
    • Exige document_ids (array de 1–20 strings únicas)
    • Aceita force opcional (booleano, padrão false)
    • Retorna um resultado de sucesso ou falha para cada ID de documento
  • Exportar resultados de chamadas em lote - GET /v1/convai/batch-calling/{batch_id}/export
    • Retorna destinatários e resultados de conversas de lotes concluídos como CSV

Vozes

  • GET /v1/voices/accents
    • Lista os sotaques disponíveis na biblioteca de vozes compartilhada
    • Aceita parâmetros de consulta opcionais language (string) e model_id (string)
    • Cada sotaque retorna accent, language, code e name

Endpoints atualizados

ElevenAgents

  • Listar conversas - GET /v1/convai/conversations
    • Adicionados filtros opcionais de array de strings visited_agent_ids e visited_agent_branch_ids, cada um limitado a 50 valores
    • Adicionados arrays de strings opcionais data_collection_ids e evaluation_criteria_ids para selecionar resultados de análise para cada resumo
    • Os resumos de resposta adicionam os campos de objeto opcionais data_collection_results e evaluation_criteria_results, além do array de strings tag_ids
  • Pesquisar mensagens de conversa por texto - GET /v1/convai/conversations/messages/text-search
    • Adicionados filtros opcionais de array de strings visited_agent_ids e visited_agent_branch_ids, cada um limitado a 50 valores
  • Obter token WebRTC - GET /v1/convai/conversation/token
    • As respostas agora exigem conversation_id (string)
    • Incompatível: validadores e desserializadores de resposta estritos devem aceitar o novo campo obrigatório

Alterações de esquema

ElevenAgents

  • As configurações de solicitação e resposta da plataforma de agentes adicionam o campo opcional e anulável analysis_items, tipado como AgentAnalysisItems, para configuração de avaliação e coleta de dados por referência
  • As referências a procedimentos adicionam trigger (string), referenced_tool_ids (array de strings), referenced_kb_ids (array de strings), referenced_procedure_ids (array de strings) e referenced_dynamic_variables (array de strings)
  • KnowledgeBaseRagToolResultModel adiciona chunks (KnowledgeBaseRagChunkModel[])

Estúdio

  • ProjectCreationMetaResponseModel.status adiciona draft
  • ProjectCreationMetaResponseModel.type agora referencia o enum compartilhado ProjectCreationMetaType

Workspaces

  • WebhookUsageType adiciona Flows