Архитектура & AI2026-03-11Время чтения: 10 мин

Мультиагентные AI-системы на LangGraph и Next.js 15: Архитектура автономного B2B-контура со Supervisor-Worker и Zod-валидацией

Разработка распределенной команды ИИ-агентов для автоматизации операционки: иерархический роутинг задач, валидация structured outputs, Human-in-the-Loop контрольные точки и устранение галлюцинаций.

VX
Команда архитектуры Vertex Studio
Enterprise Systems & AI Solutions
⚙️VERTEX STUDIO · TECH BLUEPRINTАрхитектура & AI
LCP 0.18s • INP 14ms
Скорость выполнения4.8 сек
Частота галлюцинаций0.0%
Экономия ФОТ+$18 500/мес
#LangGraph#Multi-Agent#Next.js 15#Supervisor-Worker#Zod
Главные выводы и ключевые тезисы
  • Монолитные LLM-промпты деградируют по качеству при росте контекста свыше 8k токенов из-за эффекта «Lost in the Middle».
  • Иерархическая архитектура Supervisor-Worker разделяет ответственность: супервизор только маршрутизирует, а воркеры выполняют узкие детерминированные действия.
  • Валидация каждого вызова через схемы Zod сводит частоту структурных галлюцинаций к строгому 0.0%.
  • Механизм State Checkpointing в LangGraph сохраняет историю графа в PostgreSQL, позволяя безопасно приостанавливать выполнение для аппрува человеком.
Скорость выполнения4.8 секВместо 3 часов ручной работы операторов
Частота галлюцинаций0.0%Zod-схемы + строгие контракты
Экономия ФОТ+$18 500/месАвтоматизация квалификации и договоров
SLA доступности контура99.95%Отказоустойчивый стейт в Postgres

1. Кризис одиночных LLM: почему монолитные промпты проваливаются в Enterprise

В 2024–2025 годах большинство компаний пытались внедрять ИИ по принципу «один гигантский системный промпт на все случаи жизни». Модели поручали одновременно прочитать договор, извлечь реквизиты, проверить кредитный рейтинг контрагента, сформировать счет и обновить CRM.

В продакшене такой подход терпит неизбежное фиаско: при объеме контекста свыше 8 000 токенов точность соблюдения инструкций падает на 35–40%, модель пропускает ключевые условия или произвольно путает формат JSON-ответа (структурная галлюцинация).

В корпоративном контуре цена ошибки слишком высока: неверно выставленный счет или пропущенный пункт в договоре грозит прямыми финансовыми убытками.

«Одиночная LLM похожа на одного сотрудника, которого заставили быть одновременно юристом, бухгалтером, системным администратором и курьером. Enterprise-решения строятся иначе — как слаженная команда узких специалистов под управлением строгого супервизора.»

2. Паттерн Supervisor-Worker: управление ролями и состоянием

В основе нашего подхода лежит фреймворк LangGraph, моделирующий логику в виде направленного графа состояний (State Graph) с поддержкой циклов и ветвлений.

Архитектура делится на два уровня:

• Supervisor Agent (Диспетчер): Анализирует входящую задачу пользователя, ведет глобальный контекст сделки и принимает решение, кому из подчиненных воркеров делегировать следующий шаг.

• Worker Agents (Исполнители): Узкоспециализированные агенты с ограниченным набором инструментов (Document Parser, Tax Registry Auditor, ERP Connector, Slack Notifier). Каждый воркер получает только те данные, которые необходимы для его шага.

