> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inceptia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# O canvas de agentes

> O fluxo conversacional do bot é projetado em um canvas visual com nós conectados

## 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.

<Tip>
  Quando vale a pena dividir o fluxo em vários agentes em vez de um só? Veja [Princípios de design](/pt-BR/construccion/buenas-practicas/principios-de-diseno).
</Tip>

<img src="https://mintcdn.com/inceptia/2xrQ5P1QkQTHz4UH/images/construccion/agentes/canvas/01-canvas.png?fit=max&auto=format&n=2xrQ5P1QkQTHz4UH&q=85&s=d3f978b5507bf2d8ee59d5079b7555c5" alt="Canvas de agentes com nós conectados" width="1440" height="900" data-path="images/construccion/agentes/canvas/01-canvas.png" />

***

## Tipos de agente

Os agentes se distinguem pela sua **cor** no canvas, que indica seu papel dentro do fluxo:

| Cor         | Tipo             | Papel                                                                                                        |
| ----------- | ---------------- | ------------------------------------------------------------------------------------------------------------ |
| 🟢 Verde    | **Iniciador**    | Ponto de entrada da conversa. Toda chamada começa aqui. Só pode haver um por bot.                            |
| 🔵 Azul     | **Padrão**       | Agente geral para qualquer parte do fluxo: negociação, consultas, acordos, etc.                              |
| 🔴 Vermelho | **Pós-Conversa** | Executa **sempre**, depois que a chamada termina. Atribui a etiqueta de resultado, mas não se limita a isso. |

<Info>
  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.
</Info>

***

## 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](/pt-BR/construccion/agentes/cambio-de-agente)** dentro do agente de origem.

<Tip>
  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.
</Tip>

Você também pode iniciar uma conexão diretamente arrastando no canvas, sem entrar na aba do agente. Veja [Conectar agentes arrastando no Canvas](/pt-BR/construccion/agentes/cambio-de-agente#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.

<img src="https://mintcdn.com/inceptia/2xrQ5P1QkQTHz4UH/images/construccion/agentes/canvas/02-panel-de-agentes.png?fit=max&auto=format&n=2xrQ5P1QkQTHz4UH&q=85&s=a78ee9e319ddc02bb9ed48289ff30d37" alt="Painel de agentes aberto com a lista completa e buscador" width="1440" height="900" data-path="images/construccion/agentes/canvas/02-panel-de-agentes.png" />

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:

<CardGroup cols={2}>
  <Card title="Identidade" icon="id-card" href="/pt-BR/construccion/agentes/identidad">
    Mensagem inicial e instruções do agente.
  </Card>

  <Card title="Ferramentas" icon="wrench" href="/pt-BR/construccion/agentes/herramientas">
    Funções que o agente pode executar.
  </Card>

  <Card title="Lógica" icon="code" href="/pt-BR/construccion/agentes/logica">
    Código Python para preparar o contexto.
  </Card>

  <Card title="Mudança de Agente" icon="arrow-right-arrow-left" href="/pt-BR/construccion/agentes/cambio-de-agente">
    Regras de transferência para outros agentes.
  </Card>
</CardGroup>
