Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

За DaxBax Neo

DaxBax Neo е контролен панел за екип от ИИ-агенти, работещи на вашите собствени сървъри. Тук виждате какво прави всеки агент в момента, можете да създавате или спирате агенти, да свързвате услуги и месинджъри към тях и да им възлагате задачи по график — без да влизате на всеки сървър ръчно през SSH.

Агент в Neo е инстанция на Claude Code (или Codex), работеща на вашия сървър, представена в Neo като „служител“: има име, карта, свои връзки, и — ако го включите — собствен браузър и собствени теми в Telegram. Самите агенти работят на вашите сървъри; Neo е начинът, по който ги управлявате и наблюдавате, а не услуга, която върши работата вместо вас някъде в облака.

От какво се състои

  • Сървъри — машините, на които реално работят агентите ви. Свързвате сървър веднъж, а после Neo може да стартира на него един или няколко агента.
  • Агенти — отделни ИИ-„служители“, всеки със собствен контекст и връзки.
  • Проекти — общ контекст за няколко агента наведнъж: кои сте, с какво се занимавате, кои са клиентите ви. Всеки агент, прикачен към проект, вижда това описание в собствените си инструкции.
  • Интеграции — месинджъри (Telegram, MAX) и собствени услуги (REST API, webhook-ове, MCP сървъри), които агентът може да използва.
  • Задачи по график — какво прави агентът по разписание, без вас.
  • Сесии — живите терминали на агентите и техните браузърни сесии, когато поискате от агент да влезе някъде с вашия акаунт.

За кого е тази документация

За хората, които реално използват Neo: настройват сървъри и агенти, свързват услуги, следят задачи и какво правят агентите. Това не е справочник по API — Neo няма публичен API за интеграции на трети страни по начина, по който обикновен SaaS продукт го предлага с токен. Всичко се управлява през този интерфейс.

Първи стъпки

Най-прекият път от входа до първия работещ агент.

1. Вход или регистрация

На страницата за вход можете да се регистрирате с имейл и парола, или да влезете през свързан доставчик (Google, Yandex — наличните варианти зависят от домейна, през който влизате). Регистрацията веднага ви дава собствено, изолирано работно пространство — вашите сървъри, агенти и връзки не са видими за никой друг.

Забравили сте паролата си? На страницата за вход има линк „Забравена парола?“: изпраща ви по имейл линк за задаване на нова, без да е нужна старата.

2. Свържете сървър

Сървъри → „Добавяне на сървър“. Задайте адрес, потребител и начин на вход:

  • Ключ на DaxBax Neo (по подразбиране) — Neo генерира ключ за този сървър и ви показва една команда за изпълнение на сървъра, която добавя публичната част на ключа в authorized_keys.
  • Ваш собствен ключ — поставяте съществуващ частен ключ изцяло (с първия и последния ред).
  • Парола — Neo влиза веднъж, добавя собствения си ключ и го използва оттам нататък; можете да запазите паролата, ако сървърът отказва вход с ключ.

Потребителят не е длъжен да е root — достатъчен е passwordless sudo.

3. Създайте агент

Агенти → „Нов агент“. Задайте име (техническото име се генерира само) и изберете проверен сървър, на който агентът да работи. Можете веднага да го прикачите към проект, за да получи общия контекст на екипа, и да изберете неговата памет: изолирана или споделена с друг агент на същия сървър.

След създаването агентът се появява в Сесии — там виждате живия му терминал.

4. Свържете нужното

Интеграции: месинджъри (Telegram, MAX) и универсални варианти — ваш собствен REST API, входящи webhook-ове, MCP сървъри. Свързвате услуга веднъж и я възлагате на агентите, които имат нужда от нея.

5. Задачи по график, ако са ви нужни

Задачи по график: какво трябва да прави агент по разписание (по cron, на всеки N минути или еднократно) и на кои агенти е възложено. Всеки член на работното ви пространство може да управлява задачи; само агенти със собствена постоянна Claude сесия могат да ги изпълняват.

Оттук нататък прочетете раздела за всяка тема по-подробно.

Сървъри