Топология графа LangGraph Supervisor-Worker
text
[ Входящий запрос: «Заключить договор поставки с ООО Вектор» ]
                             │
                             ▼
               ┌───────────────────────────┐
               │    Supervisor Orchestrator │
               │   (Маршрутизатор контекста)│
               └─────────────┬─────────────┘
                             │
          ┌──────────────────┼──────────────────┐
          ▼                  ▼                  ▼
  ┌───────────────┐  ┌───────────────┐  ┌───────────────┐
  │ Legal Auditor │  │ Tax Compliance│  │ ERP Dispatcher│
  │ (Парсинг PDF) │  │ (ЕГРЮЛ / ФНС) │  │ (1C / CRM)    │
  └───────┬───────┘  └───────┬───────┘  └───────┬───────┘
          │                  │                  │
          └──────────────────┼──────────────────┘
                             ▼
               ┌───────────────────────────┐
               │ Human-in-the-Loop Check   │ ◄── Пауза: ожидает подтверждения
               │ (Финансовый директор)     │     в Telegram / интерфейсе
               └─────────────┬─────────────┘
                             ▼
                    [ Успешный коммит ]

3. Ликвидация галлюцинаций через Zod и Structured Outputs

Главный закон enterprise-агентов: ни один агент не имеет права передавать неструктурированный текст в базу данных или соседний сервис. Любой вывод обязан проходить десериализацию и проверку типов через библиотеку Zod.

Если LLM возвращает невалидную структуру, LangGraph перехватывает ошибку валидации и автоматически отправляет агенту сообщение с текстом ошибки (Self-Correction Loop), требуя перегенерации.

Пример строгой схемы вывода контрагента и Tool Call
typescript
import { z } from 'zod';

// Строгая схема данных компании без возможности подделки
export const CompanyAuditSchema = z.object({
  inn: z.string().regex(/^\d{10}(\d{2})?$/, 'ИНН должен содержать 10 или 12 цифр'),
  companyName: z.string().min(2),
  isBankrupt: z.boolean(),
  riskScore: z.enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL']),
  authorizedCapital: z.number().nonnegative(),
  recommendedCreditLimitRub: z.number().max(50_000_000),
  keyRisks: z.array(z.string()).max(5),
});

export type CompanyAudit = z.infer<typeof CompanyAuditSchema>;

// Обертка исполнения агента с гарантией типобезопасности
export async function runLegalAuditAgent(rawInput: string): Promise<CompanyAudit> {
  const response = await model.withStructuredOutput(CompanyAuditSchema).invoke([
    { role: 'system', content: 'Вы — юридический аудитор. Извлеките факты строго по схеме.' },
    { role: 'user', content: rawInput }
  ]);
  
  // Дополнительная runtime-проверка
  return CompanyAuditSchema.parse(response);
}

4. Human-in-the-Loop: контрольные точки для финансовых операций

Полная автономия в B2B опасна, если речь идет о движении денежных средств или подписании юридических документов. Поэтому в критических узлах графа мы настраиваем контрольные точки прерывания (Interrupt Checkpoints).

Граф выполняет сбор данных, анализ рисков и формирование проекта платежки, после чего статус в Postgres переходит в AWAITING_APPROVAL. Руководитель получает пуш-уведомление в Telegram с кнопками «Одобрить» или «Отклонить с комментарием». При клике состояние графа восстанавливается из базы и продолжает выполнение.

5. Бизнес-результаты: сокращение операционных расходов

Внедрение мультиагентного контура в оптовой торговой компании показало результаты уже в первый месяц эксплуатации:

• С 3 часов до 4.8 секунды — сократилось время первичной проверки нового контрагента и выпуска договора.

• 100% точность реквизитов — благодаря валидаторам Zod исключены ошибки перечисления средств на заблокированные счета.

• +$18 500 в месяц чистой экономии — за счет перераспределения рутинных задач и устранения сверхурочных часов в юридическом и финансовом департаментах.

Связанный кейс в портфолиоМетрика: 0 Ручных операций · 28ms Latency

Dynamic Beam Integration

Автономная шина сквозных событий и мультиагентной оркестрации

ВНЕДРЕНИЕ И АРХИТЕКТУРНЫЙ АУДИТ

Хотите устранить рутину или ускорить сайт до 0.18s LCP?

Команда Vertex Studio разработает индивидуальное архитектурное решение: от реактивных шин данных и LLM-агентов до высококонверсионных веб-платформ под ключ.

#LangGraph#Multi-Agent#Next.js 15#Supervisor-Worker#Zod#AI Automation
Вернуться к списку статей