Proposed Knowledge
Tudo o que o Pathrule ou um agente propõe e que nenhuma pessoa aprovou ainda. Como uma sugestão difere de uma descoberta, de conhecimento verificado e de uma regra, onde cada tipo de proposta fica aguardando e o que a aprovação muda para os seus agentes.
Nesta página
- Cinco palavras que não são sinônimos
- De onde vêm as propostas e onde elas aguardam
- Seu agente, configurando um projeto
- Uma restrição anexada a uma regra
- Team Intelligence, no Pathrule Cloud
- Suas preferências pessoais
- Conhecimento desatualizado
- A exceção: descobertas
- O que a aprovação muda
- O que ele nunca faz
Proposed Knowledge é tudo o que fica aguardando uma pessoa antes que seus agentes possam confiar nele.
O Pathrule e seus agentes percebem coisas o tempo todo: uma convenção que a equipe continua seguindo, uma correção que continua funcionando, uma restrição que um parágrafo parece sugerir. Perceber algo é uma inferência, e uma inferência só vira conhecimento quando alguém responde por ela. O que é aprendido nunca é confiável automaticamente.
Cinco palavras que não são sinônimos
A diferença entre elas é o design inteiro.
| O que é | Chega aos agentes? | |
|---|---|---|
| Descoberta | Uma conclusão que um agente registrou a partir do seu código, com os arquivos em que ela se apoia | Sim, como orientação a ser verificada, apenas enquanto suas fontes não mudarem |
| Sugestão | Algo que o Pathrule ou um agente inferiu e que ninguém aprovou | Não |
| Conhecimento verificado | Algo que uma pessoa aprovou | Sim |
| Regra | Uma restrição que uma pessoa definiu para um escopo; sua forma executável só é aplicada depois que uma pessoa a aprova | Sim, como requisito |
| Entrega | O que de fato chega ao agente para uma tarefa | É o que chega até eles |
De onde vêm as propostas e onde elas aguardam
Seu agente, configurando um projeto
Peça ao seu agente "Set up Pathrule for this project" e ele faz uma análise guiada: lê o projeto, propõe memórias, regras e skills e grava apenas as que você aprovar na conversa. Nada do que ele propõe é salvo até você autorizar.
Fora dessa análise, um agente que descobre algo que vale a pena guardar normalmente propõe isso a você antes de gravar. Quando ele grava, a gravação tem autoria registrada, é versionada e pode ser revertida.
Uma restrição anexada a uma regra
Uma regra pode carregar uma restrição executável: um padrão que uma alteração não pode conter e o que fazer no lugar. Quando um agente anexa uma restrição por meio de pathrule_write_rule ou pathrule_update_rule, ela é armazenada como proposta. Ela não é aplicada, e nenhum agente pode aprová-la. Só depois que uma pessoa a aprova o hook pré-ferramenta pode bloquear uma edição correspondente, nos clientes cujos hooks oferecem esse suporte. Veja regras como guardrails.
Team Intelligence, no Pathrule Cloud
A Team Intelligence analisa as evidências que o trabalho de uma equipe produz e propõe padrões. Um padrão passa de rascunho a sugerido, e um proprietário ou administrador da organização o verifica ou rejeita no console web, nas configurações de Team guidance da organização; uma sugestão em que ninguém age expira. Só os padrões verificados chegam aos agentes. Ela está disponível nos planos Team e Enterprise.
Suas preferências pessoais
Uma preferência que você ensina com pathrule me teach é conferida contra as suas próprias palavras antes de ser armazenada. Uma preferência que ainda não está em uso aparece em pathrule me list em "Not in use yet" e nunca chega a um agente. pathrule me explain <id> mostra em que ela se apoia, e pathrule me forget <id> a rejeita. Veja User Intelligence.
Conhecimento desatualizado
Quando um conhecimento parece desatualizado, ele pode ser sinalizado como uma tarefa de atualização, por exemplo por um agente que percebeu a divergência e chamou pathrule_request_refresh. Uma tarefa de atualização é uma proposta de mudança em um conhecimento existente, e uma pessoa ou um agente a trata com pathrule refresh ou com as ferramentas de atualização do MCP. Veja sugestões e autoauditoria.
A exceção: descobertas
As descobertas são o único tipo de conhecimento aprendido que chega aos agentes sem etapa de revisão, e isso é deliberado. Uma descoberta é orientação, não política:
- ela só é salva depois que seus arquivos de origem são conferidos em disco,
- ela só é entregue enquanto esses arquivos estiverem inalterados no checkout de quem a lê,
- ela é retida quando suas fontes mudam ou quando contradiz outra descoberta,
- e ela nunca vira, por conta própria, uma memória, uma regra ou uma skill.
Tudo o que precisa valer para todos os agentes continua sendo papel de uma regra ou de uma memória, escrita e revisada pela sua equipe.
O que a aprovação muda
A aprovação é o que transforma uma sugestão em conhecimento verificado.
- Uma proposta aprovada da análise vira uma memória, regra ou skill comum, entregue como qualquer outra.
- Um padrão de equipe verificado começa a chegar aos agentes nos espaços de trabalho daquela organização.
- Uma restrição de regra aprovada passa a poder ser aplicada pelo hook pré-ferramenta nos clientes que oferecem suporte.
- Uma proposta rejeitada continua rejeitada, então as mesmas evidências não a trazem de volta logo em seguida.
O que ele nunca faz
- Nunca aprova nada em seu nome, e nada que precise de aprovação chega a um agente antes que uma pessoa a dê.
- Nunca deixa um agente aprovar a própria proposta.
- Nunca transforma uma descoberta em regra.
- Nunca edita o que sua equipe escreveu sem que uma pessoa ou um agente esteja agindo a partir de uma proposta.
Para saber o que acontece depois que um conhecimento é aprovado, veja Agent IR e segurança e fallback.