Logo da Fluxo Ideal
FluxoIdeal
Manual da Central
Configuração

Os assistentes de IA da clínica

Os times de agentes que trabalham pela clínica: o que cada um faz, como ligar e desligar, os valores que a clínica ajusta e como instalar um time do catálogo.

Mascote da Fluxo Ideal
Para quem administra a clínica
Código MAN-CFG-10
Versão 1.0 · novembro de 2026
Leitura 9 minutos
Em resumo

A clínica liga, desliga e ajusta valores. O agente em si vem pronto.

Um agente é um assistente que faz uma tarefa sozinho: confirmar presença, avisar quem aprova um desconto, montar o resumo do paciente antes da consulta. Agentes que trabalham juntos formam um time.

Os times vêm prontos do catálogo da Fluxo Ideal. A clínica decide quais ficam ligados e preenche os valores da clínica de cada time, como prazos e faixas.

Fica em Configuração › Inteligência Artificial › Agentes (IA).

A pergunta que decide

Você quer que o agente pare, ou que ele trabalhe de outro jeito?

Que pareDesligue o agente. Ele deixa de rodar até ser ligado de novo.
Outro jeitoTroque um valor da clínica no time. Mudança no próprio agente, combine com a Fluxo Ideal.
1

A lista de agentes e times

Configuração › Inteligência Artificial › Agentes (IA). A tela se chama Gestão de Agentes.

Gestão de Agentes: busca, filtros e um cartão por time com os agentes dentro
Figura 1. Um cartão por time, com quantos agentes tem, quantos estão ligados e a versão instalada (v3.7). Dentro, um cartão pequeno por agente.

Use a busca e os filtros do topo: Ligados, Desligados, Sem chave de IA, Com erro (24h), Com atualização e o tipo do agente. Cada filtro mostra quantos agentes se encaixam.

TipoComo o agente trabalha
AutomaçãoSegue regras fixas. Faz sempre a mesma coisa para a mesma situação.
IAUsa um modelo de inteligência artificial para ler e escrever, como no resumo do paciente. Precisa de uma chave de IA (seção 7).
PrevisãoCalcula uma chance, como o risco de falta de um agendamento.
NativoVem embutido na plataforma.

Cada cartão de agente mostra se ele está ligado e quando rodou pela última vez (Hoje, Há 2 dias, Nunca). A faixa colorida da esquerda resume: verde, funcionando; amarelo, ligado mas parado há um tempo ou sem nunca ter rodado; vermelho, com erro.

Bom saber

As abas de cima (Fila de aprovação, Modelos de IA, Execuções, Custos) e os botões de mudar aparecem conforme o perfil de quem está na tela. Sem os botões Ligar, Importar time ou Editar valores? Falta a permissão de gerenciar agentes: peça a quem administra os acessos.

2

O que cada agente faz

Clique no cartão do agente. Abre um painel com:

  • a frase do que ele faz e a situação (Funcionando, Desligado, Com erro…);
  • as etiquetas: Ligado, Desta clínica ou Da plataforma, o tipo e o time;
  • Última execução e quantas deram erro nas últimas 24 horas;
  • Quando roda: o acontecimento ou o horário que o aciona. Sem gatilho, ele só roda quando alguém pede;
  • Caminho: os cinco passos do agente, do gatilho à permissão.

O botão Abrir completo leva à página do agente.

Painel de um agente com situação, etiquetas, última execução, quando roda e caminho
Figura 2. O painel do agente.
Página do agente na aba Início com Visão geral, Variáveis e Caminho do agente
Figura 3. A página do agente. À esquerda, as abas Início, Caminho do agente, Testar e execuções e Versões. Em Variáveis, os valores que só este agente usa.

Em Caminho do agente, os passos aparecem um por cartão: Quando roda, O que consulta, Como decide, O que faz e Com que permissão. É o lugar para entender o agente, não para mudá-lo.

Aba Caminho do agente com os cartões Quando roda, O que consulta, Como decide e O que faz
Figura 4. Os primeiros passos do caminho. Este agente roda quando o desconto de uma venda precisa de aprovação e, como ação, cria uma tarefa.
Evite

Mexer em gatilhos, script, ações e permissões do agente pela página dele. Esses botões existem para a equipe técnica. A forma de cada agente vem do catálogo da Fluxo Ideal: uma mudança feita à mão some ou conflita na próxima atualização do time. O que é da clínica são os valores (seção 4) e o liga e desliga.

3

Ligar e desligar

  1. Clique no cartão do agente para abrir o painel.
  2. Clique em Desligar. A Central pergunta Desligar o agente? e avisa que ele não responde mais aos gatilhos nem aos horários até ser ligado de novo. Confirme em Desligar.
  3. Para religar, abra o painel e clique em Ligar. Vale na hora, sem confirmação.
Atenção
  • Os agentes de um time costumam depender uns dos outros. Desligar um só pode deixar o trabalho pela metade: por exemplo, o desconto pede aprovação e ninguém é avisado. Na página do time, o quadro Encadeamento mostra qual agente passa a vez para qual.
  • Excluir só aparece com o agente desligado e não pode ser desfeito. Prefira deixar desligado.