Сървърът е машина, която реално извършва работата на агентите. Neo не съхранява нищо на него, освен собствения си SSH ключ (или сертификат) и каквото е необходимо за връзките и агентите, които настроите на него.

Добавяне на сървър

Сървъри → „Добавяне на сървър“ → „Свързване на работен възел“: адрес, порт, потребител и начин на вход.

Начини на вход:

  • Ключ на DaxBax Neo (по подразбиране). Neo генерира специален ключ за този сървър и показва една команда за изпълнение на него, добавяща публичната част в authorized_keys. Оттам нататък Neo влиза само с този ключ.
  • Ваш собствен ключ. Поставяте съществуващ частен ключ изцяло (с първия и последния ред). Ако ключът е защитен с парола, тя се ползва само веднъж — за прочитане на ключа — и никога не се запазва; самият ключ се пази криптиран, без паролата.
  • Парола. По подразбиране паролата се използва веднъж: Neo влиза, добавя собствения си ключ в authorized_keys, проверява, че ключът работи, и оттам нататък влиза с него, забравяйки паролата. Ако сървърът отказва вход с ключ, можете да запазите паролата вместо това, и Neo ще продължи да я използва (включително за отговор на sudo подкани).

Нито ключът, нито паролата се показват обратно през интерфейса — одитният журнал записва използваният метод, никога самия секрет.

Потребителят не е длъжен да е root: достатъчен е passwordless sudo (<user> ALL=(ALL) NOPASSWD:ALL). Бутонът „Проверка“ отказва сървъра без това.

Смяна на адрес или потребител

Смяната на хост, порт или потребител изисква повторна проверка на връзката.

Един сървър, няколко агента

Към един и същ сървър може да бъде прикачен повече от един агент; те могат да го споделят, но всеки има своя памет — изолирана, или споделена с конкретен друг агент на същия сървър, избрано при създаването на агента.

SSH сертификати вместо постоянен ключ

Някои работни пространства имат включен допълнителен слой защита: вместо постоянен ключ Neo подписва всяка връзка с краткотраен сертификат (валиден около 30 минути), издаван от отделна сертификатна служба. Ако това е включено за вашето пространство, сървърите преминават към него сами, във фонов режим, без да е нужно да правите нищо — старият ключ просто спира да се използва. Настройки → „SSH сертификати“ показва колко сървъри вече са преминали.

Агенти

Агент в Neo е инстанция на Claude Code (или Codex), работеща на един от вашите сървъри, показана в интерфейса като отделен „служител“: собствено име, карта, връзки и състояние.

Създаване на агент

Агенти → „Нов агент“: име (на всеки език — техническото име се генерира само) и сървър, на който ще работи. Нужен е поне един проверен сървър; ако все още нямате такъв, можете да го добавите направо от същия екран.

Можете също:

  • да прикачите агента към проект — тогава той получава общия контекст на проекта (кои сте, с какво се занимавате, кои са клиентите ви);
  • да му зададете изолирана памет, или да споделите памет с друг агент, работещ вече на същия сървър.

След създаването агентът веднага се появява в Сесии.

Браузърът на агента

Можете да включите собствен браузър на агента (карта на агента → „Браузърни сесии“). Той пази постоянен профил: веднъж направен вход се запазва и се използва автоматично оттам нататък.

Ако агентът трябва да влезе някъде с вашия личен акаунт, той никога не въвежда паролата сам и никога не я иска от вас в чат — изпраща заявка за вход, която виждате и одобрявате в Сесии (вижте Сесии).

Теми в Telegram

Карта на агента → „Теми в Telegram“: агент може да води цяла Telegram група през собствени теми, всяка отделен разговор със свой контекст — /new в тема я започва отново, затварянето на тема я архивира. Всички теми на един агент споделят неговата дълготрайна памет. Група се обвързва с код, показан на картата на агента (/bind <код>, изпратен в групата) — група, в която ботът е просто добавен, не получава нищо, докато кодът не бъде изпратен. Ботът трябва да е администратор на групата, или да има изключен режим на поверителност в @BotFather — иначе няма да вижда съобщения в темите.

