Что произошло
В 2026 году, когда Agent-фреймворки вроде LangChain, CrewAI и AutoGen уже высоко зрелы, противоинтуитивный open-source туториал набирает популярность на GitHub: он учит разработчиков создавать AI-агентов с нуля без каких-либо фреймворков.
Проект получил 1500+ звёзд, и отзывы сообщества показывают растущую обеспокоенность разработчиков «чёрным ящиком» фреймворков — когда фреймворки обрабатывают вызовы инструментов, управление состоянием и координацию мульти-агентов за вас, вы на самом деле не понимаете, что делает ваш агент, и как его отлаживать, когда что-то ломается.
Прогрессивная архитектура туториала
Туториал разбивает разработку агента на чёткие фазы, вводя только одно новое понятие на каждом этапе:
Фаза 1: Основы одиночного агента (Шаги 0-6)
| Шаг | Содержание | Ключевые знания |
|---|---|---|
| 0 | Базовый цикл чата | Вызовы LLM API, форматы сообщений |
| 1 | Инженерия системного промпта | Определение роли, поведенческие ограничения |
| 2 | Определение и вызов инструментов | Схема function calling |
| 3 | Слой выполнения инструментов | Парсинг вывода LLM, выполнение инструментов, обработка результатов |
| 4 | Управление циклом | Логика цикла: вызов инструмента → результат → следующий раунд |
| 5 | Обработка ошибок | Повторные попытки и откат при ошибках вызова инструментов |
| 6 | Управление контекстом | Подсчёт токенов, стратегии усечения контекста |
Матрица выбора: Фреймворк vs Ручное написание
| Сценарий | Рекомендуемый подход | Причина |
|---|---|---|
| PoC / Быстрая валидация | LangChain / CrewAI | Быстрая разработка, гибкая итерация прототипа |
| Продакшен | Ручное написание ядра + помощь фреймворка | Контролируемые основные пути, вспомогательные функции через фреймворки |
| Высококонкурентные сервисы | Ручное написание | Производительность фреймворков неприемлема |
| Сложная оркестрация мульти-агентов | CrewAI + кастом | Стоимость ручного написания мульти-агентной оркестрации слишком высока |
| Обучение | С нуля | Лучший путь к пониманию внутренних принципов |
Как использовать
Этот туториал лучше всего подходит для двух типов разработчиков:
- Разработчики, которые использовали LangChain/CrewAI, но хотят понять внутренние принципы: Используйте туториал как справочник «обратного инжиниринга», чтобы понять, что фреймворки делают на самом деле под капотом
- Инженеры, создающие высокопроизводительные Agent-системы для продакшена: На основе архитектуры туториала кастомизируйте и оптимизируйте для ваших конкретных бизнес-сценариев
Практическая рекомендация: Не выбирайте одно или другое. Используйте фреймворки для быстрого прототипирования и валидации идей, а затем перепишите основные пути, используя подход туториала, оставив фреймворки только для некритичных вспомогательных функций.