4

Valores da clínica

Cada time pode pedir valores que mudam de clínica para clínica: quem aprova, a partir de quanto o desconto pede aprovação, com quantos dias de antecedência avisar.

Página do time Aprovação de desconto com os agentes do time e o encadeamento
Figura 5. A página do time: o que ele faz, a versão, de onde veio, quem importou e os agentes. Abra pelo nome do time na lista.
  1. Na lista, clique no nome do time. Na página dele, abra Valores da clínica.
  2. Clique em Editar valores. Quando o valor tem o ícone i ao lado, ele explica para que serve.
  3. Troque o que precisa e clique em Salvar valores. Confirme em Trocar.
Aba Valores da clínica com os valores do time e o botão Editar valores
Figura 6. Os valores do time de aprovação de desconto.

O valor do time vale para todos os agentes do time, sem reinstalar. Um agente que tem valor próprio, nas Variáveis da página dele, continua com o dele.

Atenção

Alguns valores mudam o que os agentes podem fazer. Nesses casos, salvar pede a permissão de gerenciar os acessos dos agentes, e a tela avisa antes.

5

Instalar ou atualizar um time

Configuração › Inteligência Artificial › Importar time, ou o botão Importar time na lista. São quatro etapas.

Importar time de agentes, etapa Origem com o catálogo oficial
Figura 7. A etapa Origem: o catálogo oficial da Fluxo Ideal, com o selo Instalado nos times que a clínica já tem.
  1. Origem. No catálogo, clique em Instalar no time que quer. Os já instalados mostram Reimportar.
  2. Valores da clínica. Preencha o que o time pede. Num time já instalado, a tela mantém os valores que a clínica usa hoje e avisa o que é novo. Clique em Pré-visualizar.
  3. Prévia. Um cartão por agente, com o que vai mudar, e um quadro de risco (Risco baixo, Atenção ou Risco alto). Confira e clique em Aplicar.
  4. Pronto. A tela diz Time aplicado. Os agentes já estão na lista. Clique em Abrir o time.

Atualizar. Quando o catálogo tem versão nova de um time instalado, o cartão do time na lista mostra v… disponível. Quem gerencia agentes clica ali para atualizar. Os valores trocados na clínica ficam.

Evite
  • Usar Outra origem — colar link ou JSON com um time que não veio da Fluxo Ideal.
  • Criar agente pelo botão Novo agente por conta própria. Agente novo passa pela Fluxo Ideal: peça pelo Feedback (veja o MAN-BAS-04).
6

Aprovar e acompanhar

Fila de aprovação. Alguns agentes trabalham no modo Propor: em vez de agir sozinhos, sugerem a ação e esperam uma pessoa aprovar. As sugestões caem na aba Fila de aprovação, filtradas por Pendentes, Executadas, Com erro, Rejeitadas ou Todas. Cada uma tem Aprovar (a ação é feita na hora, em nome do agente, e não se desfaz sozinha) e Rejeitar.

Execuções. A aba Execuções lista cada vez que um agente rodou: quando, qual agente, se deu certo, quanto custou e quanto demorou. Filtre por agente, time, status e período. A página de cada time tem a mesma lista, só com os agentes dele.

Aba Execuções com totais, filtros e a lista de execuções
Figura 8. As execuções, com os totais em cima e os filtros.

Custos e Modelos de IA mostram quanto os agentes de IA gastaram e quais modelos a plataforma oferece.

7

Minha credencial de IA

Configuração › Inteligência Artificial › Minha credencial de IA. Esta tela guarda chave de acesso: não há print neste manual.

Os agentes do tipo IA usam a conta de um provedor de inteligência artificial. Aqui a clínica cadastra a própria chave desse provedor: + (Nova credencial de IA), escolha o Provedor, cole a Chave de API e salve. A lista mostra as chaves cadastradas, com Testar.

Com chave própria, os agentes de IA da clínica usam a conta dela. Sem chave própria, usam a chave da plataforma, quando houver. Sem nenhuma das duas, o agente aparece com Sem chave de IA e não consegue rodar.

Atenção

A chave dá acesso à conta paga da clínica no provedor. Só quem tem a permissão de gerenciar a credencial vê esta tela. Não mande a chave por e-mail nem por mensagem.

8

Dúvidas frequentes

Um agente está com a faixa vermelha.

Abra o painel e veja a última execução. Se o erro se repetir, avise a Fluxo Ideal pelo Feedback, com o nome do agente.

O agente aparece "Sem chave de IA".

Ele é do tipo IA e não há chave para o provedor dele. Cadastre a chave da clínica (seção 7) ou fale com a Fluxo Ideal.

Troquei um valor do time e um agente não mudou.

Ele tem valor próprio nas Variáveis da página dele, que vence o do time.

Quero que um agente faça algo que ele não faz.

Peça à Fluxo Ideal pelo Feedback. Mudança de comportamento entra numa versão nova do time, que chega pelo catálogo.