Делюсь опытом: ИИ-агент на Claude без LangChain и RAG — разбор архитектуры и развилок

В сфере искусственного интеллекта произошло заметное событие. eignatiev 6 минут назад Делюсь опытом: ИИ-агент на Claude без LangChain и RAG — разбор архитектуры и развилок Средний 14 мин 49 Искусственный интеллект Python * Проектирование и рефакторинг * Ненормальное программирование * Кейс Из песочницы Зачем я это пишуЗапустил недавно прод-агента на Claude — небольшой, для бытовой задачи у знакомой. По дороге понял несколько вещей, которые сначала казались мне очевидными «после интернета», а потом, когда сел и проверил на реальной задаче, начали играть иначе. Хочется поделиться разбором — может, кому-то сэкономит неделю-другую на тех же развилках.

Сразу честно: я не «академический» разработчик. До последнего года писал на Python в основном чтобы прочитать чужой скрипт и подправить отступ. То, что вы увидите в коде ниже — собирал руками, лезя в документацию по каждому слою.

Технические детали

Поэтому это не «гайд от эксперта», а скорее дневник развилок — где я выбрал так и так и почему. Если у вас опыт глубже и я где-то перегнул палку или упустил — буду благодарен за поправки в комментариях, для меня это самая ценная часть таких публикаций. Никаких ссылок, кодов промокодов и «закажите у нас» — просто разбор.

TL;DRСделал ИИ-агента для небольшой студии дизайна интерьера. Делает две вещи:Чат на сайте — отвечает на типовые вопросы про услуги, тарифы, сроки, мягко переводит на встречу с дизайнером. Эндпоинт /brief — клиент заполняет короткий бриф через форму, на выходе получает три заметно разных концепции интерьера: палитра, материалы, мебель, свет, четыре фото из Pexels на каждую.

Стек: Claude Haiku 4. 5 для чата, Claude Sonnet 4. 6 для генерации концепций, FastAPI на Railway, Pexels API для фото, статичный фронт на VPS.

Отраслевые последствия

Без LangChain, без LlamaIndex, без векторной базы, без RAG-фреймворка. py на 712 строк, два промпта, четыре эндпоинта. В статье — почему именно этого хватило, какие развилки прошёл, на каких граблях постоял и где этот подход начнёт ломаться.

КонтекстЗаказ: у знакомой — небольшая студия дизайна интерьера. Один дизайнер, проектов в работе одновременно три-четыре. Бюджет на разработку — несколько рабочих дней (это я сам себе ставил, у нас был дружеский договор).

Боль на входе воронки понятная: клиенты пишут в WhatsApp в одиннадцать вечера, утром половина уже у конкурентов, потому что никто им не ответил. И вторая боль — клиент часто сам не понимает, чего хочет, и приходит на встречу «расскажите мне что-нибудь». Из этих двух болей выросли две сущности:Чат-агент — отвечает мгновенно ночью, не оставляет сообщения «висеть до утра».

Этот прогресс даёт важные сигналы о будущем отрасли, и технологический мир внимательно наблюдает.