Безкоштовний урок

Планувальник і інструмент читання

Планувальник і інструмент читання — 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: '' };
}

Практичне завдання

Практика: Планувальник і інструмент читання

Перейти до навчання

Програма курсу

  1. Стан і межі локального агента
  2. Планувальник і інструмент читання
  3. Граф і контрольні точки
  4. Пауза й людський перегляд
  5. Стан після перезапуску
  6. Відтворювані тести агента