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 agente Pós-Conversa é um agente como qualquer outro — tem Identidade, Ferramentas e Lógica —, só que é disparado automaticamente ao finalizar a chamada, sem poder ser desativado. Além de atribuir a etiqueta, sua ferramenta 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.

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.