Pianificatore e strumento di lettura
Pianificatore e strumento di lettura — LangGraph: agente locale con stato e revisione. Un catalogo chiuso; Il confine del pianificatore; Legare la revisione al contenuto. Esercitazione pratica: Pratica: Pianificatore e strumento di lettura.
Versione demo. I materiali sono in fase di revisione editoriale.
Argomenti trattati
- Un catalogo chiuso
- Il confine del pianificatore
- Legare la revisione al contenuto
Un catalogo chiuso
Uno strumento di lettura richiede un confine ristretto. catalog.mjs contiene due note inventate direttamente nel codice. Request valida l'argomento e readNote rifiuta autonomamente chiavi sconosciute. Un argomento non può quindi diventare un percorso di file o un URL arbitrario. La funzione non modifica nulla e restituisce una stringa: ripeterla è sicuro in questo esempio. Object.freeze impedisce modifiche accidentali alla tabella, ma non isola il sistema operativo. Per passare a file reali servirebbero una radice consentita, controllo dei percorsi e permessi di sola lettura. Richieste backup ripetute devono restituire esattamente lo stesso testo. Un argomento sconosciuto deve produrre un errore controllato, senza scegliere silenziosamente la prima nota. Non aggiungere una ricerca di rete come ripiego: allargherebbe il confine dei dati e cambierebbe il contratto verificato.
// catalog.mjs
const notes = Object.freeze({
backup: 'Fictional note: stop the lab before copying its checkpoint database.',
permissions: 'Fictional note: expose only the dedicated read-only lab directory.'
});
export function readNote(topic) {
if (!Object.hasOwn(notes, topic)) throw new Error('Unknown note');
return notes[topic];
}
Il confine del pianificatore
Crea planner.mjs con una funzione plan. Per ora restituisce una chiave consentita dopo la validazione di Request. È uno stub locale funzionante, senza SDK di fornitori, richieste HTTP o credenziali. Un adattatore futuro potrebbe ottenere la stessa struttura da un modello, ma dovrebbe validarne la risposta prima di chiamare lo strumento. La validazione della forma non conferma i fatti e non concede autorizzazioni. Non aggiungere campi command o toolName arbitrari quando il grafo non ne ha bisogno. La scelta è limitata a due argomenti e un lettore. plan deve restituire backup oppure permissions. Se un futuro adattatore restituisce spiegazioni invece della chiave, rifiuta l'input. Non interpretare quel testo come istruzione eseguibile. Il confine di esecuzione rimane così indipendente dal modo in cui viene generato il piano.
// planner.mjs
import { Request } from './state.mjs';
export function plan(input) {
const request = Request.parse(input);
return request.topic;
}
Legare la revisione al contenuto
Aggiungi prepare.mjs: legge la nota consentita, prepara una proposta e calcola SHA-256 di request.id e del testo proposal esatto. Il digest rileva una decisione riferita a un contenuto diverso. Non è una firma digitale e non verifica l'identità: chi vede i dati può calcolare lo stesso hash. In produzione il server deve autenticare il revisore fuori dal grafo. Il nodo restituisce soltanto gli aggiornamenti necessari e azzera esplicitamente approvazione e anteprima precedenti. Questo evita che una vecchia decisione passi a una nuova preparazione sullo stesso thread. Attendi una proposta non vuota e un digest esadecimale di 64 caratteri. Anche un solo carattere modificato invalida il riferimento precedente. Per un nuovo compito usa un nuovo thread_id; riprendere un compito esistente deve restare un'operazione distinta.
// prepare.mjs
import { createHash } from 'node:crypto';
import { plan } from './planner.mjs';
import { readNote } from './catalog.mjs';
export function prepare(state) {
const note = readNote(plan(state.request));
const proposal = `Read-only lab summary: ${note}`;
const digest = createHash('sha256')
.update(JSON.stringify([state.request.id, proposal])).digest('hex');
return { note, proposal, digest, approved: false, preview: '' };
}
Esercitazione pratica
Pratica: Pianificatore e strumento di lettura
Vai alla lezione