# Fluxo do Agente

O recurso **Fluxo do Agente** permite contruir fluxos de interação personalizados utilizando componentes visuais, como mensagens, agentes de IA e botões.

### Como acessar

Você pode acessar a tela de **Fluxo do Agente** de duas formas:

* **Menu superior:** em qualquer área do **Skyone Studio**, clique na opção **Fluxo do Agente**, localizada no canto superior direito da tela.
* **Menu lateral:** durante a navegação no **Skyone Studio** (exceto na Home), selecione **Fluxo do Agente** na barra lateral esquerda. 

Ao clicar no menu, você pode:

* Visualizar todas os fluxos do agente existentes no espaço de trabalho;
* Criar um novo fluxo do agente diretamente pelo botão disponível na tela.

#### **Recursos de visualização**

No canto superior direito, utilize as ferramentas para organizar sua visualização dos fluxos:

* **Buscar:** Pesquise fluxos pelo nome.
* **Modo grade:** Visualização padrão em formato de cards.
* **Modo lista:** Exibição em linhas para consulta rápida.
* **Ordem crescente:** Organiza os fluxos em ordem alfabética.

### Como criar um Fluxo do Agente

Criar um **Fluxo do Agente** é muito simples:

1. Na área de **Fluxo do Agente**, clique em **Criar fluxo**.
2. Preencha as informações no modal:
   1. **Nome**
   2. **Descrição**
   3. **Imagem:** carregue ou arraste um arquivo (PNG ou JPG). Após o upload, ajuste o tamanho no modal de edição e clique em Aplicar imagem.basta carregar ou arrastar e soltar um arquivo no respectivo campo.

* 3\. Clique em **Criar** para finalizar.

### Opções do Fluxo do Agente

Cada **Fluxo do Agente** possui o botão de **Opções** (três pontos no canto direito). Ao clicá-lo, você verá as seguintes opções para manejar o fluxo do agente:

* **Visualizar:** abre o fluxo para consulta (também acessível clicando diretamente no card).
* **Editar:** permite alterar nome, descrição e imagem do Fluxo do Agente. Clique em **Editar fluxo** para salvar.
* **Excluir:** Para excluir um fluxo do agente, utilize esta opção. Será mostrada a tela de confirmação da exclusão da integração. Se quiser confirmar, digite o nome do fluxo do agente no campo específico e, em seguida, clique em **Excluir**. 

{% hint style="warning" %}
Não é possível reverter a exclusão. 
{% endhint %}

### Configuração do fluxo do agente

Ao clicar em fluxo do agente, você será direcionado para a área de Whiteboard. Aqui, você tem o controle sobre o seu fluxo, podendo criar, editar e configurar conforme suas necessidades.

#### Barra de Ferramentas

Localizada no lado esquerdo do whiteboard, a barra de ferramentas oferece os seguintes recursos:

* **Ferramenta Mover:** utilizada para navegar pela área do whiteboard arrastando a tela.
* **Ferramenta de Seleção:** seleciona componentes dentro do fluxo.
* **Módulos:** contém os blocos de construção do fluxo, como mensagens, botões e agentes. 

#### **Como utilizar os módulos**

Para adicionar um módulo, basta clicar em uma opção e arrastar o componente ao fluxo. Há dois tipos:

* **Agentes:** escolha um agente já existente. [Saiba como criar um Agente](https://docs.skyone.cloud/skyone-studio/agentes#criar-um-agente).
* **Construção:** há dois tipos de blocos de construção:
  * **Mensagem:** módulo útil para adicionar mensagem em algum momento do fluxo.
  * **Botão:** adicione opções aos usuários.

**Editar bloco de construção**

Com a **Ferramenta de Seleção** ativa, dê um clique duplo no componente para editar um bloco de construção. É possível as seguintes ações:

* **Nome do botão:** O nome do botão deve ter, no máximo, de 20 caracteres.
* **Copiar URL:** copia o link direto do componente.
* **Excluir componente:** exclui o componente
* **Título:** texto descritivo exibido ao usuário
* **Botões:** mostra todos os botões (máximo de 3 botões por bloco).
* **Adicionar ação:** adicione um botão de ação. 

Após as alterações, clique em **Aplicar**.  

#### Recursos Adicionais

* **Execução manual:** inicia o teste do fluxo para validar a lógica aplicada. [Saiba mais sobre o Playground.](https://docs.skyone.cloud/skyone-studio/inteligencia-artificial/playground)
* **Zoom:** ajusta o nível de aproximação do whiteboard (aumentar/diminuir).
* **Logs:** exibe o histórico de alterações com filtro por data.

{% hint style="success" %}
Leia também: [Conectando componentes de um fluxo](https://docs.skyone.cloud/skyone-studio/integracoes/conectando-componentes-de-um-fluxo)
{% endhint %}

***

### FAQ

<details>

<summary>O que é o recurso Fluxo do Agente?</summary>

É uma ferramenta que permite construir fluxos de interação personalizados usando componentes visuais como mensagens, agentes de IA e botões.

</details>

<details>

<summary>Como posso acessar a tela de Fluxo do Agente?</summary>

Através do menu superior (canto direito) ou do menu lateral esquerdo (exceto na Home) dentro do **Skyone Studio**.

</details>

<details>

<summary>Quais informações são necessárias para criar um novo fluxo?</summary>

É necessário preencher o nome, uma descrição e carregar uma imagem nos formatos PNG ou JPG.

</details>

<details>

<summary>Quais são os tipos de módulos disponíveis para construção do fluxo?</summary>

Existem os módulos de "Agentes" (agentes já existentes) e de "Construção" (blocos de Mensagem e Botão)

</details>

<details>

<summary>Como faço para editar um bloco de construção no whiteboard?</summary>

Com a Ferramenta de Seleção ativa, dê um clique duplo sobre o componente que deseja editar.

</details>

<details>

<summary>O que a ferramenta de Logs exibe sobre o Fluxo do Agente?</summary>

Ela exibe o histórico de alterações realizadas no fluxo, permitindo também a filtragem dessas informações por data.

</details>