Main/AI Engineering/Blueprints/Multi-Agent Systems/Автономный multi-agent пайплайн анализа бизнес-метрик (Planner-Worker-Validator)
Back to «Multi-Agent Systems» cards
Multi-Agent Systems(ТЗ 3 из 6)
ТЗ: Автономный multi-agent пайплайн анализа бизнес-метрик (Planner-Worker-Validator)
Multi-Agent Systems1 шагов • +5 XP

ТЗ: Автономный multi-agent пайплайн анализа бизнес-метрик (Planner-Worker-Validator)

Инженерная спецификация мультиагентной системы на базе LangGraph / StateGraph: динамическая декомпозиция задач, цикл верификации расчетов, предотвращение зацикливания и генерация интерактивных отчетов.

~14 ч работыУровень: SeniorLangGraph / StateGraphPlanner-Worker-Validator PatternStructured Outputs (Zod)Human-in-the-LoopSelf-Correction Loop
+5 XP за шаг
Выполнено 0 из 1 шагов (0%)
Трудозатраты~14 рабочих часов
Фриланс вилка~$630 – $1,050 (€560 – €980)
Оценка веб-студии~$1,330 – $2,240 (€1260 – €2100)

ТЗ заказчика (исходный бриф):

Одиночные LLM часто ошибаются в цифрах. Мультиагентный подход с отдельным агентом-валидатором гарантирует, что ни одна непроверенная цифра не попадет в отчет руководству.
Ключевые требования:
  • •Построение графа состояний StateGraph с типизированными ребрами перехода
  • •Агент-Планировщик (Planner): декомпозиция вопроса на подзадачи
  • •Агент-Аналитик (Worker): генерация и запуск SQL-запросов к витрине данных
  • •Агент-Критик (Validator): сопоставление контрольных сумм и проверка деления на ноль
Ограничения проекта:
  • •Максимум 3 попытки самоисправления при обнаружении ошибки валидатором (Recursion Limit)
  • •Сохранение состояния сессии (Checkpointer) для продолжения диалога
Критерии приёмки (KPI):
  • Точность финансовых расчетов = 100%
  • Время построения сквозного аналитического отчета < 15 секунд

Пошаговое практическое руководство по ТЗ

Подробный разбор архитектуры, код реализации и советы эксперта по каждому этапу:

1
Этап 1 из 1

Проектирование графа состояний и ролей в StateGraph

~60 мин

Практическое руководство:

Создать модуль agents/analystGraph.ts с определением общего состояния AnalystState, узлов plannerNode, workerNode, validatorNode и условных переходов conditionalEdge.

Важные технические нюансы и подводные камни:

Убедитесь, что счетчик итераций увеличивается на каждом шаге для защиты от бесконечных циклов.

Архитектурная база (Почему выбрано такое решение):

Детерминированный граф состояний (StateGraph) превосходит хаотичные ReAct циклы, гарантируя строгое следование бизнес-правилам верификации.

Совет эксперта (Best Practice):

Всегда задавайте верхний лимит рекурсии (Recursion Limit) в конфигурации графа, чтобы не сжечь токены при сбое валидатора.

Ожидаемый артефакт этапа:

Граф состояний мультиагентной системы с циклом валидации.

TYPESCRIPT
// lib/agents/analystGraph.ts
export interface AnalystState {
  question: string
  plan: string[]
  sqlQueries: string[]
  dataResults: Record<string, unknown>[]
  validationErrors: string[]
  iterationCount: number
  isApproved: boolean
  finalReport: string
}

export function shouldContinue(state: AnalystState): 'worker' | 'report' | 'abort' {
  if (state.isApproved) return 'report'
  if (state.iterationCount >= 3) return 'abort'
  return 'worker'
}

export async function validatorNode(state: AnalystState): Promise<Partial<AnalystState>> {
  const errors: string[] = []

  // Проверка аномалий в данных
  for (const row of state.dataResults) {
    if (typeof row.revenue === 'number' && row.revenue < 0) {
      errors.push('Обнаружена отрицательная выручка в строке данных')
    }
  }

  const isApproved = errors.length === 0

  return {
    isApproved,
    validationErrors: errors,
    iterationCount: state.iterationCount + 1
  }
}

Типичные грабли на этом ТЗ

1 антипаттерна

Что сдаём клиенту (Deliverables)

Чек-лист сдачи
Мультиагентный граф LangGraph / StateGraph
Автоматический валидатор математических аномалий
Генератор итогового отчета в формате Markdown