PathruleProposed Knowledge
Tutto ciò che Pathrule o un agente propone e che una persona non ha ancora approvato. In cosa un suggerimento si distingue da una conclusione, dalla conoscenza verificata e da una regola, dove resta in attesa ogni tipo di proposta e cosa cambia per i tuoi agenti quando la approvi.
In questa pagina
- Cinque parole che non sono sinonimi
- Da dove arrivano le proposte e dove restano in attesa
- Il tuo agente, durante la configurazione di un progetto
- Un vincolo associato a una regola
- Team Intelligence, su Pathrule Cloud
- Le tue preferenze personali
- Conoscenza obsoleta
- L'eccezione: le conclusioni
- Cosa cambia con l'approvazione
- Cosa non fa mai
La Proposed Knowledge è tutto ciò che aspetta una persona prima che i tuoi agenti siano autorizzati a farci affidamento.
Pathrule e i tuoi agenti notano cose di continuo: una convenzione che un team continua a seguire, una correzione che continua a funzionare, un vincolo che un paragrafo sembra sottintendere. Notare qualcosa è una deduzione, e una deduzione non diventa conoscenza finché qualcuno non se ne fa garante. Ciò che viene appreso non è mai considerato affidabile in automatico.
Cinque parole che non sono sinonimi
Tutta l'architettura si basa sulla differenza tra queste parole.
| Cos'è | Arriva agli agenti? | |
|---|---|---|
| Conclusione | Ciò che un agente ha concluso a partire dal tuo codice e ha registrato, insieme ai file su cui si basa | Sì, come consiglio da verificare, solo finché le sue fonti restano invariate |
| Suggerimento | Qualcosa che Pathrule o un agente ha dedotto e che nessuno ha approvato | No |
| Conoscenza verificata | Qualcosa che una persona ha approvato | Sì |
| Regola | Un vincolo che una persona ha fissato per un ambito; la sua forma eseguibile viene applicata solo dopo che una persona l'ha approvata | Sì, come requisito |
| Consegna | Ciò che arriva davvero all'agente per una singola attività | È ciò che arriva agli agenti |
Da dove arrivano le proposte e dove restano in attesa
Il tuo agente, durante la configurazione di un progetto
Chiedi al tuo agente "Set up Pathrule for this project" e l'agente avvia un'analisi guidata: legge il progetto, propone memorie, regole e skill e scrive solo quelle che approvi nella conversazione. Nulla di ciò che propone viene salvato finché non sei tu a dirlo.
Al di fuori di questa analisi, un agente che scopre qualcosa che vale la pena conservare di solito te lo propone prima di scriverlo. Quando invece lo scrive, la scrittura è attribuita, versionata e reversibile.
Un vincolo associato a una regola
Una regola può includere un vincolo eseguibile: un pattern che una modifica non deve contenere e cosa fare al suo posto. Quando un agente lo associa tramite pathrule_write_rule o pathrule_update_rule, viene salvato come proposta. Non viene applicato, e un agente non può approvarlo. Solo dopo che una persona lo ha approvato l'hook pre-tool può bloccare una modifica corrispondente, nei client i cui hook lo supportano. Vedi le regole come guardrail.
Team Intelligence, su Pathrule Cloud
Team Intelligence esamina le evidenze prodotte dal lavoro di un team e propone dei pattern. Un pattern passa da bozza a suggerito, e un owner o un admin dell'organizzazione lo verifica oppure lo rifiuta nella console web, nelle impostazioni Team guidance dell'organizzazione; un suggerimento su cui nessuno interviene scade. Arrivano agli agenti solo i pattern verificati. La funzione è disponibile nei piani Team ed Enterprise.
Le tue preferenze personali
Una preferenza che insegni con pathrule me teach viene confrontata con le tue stesse parole prima di essere salvata. Una preferenza non ancora in uso compare in pathrule me list sotto "Not in use yet" e non arriva mai a un agente. pathrule me explain <id> mostra su cosa si basa, e pathrule me forget <id> la rifiuta. Vedi User Intelligence.
Conoscenza obsoleta
Quando una conoscenza sembra non essere più aggiornata, può essere segnalata come attività di aggiornamento, per esempio da un agente che ha notato la divergenza e ha chiamato pathrule_request_refresh. Un aggiornamento è una proposta di modifica a una conoscenza esistente, e una persona o un agente la gestisce con pathrule refresh o con gli strumenti di aggiornamento MCP. Vedi suggerimenti e autoverifica.
L'eccezione: le conclusioni
Le conclusioni sono l'unico tipo di conoscenza appresa che arriva agli agenti senza una fase di revisione, ed è una scelta voluta. Una conclusione è un consiglio, non una policy:
- viene salvata solo dopo che i suoi file di origine sono stati verificati su disco,
- viene consegnata solo finché quei file restano invariati nel checkout di chi lo legge,
- viene trattenuta quando le sue fonti cambiano o quando contraddice un'altra conclusione,
- e non diventa mai da sola una memoria, una regola o una skill.
Tutto ciò che deve vincolare ogni agente va comunque messo in una regola o in una memoria, scritta e revisionata dal tuo team.
Cosa cambia con l'approvazione
È l'approvazione a trasformare un suggerimento in conoscenza verificata.
- Una proposta approvata durante l'analisi diventa una normale memoria, regola o skill, consegnata come tutte le altre.
- Un pattern di team verificato inizia ad arrivare agli agenti nei workspace di quell'organizzazione.
- Un vincolo di una regola, una volta approvato, diventa applicabile dall'hook pre-tool nei client che lo supportano.
- Una proposta rifiutata resta rifiutata, così le stesse evidenze non la ripropongono subito.
Cosa non fa mai
- Non approva mai nulla al posto tuo, e nulla che richieda un'approvazione arriva a un agente prima che una persona la dia.
- Non permette mai a un agente di approvare una propria proposta.
- Non trasforma mai una conclusione in una regola.
- Non modifica mai ciò che il tuo team ha scritto senza che una persona o un agente agisca su una proposta.
Per sapere cosa succede una volta approvata la conoscenza, vedi Agent IR e sicurezza e fallback.