Ако Neo временно е недостъпен

Браузърът и темите в Telegram работят по лиценз, който продължава да действа до седмица, дори ако Neo не отговаря — кратко прекъсване от двете страни не изключва тези функции.

Сесии: наблюдение на агентите и вход вместо тях

Сесии показва какво прави в момента всеки агент на всичките ви сървъри.

Жив терминал

Всеки агент има текущата си работна сесия — какво пише и вижда в своя терминал. Можете да я отворите, да я наблюдавате и сами да пишете в нея, ако трябва да насочите или поправите агента в движение.

Браузърни сесии

Ако агент има включен собствен браузър (карта на агента → „Браузърни сесии“), тук се проявява основното му предназначение: понякога агентът трябва да влезе някъде с вашия личен акаунт — сайт, който не се отваря без вход. Тогава:

  1. агентът изпраща заявка за вход — виждате я точно тук, в Сесии;
  2. отваряте браузъра на агента от този екран, виждате страницата за вход и поемате контрол;
  3. влизате сами, както обикновено;
  4. предавате браузъра обратно на агента.

Докато не го предадете обратно, командите на агента към браузъра изчакват. Самият агент никога не вижда и не помни паролата — научава само че входът е успял. Профилът на браузъра се пази, така че следващия път няма да е нужно да влизате отново: помни се по същия начин, по който обикновен браузър помни вход.

Теми в Telegram в Сесии

Ако агент има включени теми в Telegram, всяка тема (отделен разговор) се показва и тук, с нейните съобщения и действията „Отначало“ / „В архива“.

Проекти

Проектът е общ контекст за няколко агента наведнъж: кои сте, къде се намирате, с какво се занимавате, кои са клиентите ви. Този текст става част от работните инструкции на всеки агент, прикачен към проекта — всеки „служител“ на проекта го вижда.

Защо е полезно

Ако няколко агента работят по едно и също направление, не е нужно да обяснявате на всеки поотделно кои сте и с какво се занимава компанията — пишете го веднъж, в проекта, и всеки агент, който прикачите, получава веднага този контекст.

Създаване и редактиране

Проекти → „Създаване на проект“: име и описание на компанията и проекта. Можете да видите как картата ще изглежда в списъка („Преглед на проекта“), преди да запазите.

Промени в описанието могат да се приложат към всички агенти в проекта наведнъж.

Прикачане на агент към проект

Прави се при създаването на агента (незадължителното поле „Проект“) — агент без проект работи само със собствения си контекст.

Интеграции и връзки

Интеграции е каталог на услуги, които можете да свържете, и списък на вече свързаните. Услуга се свързва веднъж, след което се възлага на агентите, които имат нужда от нея.

Месинджъри

Telegram и MAX — агент може да има собствен специализиран бот (отговаря само за него, незабавно), или споделен бот през връзка, която насочва съобщенията към правилния агент.

Telegram освен това има теми: агент води всяка тема на група като собствен отделен разговор — вижте Агенти за подробности.

Ваши собствени услуги

Ако няма готова карта за услуга, от която имате нужда, категорията „Универсални“ покрива всичко останало, по три начина:

  • Ваша собствена услуга (REST API) — базов адрес, начин на вход, секрет и, по желание, адрес на OpenAPI описание. Агентът сам се обръща към услугата; секретът никога не напуска вашия сървър.
  • Входящи събития (webhook) — връзката получава собствен адрес, например /api/hooks/<токен>, по желание подписан с HMAC-SHA256. Всяко входящо събитие се превръща в съобщение, което агентът прочита и на което може да отговори — по същия начин, както на съобщение в месинджър. До 120 събития в минута на връзка; нищо в тялото на събитие никога не се изпълнява като команда.
  • MCP сървър — Neo сам добавя сървъра към набора от инструменти на агента, без да излагат секрети в открит вид. Агентът вижда новите инструменти след рестарт.

Когато запис в каталога е преименуван или обединен

Понякога една карта в каталога заменя няколко по-стари (например Bitrix24 предлага избор на начин на свързване — webhook или вход с потребител/парола). Връзките, направени под старата карта, автоматично се прехвърлят към новата, запазвайки стойностите си; полетата за начина, който не сте избрали, просто се скриват, а не се изискват.

