К блогу

AI-агенты с human-in-the-loop

Цикл AI-агента: пользователь, ToolLoop, approval, API

AI-агенты в шаблоне — не chatbot с заготовленными ответами, а рабочие примеры на Vercel AI SDK v7: цикл инструментов, стриминг в UI и обязательное одобрение человеком для опасных действий.

Два агента из коробки

SlugРоль
supportL1 поддержка: KB, заказы, возвраты
incidentSRE on-call: health, логи, rollback

Оба построены на ToolLoopAgent — модель сама выбирает последовательность инструментов, а не один раз ищет в векторной базе.

Где смотреть код

  • Конфигурация — app/lib/ai/agents/config.ts
  • Реализация — support-agent.ts, incident-agent.ts
  • API — POST /api/agents/:slug со стримингом
  • Демо без квоты — /demo/support

Перед стримом API резервирует единицу квоты (usage.server.ts). При исчерпании — HTTP 402.

Попробуйте сами

Support: промпт про двойное списание Pro и 403 на API — агент найдёт ORD-1042 и статьи KB-014 / KB-027.

Incident: алерт про 502 на checkout-api — ожидайте getServiceHealth, queryLogs, предложение rollback с approval.

# Локально нужен ключ LLM
DEEPSEEK_API_KEY=sk-...

При добавлении своего агента копируйте support-agent.ts: инструменты с Zod-схемами, read-only vs write-tools, toolApproval на write.