---
title: Copiloto de fluxo (IA)
slug: aura/copiloto-de-fluxo-ia
createdAt: 2026-11-19T14:33:13.853Z
---

## Copiloto de fluxo (IA no editor)

O **Copiloto** é o painel de IA que mora **dentro do editor de fluxo**. Ele faz duas coisas na **mesma conversa**:

- **Entende o fluxo que já existe** — inclusive um fluxo que você não montou (importado, herdado de outra equipe, feito há dois anos): lê o desenho e explica o que ele faz, cada caminho, o que cada bloco grava e onde está furado.
- **Continua dali construindo** — você segue conversando ("tira esse menu", "adiciona pesquisa de satisfação no fim", "esse ramo devia ir para o atendente") e ele **propõe** a edição do quadro.

Não existe "modo explicar" e "modo criar": é uma conversa só.

## Onde fica

No editor de fluxo, botão **Copiloto** na barra do topo. O painel abre à direita, ao lado das Propriedades, e você pode **arrastar a borda** para alargar (quem está lendo documentação quer largo; quem está mexendo no quadro quer estreito — a largura fica guardada).

A conversa **fica guardada por fluxo**, no seu navegador. Fechar o painel é "preciso ver o quadro", não "joga fora o que conversamos". O botão de **conversa nova** limpa quando você quiser.

## Três perguntas para começar

Com o painel vazio ele já oferece:

| Sugestão                              | Para que serve                                                                                                                                                     |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Explique este fluxo para mim          | Gera a documentação do fluxo aberto: visão geral, cada caminho passo a passo, o que o cliente vê, o que fica gravado no contato, o que depende de sistema externo. |
| O que está faltando ou quebrado aqui? | Roda a conferência do fluxo e traduz os problemas para português.                                                                                                  |
| Onde o cliente pode ficar preso?      | Procura beco sem saída, laço sem espera e caminho sem escape para o atendente.                                                                                     |

## A documentação fica guardada — e vira arquivo

A documentação **não é um recado de conversa**: ela fica **guardada no assistente**, com a data e quem mandou gerar. Quem abrir o painel depois — você amanhã, ou quem herdou o fluxo — vê o aviso **"Este fluxo já tem documentação"** e lê a mesma que a equipe leu, **na hora**, sem esperar a IA escrever tudo de novo.

Abaixo da documentação ficam os botões:

| Botão         | O que faz                                                        |
| ------------- | ---------------------------------------------------------------- |
| PDF           | Baixa o documento pronto para anexar ou imprimir.                |
| HTML          | Baixa uma página única, que abre em qualquer navegador.          |
| Markdown      | Baixa o texto como ele foi escrito, para quem vai editar.        |
| Gerar de novo | Reescreve com a IA e substitui a guardada. É o único que usa IA. |

Mudou o fluxo depois? A tela avisa que **a documentação é de antes das últimas mudanças** — ela continua ali, mas você sabe que precisa de um **Gerar de novo** para ficar em dia.

Clicar num bloco citado na resposta **acende o bloco no quadro** — dá para ler a explicação e ir olhando o desenho.

## Toda edição chega como proposta

O copiloto **nunca** mexe no seu quadro sozinho. A resposta vem com um cartão **"Como o fluxo vai ficar"**:

- a lista de blocos que **entram**, **mudam** e **saem**, com o encaixe real ("depois de *Pede o CPF*");
- clique em qualquer item para **ver o bloco no quadro**;
- **Aplicar** põe a proposta no quadro; **Não aplicar** a descarta. Um clique cada.

E depois de aplicar:

Outras proteções do cartão:

- **"Não dá para aplicar"** — a proposta não passou na conferência do fluxo. Os erros aparecem escritos; peça o ajuste na conversa e ele refaz.
- **"Proposta de antes"** — você editou o quadro depois que ela foi feita. Aplicar por cima desfaria seu trabalho, então ele pede para você mandar de novo, agora em cima do que está no quadro.

## Quando ele pergunta, você escolhe

Pedido ambíguo não vira chute: o copiloto **pergunta** antes de mexer no quadro — e toda pergunta vem com as **respostas mais prováveis em botões numerados**, logo abaixo dela ("atendente humano ou virtual?", "qual das filas?"). Clique em um, ou **tecle o número** com o campo de texto vazio, e pronto: é a sua resposta. Com muitas alternativas, os botões viram uma **lista com busca**.

- A escolha entra na conversa como se você tivesse digitado, e ele segue dali.
- Quando as alternativas são **tarefas que dá para fazer juntas** (por exemplo, "Corrigir o bloco X" e "Corrigir o bloco Y" numa proposta travada), os botões viram **marcadores**: marque as que quiser, clique ou tecle o número, e confirme em **Fazer estas** — vai tudo num pedido só, em vez de uma rodada por tarefa.
- O campo de texto continua livre: se nenhuma alternativa serve, escreva a sua.
- Depois de respondida, a pergunta fica no histórico com os botões travados e **a sua escolha marcada** — dá para ver o que foi oferecido e o que você respondeu.

## As regras que ele não pode furar

- **Não inventa bloco nem campo.** Ele só usa os blocos que existem de verdade na biblioteca, e só os campos que aquele bloco aceita.
- **Toda proposta passa pela conferência** antes de virar um botão de aplicar. Errou duas vezes, ele mostra o problema em vez de aplicar meio fluxo.
- **Edita em pedaços, não reescreve o fluxo.** Bloco que ele não tocou mantém o mesmo identificador, a mesma configuração e a mesma posição no quadro — inclusive configuração que veio de fluxo importado e que o editor nem exibe.
- **Respeita os comentários marcados como regra** (veja [Fluxos de conversa](https://docs.citsmart.com/aura/fluxos-de-conversa) › *Comentários no bloco*): comentário de regra é instrução, não recado — ele não altera o bloco sem avisar, e nunca apaga comentário escrito por pessoa.
- **Não cria automação (Gatilho) por conta própria.** Só quando você pede explicitamente ("de tempos em tempos", "vigiar", "avisar quando").

## Qual IA ele usa

A **mesma conexão de IA do workspace**, cadastrada em [Canais](https://docs.citsmart.com/aura/canais) — não existe chave separada nem custo escondido. O painel mostra qual conexão está sendo usada.

## Como aproveitar melhor

- **Fluxo grande**: peça por partes ("me explica só o ramo do parcelamento"), ou selecione blocos no quadro antes de pedir a mudança.
- **Antes de pedir mudança grande**, peça a explicação: ela é o contexto que ele usa para editar sem estragar o resto.
- **Escreva o "porquê" nos comentários** dos blocos que não podem mudar. É o que impede a IA de "consertar" algo que estava certo de propósito.
- **Leia o cartão de proposta** antes de aplicar. É rápido e é a sua última chance de barrar uma mudança que você não quis.
