Что такое Agentfy.ai 2.0?

Agentfy.ai даёт каждому интернет-магазину собственного AI-агента — он отвечает клиентам, знает каталог и умеет действовать в магазине, 24/7. Версия 2.0 — это перестройка с нуля, единственная задача которой — сделать это достаточно дёшево, чтобы дать агента каждому магазину (сначала OpenCart). Бизнес-обоснование — в Миссии и рынке.

Одна большая идея

Агент — это строка в базе данных. Он «оживает» только пока обрабатывает запрос, а потом исчезает.

Вот и всё. Всё остальное в этих доках следует из этого.

Старый способ держал по одному постоянно работающему серверу на каждого агента — ты платил за то, что агент существует, даже когда он простаивает (а это почти всё время). Стоимость росла с числом агентов, поэтому «агент для каждого магазина» был просто слишком дорогим.

2.0 переворачивает это. Агент — это просто данные: его конфиг, память и история живут в базе. Когда приходит сообщение, общий stateless-сервис загружает эти данные, «становится» агентом на один ответ и отпускает. Пока агент ждёт, ничего не зарезервировано. Стоимость растёт с реальным трафиком, а не с числом существующих агентов — поэтому дать агента ещё одному магазину почти ничего не стоит.

Почему это важно (в одну строку)

Ты платишь за работу, а не за присутствие.

	Старый способ (1.x)	Agentfy.ai 2.0
Агент — это…	постоянно работающий сервер	строка в базе данных
Ты платишь за…	существование агента (простой или нет)	реально обработанные запросы
Стоимость растёт с…	числом агентов	трафиком
«Агент для каждого магазина»?	слишком дорого	по умолчанию

Всё целиком за 60 секунд

• Всегда доступен, но никогда не always-on. Агент — это данные; он работает только во время запроса.
• Мозг и пара рук. «Мозг» думает и отвечает; когда задаче нужен настоящий компьютер (запустить скрипт, открыть сайт), он передаёт это короткоживущему «рукам»-воркеру. → Как это работает
• Знания и инструменты подключаются. Каталог магазина (знания) и его API (инструменты) присоединяются к агенту через стандартный коннектор (MCP) — сам мозг остаётся маленьким.
• Собрано как четыре деплоя. api, app, admin, worker. → Из чего состоит
• Организовано как слоистые слайсы. Строгая, предсказуемая структура кода. → Как мы это строим
• Работает на дешёвой общей инфраструктуре. Один маленький Kubernetes-кластер; состояние в Postgres/Redis.

Новичок в терминах (агент, ephemeral, мозг/руки, слайс, MCP)? Держи Глоссарий открытым в соседней вкладке.

Чистая перестройка, а не порт

2.0 — это greenfield. Мы не портируем код 1.x — сегодняшняя версия (привязанный к AWS, request-центричный RAG-чатбот) это референс того, что продукт делает, а не план миграции. Мы строим заново на CleanSlice (NestJS + Prisma) и берём библиотеку LightRAG для знаний. Маппинг 1.x — в Справке по миграции.

Куда идти дальше

Если хочешь…	Читай
Понять ментальную модель	Как это работает
Увидеть, что деплоится	Из чего состоит
Писать код в репозитории	Как мы это строим
Найти термин	Глоссарий
Углубиться в архитектуру	Слои-слайсы · Модель рантайма

Где живёт код

• Воркспейс / скаффолд: cleanslice/agentfy2/ — эти доки, папки приложений, скаффолд слайсов/README.
• Прежний инженерный план: agentfy/agentfy/api2/ACTION-PLAN.md (использован как источник).
• Референсы: Ranch (cleanslice/ranch) для паттернов k8s / браузера / стриминга подов; cleanslice/runtime для tool-executor'ов.