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

Состояние и границы локального агента

Состояние и границы локального агента — LangGraph: локальный агент с состоянием и просмотром. Контракт лаборатории; Описать состояние; Определить ожидаемые переходы. Практическое задание: Практика: Состояние и границы локального агента.

Демо-версия. Материалы проходят редакторскую проверку.

Что рассмотрим

  • Контракт лаборатории
  • Описать состояние
  • Определить ожидаемые переходы

Контракт лаборатории

Построим агента, который читает одну из двух учебных заметок и готовит предварительный просмотр. Он не отправляет сообщения, не выполняет команды и не подключает модель. Детерминированный планировщик заменяет модель, поэтому одинаковый запрос даёт одинаковый маршрут. Так можно отдельно проверить оркестрацию, сохранение состояния и просмотр человеком. LangGraph управляет переходами между узлами; права чтения и внешней записи определяют ваш код и окружение. Создайте отдельную папку, при необходимости установите зависимости и сохраните lockfile. Команды предназначены ученику; автор курса их не запускал. Результат шага — учебный проект с зафиксированными версиями. При ошибке импорта сначала проверьте поддерживаемую версию Node и установленный пакет. Не меняйте API по догадке. Ключ провайдера здесь не нужен; отсутствие ключа также помогает заметить случайную зависимость от внешнего сервиса.

mkdir langgraph-readonly-lab
cd langgraph-readonly-lab
npm init -y
npm install @langchain/langgraph @langchain/core zod
npm ls @langchain/langgraph @langchain/core zod

Описать состояние

Состояние задаёт общую форму данных между узлами. Сохраните модуль как state.mjs. Поле request содержит идентификатор и разрешённую тему, note — прочитанную заметку, proposal — предложенный текст, digest — отпечаток предложения, approved — решение просмотра, preview — учебный результат. Начальные значения устраняют неоднозначность между пустым значением и отсутствующим полем. Используем актуальные StateSchema и Zod. Узел вернёт частичное обновление, например только note; остальные поля сохранятся. По умолчанию новое значение заменяет предыдущее. В последовательном графе нет двух одновременных авторов одного поля, поэтому специальный reducer не нужен. Схема описывает структуру, а входной запрос дополнительно проверим перед запуском графа. Не храните токены, подключения и файловые дескрипторы в состоянии. Checkpoint должен содержать сериализуемые данные задачи; иначе восстановление будет зависеть от ресурсов прежнего процесса.

// state.mjs
import { StateSchema } from '@langchain/langgraph';
import * as z from 'zod';
export const Request = z.object({
  id: z.string().regex(/^lab-[a-z0-9-]{1,32}$/),
  topic: z.enum(['backup', 'permissions'])
}).strict();
export const State = new StateSchema({
  request: Request,
  note: z.string().default(''),
  proposal: z.string().default(''),
  digest: z.string().default(''),
  approved: z.boolean().default(false),
  preview: z.string().default('')
});

Определить ожидаемые переходы

До кода графа запишите таблицу ожиданий. Для темы backup планировщик выбирает заметку backup; после чтения появляется proposal; перед предварительным просмотром выполнение останавливается на review. Отказ завершает граф без preview. Согласие создаёт только локальную строку preview, не отправляемую внешнему сервису. Эти наблюдения станут проверками последнего урока. Разделяйте request.id и thread_id: первый описывает задачу, второй адресует историю исполнения. В настоящем сервисе владельца потока определяет аутентифицированный сервер, а не произвольное клиентское значение. Запишите отрицательные случаи: неизвестная тема отклоняется, изменённое предложение требует нового решения, другой поток не видит прежнего состояния. Результат — таблица с условием, следующим узлом и наблюдаемым полем. Если поле для проверки отсутствует, уточните контракт прежде следующего узла. Успешное завершение графа само по себе ещё не доказывает правильность содержания или разрешение на внешнюю запись.

Практическое задание

Практика: Состояние и границы локального агента

Перейти к обучению

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

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