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.
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).
Você quer que o agente pare, ou que ele trabalhe de outro jeito?
A lista de agentes e times
Configuração › Inteligência Artificial › Agentes (IA). A tela se chama Gestão de Agentes.
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.
| Tipo | Como o agente trabalha |
|---|---|
| Automação | Segue regras fixas. Faz sempre a mesma coisa para a mesma situação. |
| IA | Usa 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ão | Calcula uma chance, como o risco de falta de um agendamento. |
| Nativo | Vem 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.
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.
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.
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.
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.
Ligar e desligar
- Clique no cartão do agente para abrir o painel.
- 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.
- Para religar, abra o painel e clique em Ligar. Vale na hora, sem confirmaçã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.
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.
- Na lista, clique no nome do time. Na página dele, abra Valores da clínica.
- Clique em Editar valores. Quando o valor tem o ícone i ao lado, ele explica para que serve.
- Troque o que precisa e clique em Salvar valores. Confirme em Trocar.
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.
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.
Instalar ou atualizar um time
Configuração › Inteligência Artificial › Importar time, ou o botão Importar time na lista. São quatro etapas.
- Origem. No catálogo, clique em Instalar no time que quer. Os já instalados mostram Reimportar.
- 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.
- 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.
- 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.
- 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).
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.
Custos e Modelos de IA mostram quanto os agentes de IA gastaram e quais modelos a plataforma oferece.
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.
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.
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.