Workflows
Visão geral
Os Workflows de Agentes oferecem uma interface visual poderosa para criar fluxos de conversa complexos no ElevenAgents. Em vez de depender de caminhos lineares de conversa, os workflows permitem criar grafos de conversa sofisticados e ramificados que se adaptam dinamicamente às necessidades do usuário.

Como criar workflows
O dashboard é a maneira recomendada de criar workflows por causa do editor visual de grafos. Os workflows são armazenados no campo workflow de nível superior do agente, então você também pode obter, editar e enviar o JSON pela CLI ou atualizá-lo pelo SDK — útil para controle de versão e CI/CD.
Para criar ou editar workflows em Python ou JavaScript sem escrever manualmente o JSON de nós e arestas,
use o construtor Workflow.
Criar pelo dashboard
Atualizar pela CLI
Atualizar pela API
Abra seu agente no dashboard, acesse a aba Workflow e use o editor visual para adicionar nós, configurar o comportamento de subagentes e conectar arestas. Salve suas alterações.
Tipos de nó
Os workflows são compostos por diferentes tipos de nó, cada um com uma finalidade específica no seu fluxo de conversa.

Nós de subagente
Os nós de subagente permitem modificar o comportamento do agente em pontos específicos do workflow. Essas modificações são aplicadas sobre a configuração base do agente ou podem substituir completamente a configuração do agente atual, oferecendo controle detalhado sobre cada fase da conversa. Qualquer configuração do agente, as ferramentas disponíveis e os itens anexados da base de conhecimento podem ser atualizados ou substituídos.
Geral
Base de conhecimento
Ferramentas

Modifique as configurações principais do agente para este nó específico:
- Prompt de sistema: Adicione ou substitua instruções do sistema para orientar o comportamento do agente
- Seleção de LLM: Escolha outro modelo de linguagem (por exemplo, mude do Gemini 2.0 Flash para um modelo mais avançado em tarefas de raciocínio complexas)
- Configuração de voz: Altere configurações de voz, incluindo velocidade e tom, ou até mude para outra voz
Casos de uso:
- Use um LLM mais avançado em nós de tomada de decisões complexas
- Aplique diretrizes de conversa mais rigorosas durante a coleta de informações sensíveis
- Altere as características da voz em diferentes fases da conversa
- Modifique a personalidade do agente para tipos específicos de interação
Nó de fala
Um nó de fala faz o agente dizer uma mensagem em um ponto específico do workflow e, em seguida, continuar pelas arestas de saída. Use-o quando a redação de uma mensagem for importante e não deva ficar a cargo de um subagente, por exemplo, em uma saudação, um aviso legal ou uma confirmação lida para o usuário.
Cada nó de fala envia sua mensagem em um de dois modos:
- Literal: o agente fala o texto exato que você inserir, com uma tradução opcional para cada idioma configurado.
- Prompt: o LLM gera a mensagem a partir de uma descrição que você escreve.
Nó de ferramenta de despacho
Os nós de ferramenta executam uma chamada de ferramenta específica durante o fluxo da conversa. Ao contrário das ferramentas dentro de subagentes, os nós de ferramenta são pontos de execução dedicados que garantem que a ferramenta seja chamada.

Configuração especial de aresta: Os nós de ferramenta têm um tipo de aresta exclusivo que permite direcionar para um novo nó com base no resultado da execução da ferramenta. Você pode definir:
- Caminho de sucesso: para onde direcionar quando a ferramenta for executada com sucesso
- Caminho de falha: para onde direcionar quando a ferramenta falhar ou retornar um erro
No futuro, serão disponibilizadas outras condições de ramificação.
Nó de atualização de estado
Um nó de atualização de estado atribui uma ou mais variáveis dinâmicas sempre que o workflow passa por ele, usando as mesmas expressões da ferramenta Atualizar estado. Ao contrário da ferramenta, que é executada quando o LLM decide chamá-la, o nó sempre aplica suas atualizações naquele ponto do grafo e então continua pelas arestas de saída.
Saiba mais aqui.
Nó de transferência de agente
O nó de transferência de agente facilita a transferência da conversa entre diferentes agentes conversacionais. Saiba mais aqui.
Nó de transferência para número
Os nós de transferência para número fazem a transição de uma conversa com um agente de IA para um agente humano por sistemas telefônicos. Saiba mais aqui
Nó de encerramento
Os nós de encerramento de chamada finalizam o fluxo da conversa de forma adequada. Saiba mais aqui
Arestas e controle de fluxo
As arestas definem como as conversas fluem entre os nós do workflow. Elas oferecem uma lógica de roteamento sofisticada que permite caminhos de conversa dinâmicos e contextualizados.

Arestas de avanço
Arestas de retorno
As arestas de avanço movem a conversa para os nós seguintes do workflow. Elas representam o fluxo principal da sua conversa.

Condição de LLM
Expressão
Nenhuma
Use condições de LLM para criar fluxos de conversa dinâmicos com base em avaliações em linguagem natural. O LLM avalia as condições em tempo real para determinar o caminho adequado.

Opções de configuração:
- Rótulo: Descrição legível da condição da aresta (não processada pelo LLM)
- Condição de LLM: Condição em linguagem natural avaliada pelo LLM
Análises

Quando um workflow está ativo, a aba Workflow no dashboard de análises sobrepõe dados de uso ao grafo: entradas por nó, tempo médio gasto e encerramentos, além da distribuição das arestas de entrada e saída de cada nó. No inspetor de nós, você também pode acessar diretamente as conversas correspondentes no histórico pelo filtro Nó acessado.