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.json

    O í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.json

    O manifesto de um time, para importar. O link vai colado na Central.

  • /agents/times/<chave>/README.md

    O que o time faz, o que pede e o risco, em texto.

  • /skills/<nome>/SKILL.md

    As skills: o conhecimento do domínio para a sua IA (uma skill entende; um agente age).

  • /llms.txt e /llms-full.txt

    O mapa do que a Fluxo Ideal publica para IAs.

Digite pelo menos 2 letras.