Задачи по график

Задачи по график е това, което агент прави сам, без вас: по cron разписание, на всеки N минути или еднократно.

Как работи

Neo проверява разписанието и го предава на собствения сървър на агента; оттам нататък самият сървър го изпълнява — Neo не трябва да е достъпен, за да се задейства задача, и кратко прекъсване на Neo не спира никоя задача. Неуспешни изпълнения се повтарят, а пропуснатите по време на прекъсване се довършват след това.

Кой може да възлага задачи

Всеки член на работното ви пространство може да управлява задачи, не само онзи, който е създал агента.

Кои агенти могат да изпълняват задачи

Само агенти със собствена постоянна Claude сесия — агенти, работещи единствено през Codex или през споделен бот без своя сесия, не изпълняват задачи по график.

Ако разписанието не съвпада

Ако Neo види, че сървърът изпълнява различно разписание от зададеното от вас, изпраща правилното отново (най-много веднъж на пет минути) — няма нужда да поправяте нищо ръчно.

Вход, изход и сигурност

Вход

Можете да влезете с имейл и парола, или през свързан доставчик (Google, Yandex — наличните варианти зависят от домейна, през който влизате). Регистрацията с имейл изисква потвърждение на адреса: изпраща се линк на пощата ви, и не можете да влезете, докато не го последвате.

Забравена парола

На страницата за вход има линк „Забравена парола?“. Въведете имейла си: ако за него съществува акаунт, ще получите линк за задаване на нова парола. Ако няма акаунт за този адрес, страницата отговаря по напълно същия начин — това е нарочно, за да не може формата за възстановяване да се използва за проверка дали определен адрес е регистриран.

Изход

Настройки → „Изход“ прекратява текущата сесия. Изход навсякъде прекратява всичките ви сесии наведнъж, включително текущата — ще трябва да влезете отново. Полезно е, ако сте влизали от устройство, което вече не използвате.

Вашето работно пространство

Регистрацията веднага ви дава собствено, изолирано работно пространство — вашите сървъри, агенти, връзки и проекти не са видими за никой, освен за хората, които сте поканили в него.

Сигурност на връзките със сървъри

Сървърите, с които Neo се свързва по ваша молба, се проверяват след разрешаването на името до адрес: връзки към localhost, частни и вътрешни диапазони (включително адреси на облачни метаданни) се отказват категорично, а грешките при свързване винаги се съобщават по общ начин, за да не могат да се използват за сондиране на вашата вътрешна мрежа.

Често задавани въпроси

Neo има ли публичен API, за да го свържем със собствените си системи?

Не. Neo не е платформа с API за интеграции на трети страни — това е интерфейс за управление и наблюдение на собствените ви агенти. Ако е нужно да пренесете данни от своя система към агент, или обратното, това става през Интеграции, а не чрез свързване към Neo отвън: агентът сам се обръща към вашата услуга, или вашата услуга изпраща събития на адреса за webhook, който Neo ви дава.

Мога ли да добавя сървър, без да излагам ключове или пароли в открит вид?

Да — начинът на вход „Ключ на DaxBax Neo“ генерира ключ сам и само иска да изпълните една команда на сървъра; нито ключът, нито паролата се показват обратно през интерфейса след това. Вижте Сървъри.

Какво се случва, ако Neo временно е недостъпен?

Вече възложените задачи по график продължават да се изпълняват — разписанието живее на собствения сървър на агента. Браузърът и темите в Telegram продължават да работят по съществуващия лиценз поне седмица.

Как да си върна достъпа, ако съм забравил паролата?

Линкът „Забравена парола?“ на страницата за вход. Вижте Вход, изход и сигурност.

По какво агентът се различава от обикновен чатбот?

Агентът има собствена работна сесия на вашия сървър (терминал, който можете да наблюдавате в Сесии), памет, която се запазва между разговорите, и достъп до услугите, които сте му свързали — той не просто отговаря на съобщения, той извършва работата.