Планувальник і інструмент читання
Планувальник і інструмент читання — LangGraph: локальний агент зі станом і переглядом. Закритий каталог нотаток; Межа планувальника; Відбиток пропозиції. Практичне завдання: Практика: Планувальник і інструмент читання.
Демо-версія. Матеріали проходять редакторську перевірку.
Що розглянемо
- Закритий каталог нотаток
- Межа планувальника
- Відбиток пропозиції
Закритий каталог нотаток
Інструмент читання повинен мати вузьку область даних. Наш каталог містить два вигадані тексти, записані безпосередньо в модулі catalog.mjs. Значення topic проходить перевірку через Request, а readNote додатково відхиляє невідомий ключ. Це не дає перетворити назву теми на довільний шлях до файлу або URL. Функція нічого не змінює й повертає звичайний рядок, тому повторне виконання безпечне для цього прикладу. Object.freeze захищає таблицю від випадкової зміни в коді, але не створює операційної ізоляції. Якщо згодом читатимете файли, додайте окремий дозволений корінь і перевірку шляху, а також права користувача лише на читання. Очікуйте однаковий текст для кожного повторного запиту backup. Невідома тема має спричинити контрольовану помилку, а не вибір першої доступної нотатки. Так помилки в маршруті залишаються помітними.
// 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];
}
Межа планувальника
Створіть planner.mjs із функцією plan. Зараз вона лише повертає дозволений ключ після перевірки Request. Це справжня робоча заглушка планувальника, а не вигаданий виклик сервісу: у модулі немає SDK провайдера, HTTP чи ключа. Зовнішня модель у майбутньому могла б пропонувати таку саму структуру, але її відповідь однаково треба перевіряти до виконання інструмента. Перевірка форми не встановлює достовірність тексту й не погоджує дії користувача. Не додавайте в план поле command або довільний toolName, якщо граф їх не потребує. У нашому випадку вибір обмежений двома темами й одним читачем. Очікуваний результат plan — рядок backup або permissions. Якщо модельний адаптер згодом поверне пояснення замість ключа, граф має завершитися помилкою перевірки, а не намагатися виконати пояснення. Така межа зберігає контроль незалежно від способу генерації плану.
// planner.mjs
import { Request } from './state.mjs';
export function plan(input) {
const request = Request.parse(input);
return request.topic;
}
Відбиток пропозиції
Додайте prepare.mjs: він читає дозволену нотатку, створює пропозицію та обчислює SHA-256 від request.id і точного тексту proposal. Відбиток допоможе виявити рішення, яке стосується іншої версії пропозиції. Це не цифровий підпис і не перевірка особи: будь-хто з доступом до даних може обчислити такий самий hash. Автентифікацію переглядача в реальному продукті забезпечує сервер поза графом. Вузол повертає лише потрібні поля та явно обнуляє старе погодження і preview. Це зменшує ризик перенесення попереднього рішення на новий запит у тому самому потоці. Очікуйте непорожню пропозицію та 64 шістнадцяткові символи digest. Якщо текст зміниться хоча б на один символ, старе рішення більше не підходить. Для повторного запуску нового бізнесового запиту використовуйте новий thread_id; відновлення старого потоку має залишатися окремою операцією.
// 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: '' };
}
Практичне завдання
Практика: Планувальник і інструмент читання
Перейти до навчання