Agentes · registro público
Automação que a clínica instala por link.
Um time de agentes é um arquivo: o manifesto. Ele diz o que o time pede, quando acorda e o que faz. A clínica cola o link na Central (Inteligência Artificial → Importar), confere o risco e liga. Hoje são 10 times oficiais.
O que tem no manifesto
Papéis e permissões
O time declara um papel próprio (botfn-…) com as permissões de que precisa, como agendamento:list ou campanha:disparar. É a superfície de consentimento: a clínica vê o que está autorizando antes de importar.
Agentes
Cada agente é de um tipo: script (roteiro fixo, sem IA) ou IA (entende texto livre, com instrução e formato de resposta definidos no manifesto). Um time junta vários, cada um com uma tarefa.
Gatilhos
Por horário (cron, em UTC) ou por evento do sistema, como interacoes.mensagem_criada ou vendas.desconto_requer_aprovacao. O evento pode ter filtro, para o agente só acordar no caso dele.
Ações por capability
Cada ação cita uma capability nomeada (ex.: interacoes.agendar_campanha), nunca a rota interna. O endereço real é resolvido em privado pelo servidor da clínica na hora de instalar.
Ajustes da clínica
Parâmetros editáveis por clínica, sem redeploy: antecedência mínima, fuso, papel que recebe a fila, horário da varredura. O comportamento do agente é dado, não código.
Escopo por clínica
Um time instalado roda só na clínica que o importou (escopo por-tenant), com o próprio histórico de execuções e custo.
E o que nunca tem
- Endpoints e rotas internas
- Endereços de rede, IPs, portas e hostnames
- Segredos, tokens e chaves
- Dado de paciente ou conteúdo sensível
Por que é seguro instalar
Sem ganhar poder ao importar
A instalação roda com o acesso de quem importa. Um time que pede uma permissão que você não pode conceder não recebe essa permissão.
O porteiro confere cada ação
Em execução, as permissões do papel do agente são a trava real. O que o manifesto declara é um pedido, não uma chave.
Cartão de risco antes de aplicar
A tela de importar mostra se o time lê dado de paciente, se envia algo para fora e se age sozinho. Só depois você confirma.
Os arquivos públicos
Servidos ao vivo do repositório públicofluxo-ideal-ia: um time atualizado lá aparece aqui na hora, sem mudar o site. Um time só entra no registro quando a versão do sistema de que ele depende já está em produção.
/agents/times/index.jsonO índice dos times: chave, nome, descrição, versão, quantos agentes e de que tipo. É o que a Central lista na tela de importar.
/agents/times/<chave>/manifest.jsonO manifesto de um time, para importar. O link vai colado na Central.
/agents/times/<chave>/README.mdO que o time faz, o que pede e o risco, em texto.
/skills/<nome>/SKILL.mdAs skills: o conhecimento do domínio para a sua IA (uma skill entende; um agente age).
/llms.txt e /llms-full.txtO mapa do que a Fluxo Ideal publica para IAs.
Quer um time sob medida?
