Що таке 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’ів.