Глоссарий

Исторический проект: упоминания запланированного LightRAG и графового хранилища ниже отменены решением AGNT2-303. Сейчас знания используют поиск словами и векторами; старые упоминания не являются инструкцией по реализации или развёртыванию. Knowledge.

Все термины из этих доков в одном месте и простым языком. Сгруппированы по темам; пробеги раз — и остальное читается легко.

Большая идея

Агент (Agent)

AI-ассистент для одного магазина. Технически это просто данные — конфиг + память + история — хранящиеся как строка в базе. «Оживает» только пока обрабатывает запрос. См. Что такое Agentfy.ai 2.0?

Ephemeral (эфемерный)

«Существует лишь мгновение». Рантайм нашего агента эфемерный: работает во время одного хода или задачи, потом исчезает. Противоположность always-on.

Always-on

Сервис, который работает непрерывно, делает он что-то или нет (и всё это время стоит денег). Модель 1.x держала по одному always-on серверу на агента; 2.0 избегает этого для агентов.

Scale-to-zero

Когда трафика нет, ничего не работает и ничего не стоит. И мозг, и руки масштабируются до нуля.

Ход (Turn)

Один цикл запрос → ответ агента: приходит сообщение, мозг его обрабатывает, уходит ответ.

Движущиеся части

Мозг (Brain)

Часть, которая думает и отвечает. Это сервис api, запущенный на один ход — отдельного «сервера агента» нет. См. Как это работает.

Руки (Hands)

Часть, которая делает работу на настоящем компьютере (скрипты, файлы, браузер, долгие задачи). Её даёт воркер.

Воркер (Worker)

Песочница по требованию, которая и есть руки. Контейнер с настоящей ОС (bash + Chromium), который выполняет одну задачу и завершается — создаётся под задачу как Kubernetes Job. См. Worker.

Задача (Task)

Единица работы, которую мозг передаёт воркеру (например, «спарсить эту страницу», «сгенерировать этот файл»).

Тип агента

Чем агент является — standard (то, что создаёт владелец) или concierge (системный агент команды). Одна декларация говорит, что разрешено каждому типу, и её читают и сервер, и интерфейс. Тип назначает только сервер. См. Состав.

Консьерж (Concierge)

Собственный системный агент команды — один на команду, персона приходит из кода. Отвечает в чате команды и умеет действовать на агентах команды. Его нельзя переименовать, удалить и экспортировать. Он строка Agent такая же, как все остальные — одна на команду, её id выводится из id команды, — поэтому его переписка сохраняется, попадает в списки и читается обычными агентскими путями и переживает перезагрузку страницы.

То, что он говорит об умениях продукта, идёт из одной декларации возможностей, а не из прозы в персоне. Всё, чего декларация не покрывает, он трактует как «не берусь утверждать», а не как «Agentfy этого не умеет».

Автозапуск (heartbeat)

Агент сам будит себя по интервалу и выполняет полноценный ход без чьего-либо сообщения. Кому пора, решает единственный глобальный обходчик; занятый агент пропускается, а тику, которому нечего сказать, нечего и сохранять. См. Автозапуск.

Блокировка хода (turn lock)

То, что заставляет агента выполнять один ход за раз, — и то, что автозапуск проверяет перед тиком. См. Модель рантайма.

Профиль исполнения

Разрешены ли агенту руки вообще и сколько машины он под них получает — none · light · browser · heavy · warm. Это колонка у агента, по умолчанию none, поэтому ни один релиз не выдаёт руки агенту, у которого их не было. Агент с none не трогает ни очередь, ни кластер. См. Состав.

Грант инструментов

Какие из инструментов воркера могут достаться сессиям этого агента. Подмножество тех десяти имён, которые разделение инструментов отдаёт рукам; по умолчанию пусто — то есть воркер без инструментов, а не воркер со всеми.

История работы

Собственная короткая запись агента о том, что он делал — ответил, сделал, отказал — по одной читаемой строке, с «было → стало» на всём, что он менял. Отказы — такие же строки, как всё остальное. См. История работы.

Администратор платформы

Учётная запись, которой видны все команды, а не только своя. Это не то же, что администратор внутри команды, и выдаётся оно намеренно непросто. См. Роль платформы.

Знания (Knowledge)

То, что агент знает о магазине — его каталог и документы — хранится в отдельном сервисе и запрашивается по требованию. Построено на LightRAG.

Память (Memory)

Память агента: кратковременная (текущий диалог) и долговременная (факты между диалогами). См. Чат → Память.

Как это деплоится

api

Главный деплой: Core (центр управления) и эфемерный мозг — один образ. См. Из чего состоит.

app / admin

Два Nuxt-приложения: app — кабинет клиента, admin — админ-панель.

Control plane / data plane

Способ делить систему по жизненному циклу: control plane работает постоянно (api Core, веб-приложения); data plane — это эфемерный мозг + руки, работающие только по требованию. Это не дробление по фичам.

Docker-образ (Container image)

Упакованная, запускаемая сборка одной части (api / app / admin / worker). Каждая часть поставляет свой Dockerfile. См. Docker-образы.

Как организован код

CleanSlice

Архитектурный фреймворк, на котором сделаны эти приложения — full-stack NestJS + Nuxt, организованный в вертикальные слайсы. (Доки CleanSlice.) См. Как мы это строим.

Слайс (Slice)

Самодостаточный модуль-фича, который владеет всем нужным: своими роутами, логикой, доступом к данным и (на фронте) компонентами и страницами. Именуется в единственном числе (user, не users).

Слой / группа (Layer / group)

Слайсы сгруппированы в наложенные слои (infra → setup → system → user → admin → runtime → agent → billing). Зависимости идут только вниз — верхний слой может использовать нижние, но не наоборот. См. Слои-слайсы.

Gateway

Паттерн доступа к данным: абстрактный контракт (IXxxGateway) живёт в domain/, конкретная реализация — в data/. Prisma и есть репозиторий — классов *Repository нет.

Коннекторы и данные

MCP (Model Context Protocol)

Стандартная «розетка», через которую инструменты, данные и знания подключаются к агенту. Присоединил MCP-сервер — агент получил эти действия/источники, не меняя мозг.

Инструмент (Tool)

Действие, которое агент может совершить, выставленное через MCP — например, API OpenCart для товаров и заказов.

LightRAG

Open-source библиотека graph-RAG, которую мы запускаем как сервис знаний, с отдельным воркспейсом на каждую базу знаний. См. Знания.

RLM (Recursive Language Models)

Путь извлечения без индекса: мозг рекурсивно просматривает сырые данные (peek/grep/slice в worker'е, вызовы суб-LLM на кусках) вместо запроса к заранее построенному индексу. Ноль ингестии, оплата в момент запроса. См. RLM.

Postgres / Redis / объектное хранилище

Где живёт состояние, чтобы эфемерный рантайм оставался stateless: Postgres (агенты, сессии, задачи, сообщения, биллинг), Redis (очередь, события, локи), объектное хранилище (файлы/артефакты).

Продукт и рынок

OpenCart

Первая e-commerce платформа, на которую мы целимся — большая база self-hosted магазинов с расширяемым API. Дальше: WooCommerce, PrestaShop, Magento, Shopify. См. Миссия и рынок.

Greenfield

Построено с нуля, не портировано. 2.0 — greenfield-перестройка; 1.x только референс того, что продукт делает. См. Справку по миграции.