Workflows
Visão geral
Os Workflows de Agentes oferecem uma interface visual avançada para projetar 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.

Criação de workflows
O painel é a forma recomendada de criar workflows devido ao editor visual de grafos. Os workflows são armazenados no campo workflow de nível superior do agente, portanto você também pode baixar, editar e enviar o JSON pela CLI ou atualizá-lo pelo SDK — o que é útil para controle de versão e CI/CD.
Criar pelo painel
Atualizar pela CLI
Atualizar pela API
Abra seu agente no painel, acesse a aba Workflow e use o editor visual para adicionar nós, configurar o comportamento dos subagentes e conectar arestas. Salve suas alterações.
Tipos de nós
Os workflows são compostos por diferentes tipos de nós, cada um com uma finalidade específica no fluxo da sua 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 do agente base ou podem substituir completamente a configuração do agente atual, oferecendo controle detalhado sobre cada fase da conversa. Qualquer configuração do agente, ferramentas disponíveis e itens anexados à base de conhecimento podem ser atualizados/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 complexas de raciocínio)
- Configuração de voz: Altere as configurações de voz, incluindo velocidade, tom ou até mesmo uma voz diferente
Casos de uso:
- Use um LLM mais avançado para nós de tomada de decisão complexa
- Aplique diretrizes de conversa mais rigorosas durante a coleta de informações sensíveis
- Altere as características da voz para 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 então continuar por suas arestas de saída. Use-o quando a redação de uma mensagem for importante e não deva ser deixada a um subagente, por exemplo, em uma saudação, uma declaração 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 diz 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 execução
Os nós de ferramenta executam uma chamada de ferramenta específica durante o fluxo da conversa. Ao contrário das ferramentas em subagentes, os nós de ferramenta são pontos de execução dedicados que garantem que a ferramenta seja chamada.

Configuração especial de arestas: Os nós de ferramenta têm um tipo único de aresta 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 é executada com sucesso
- Caminho de falha: Para onde direcionar quando a ferramenta falha ou retorna um erro
No futuro, serão fornecidas 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 seu workflow. Elas oferecem suporte a uma lógica de roteamento sofisticada que possibilita caminhos de conversa dinâmicos e sensíveis ao contexto.

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 do LLM
Expressão
Nenhuma
Use condições do LLM para criar fluxos de conversa dinâmicos com base em avaliação por 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 do LLM: Condição em linguagem natural avaliada pelo LLM
Análises

Quando um workflow está ativo, a aba Workflow no painel de análises sobrepõe os 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ó. Pelo inspetor de nós, você também pode acessar diretamente as conversas correspondentes no histórico pelo filtro Nó acessado.