Pular para o conteúdo principal

O que é o canvas

Quando você abre um bot e vai até a aba Agentes, encontra um canvas visual onde cada nó representa um agente — uma unidade de conversa com sua própria identidade, instruções e ferramentas. Os agentes se conectam entre si para formar o fluxo completo da chamada: o bot pode passar de um agente para outro de acordo com o que a pessoa diz, as condições que se cumprem ou as ações que são executadas.
Quando vale a pena dividir o fluxo em vários agentes em vez de um só? Veja Princípios de design.
Canvas de agentes com nós conectados

Tipos de agente

Os agentes se distinguem pela sua cor no canvas, que indica seu papel dentro do fluxo:
O Classifier é disparado automaticamente ao finalizar a chamada, sem poder ser desativado. Como não fala com a pessoa, não tem aba Identidade nem Lógica: seu menu lateral é Instruções e Ferramentas. Em Instruções, os rótulos são inseridos a partir de um painel em vez de escritos à mão — ver Referenciar rótulos no prompt.
Além de atribuir o rótulo, a ferramenta do Classifier admite parâmetros adicionais (por exemplo, um resumo da conversa ou outras variáveis próprias) que, com a ajuda de código Python, ficam disponíveis para os usuários na visão operacional de chamadas da plataforma. Ver Variáveis capturadas pelo bot durante a conversa.

Conectar agentes

As conexões entre agentes definem quando e para onde a conversa pode “pular”. Cada conexão é configurada na aba Mudança de Agente dentro do agente de origem.
Um agente pode ter múltiplas regras de mudança para destinos diferentes. O LLM avalia as condições e escolhe o agente correto de acordo com o contexto da conversa.
Você também pode iniciar uma conexão diretamente arrastando no canvas, sem entrar na aba do agente. Veja Conectar agentes arrastando no Canvas.

Mostrar o painel de agentes

Em bots com muitos agentes, o canvas pode ficar difícil de percorrer a olho nu. O ícone ☰ no grupo de controles do canvas (junto com Zoom In, Zoom Out e Fit View) abre um painel com a lista completa de agentes do bot, seu tipo, e um buscador para encontrar um pelo nome. Painel de agentes aberto com a lista completa e buscador Clique em qualquer agente da lista para abrir seu editor, assim como clicando no seu nó dentro do canvas.

Explorar um agente

Clique em qualquer nó do canvas para abrir o editor do agente. Dentro você encontra quatro abas:

Identidade

Mensagem inicial e instruções do agente.

Ferramentas

Funções que o agente pode executar.

Lógica

Código Python para preparar o contexto.

Mudança de Agente

Regras de transferência para outros agentes.