Бесплатный урок

Планировщик и инструмент чтения

Планировщик и инструмент чтения — 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. Так старое решение не переносится на новый запрос в том же потоке. Ожидаются непустой proposal и digest из 64 шестнадцатеричных символов. При изменении текста старое решение перестаёт подходить. Для нового бизнесового запроса создавайте новый thread_id; восстановление прежнего потока должно оставаться отдельной операцией. Не выдавайте совпадение hash за доказательство полномочий человека.

// 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. Воспроизводимые тесты агента