# 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.&#x20;

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**.&#x20;

{% hint style="warning" %}
Não é possível reverter a exclusão.&#x20;
{% 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.&#x20;

#### **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](/skyone-studio/inteligencia-artificial/agentes.md#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.&#x20;

Após as alterações, clique em **Aplicar**. &#x20;

#### Recursos Adicionais

* **Execução manual:** inicia o teste do fluxo para validar a lógica aplicada. [Saiba mais sobre o Playground.](/skyone-studio/inteligencia-artificial/playground.md)
* **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](/skyone-studio/integracoes/conectando-componentes-de-um-fluxo.md)
{% 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.skyone.cloud/skyone-studio/inteligencia-artificial/fluxo-do-agente.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
