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, вебхуки, MCP-серверы), которые агент может использовать.
  • Задачи — то, что агент делает по расписанию, без вашего участия.
  • Сессии — живые терминалы агентов и их браузерные сессии, если вы попросили агента войти куда-то под вашим аккаунтом.

Для кого эта документация

Для тех, кто пользуется Neo как продуктом: настраивает серверы и агентов, подключает сервисы, следит за задачами и за тем, что агенты делают. Это не справочник по API — у Neo нет публичного API для сторонних интеграций, им не «подключаются» снаружи так, как подключаются к обычному SaaS с токеном. Всё управление идёт через этот интерфейс.

Быстрый старт

Минимальный путь от входа в Neo до первого работающего агента.

1. Войдите или зарегистрируйтесь

На странице входа можно зарегистрироваться по email и паролю или войти через подключённый сервис (Google, Яндекс — зависит от того, что включено для вашего домена). После регистрации Neo создаёт для вас отдельное, изолированное рабочее пространство — ваши серверы, агенты и подключения не видны никому другому.

Если забыли пароль — на странице входа есть ссылка «Забыли пароль?»: она отправит на вашу почту ссылку для сброса, без доступа к старому паролю.

2. Подключите сервер

Раздел Серверы → «Добавить сервер». Укажите адрес, пользователя и способ входа:

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

Пользователь не обязан быть root — достаточно passwordless sudo.

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

Раздел Агенты → «Новый агент». Задайте имя (техническое имя создастся само) и выберите проверенный сервер, на котором агент будет работать. Можно сразу подключить агента к проекту — тогда он получит общий контекст команды — и выбрать для него память: изолированную или общую с другим агентом на этом же сервере.

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

4. Подключите нужные сервисы

Раздел Интеграции: мессенджеры (Telegram, MAX) и универсальные варианты — свой REST API, входящие вебхуки, MCP-серверы. Подключаете сервис один раз и назначаете его нужным агентам.

5. При необходимости — задачи по расписанию

Раздел Задачи: что агент должен делать по расписанию (по cron, каждые N минут или один раз) и каким агентам это назначено. Задачи может вести любой участник рабочего пространства; доступны только агентам с собственной постоянной сессией Claude.

Дальше — читайте разделы по каждой теме подробнее.

Серверы

Сервер — это машина, которая реально выполняет работу агентов. Neo не хранит на них ничего, кроме собственного SSH-ключа (или сертификата) и того, что нужно для подключённых интеграций и агентов.

Добавление сервера

Раздел Серверы → «Добавить сервер» → «Подключите рабочий узел»: адрес, порт, пользователь и способ входа.

Способы входа:

  • Ключ DaxBax Neo (по умолчанию). Neo создаёт отдельный ключ для этого сервера и показывает одну команду — её нужно выполнить на сервере, чтобы добавить публичную часть ключа в authorized_keys. Дальше Neo входит только этим ключом.
  • Свой ключ. Вставляете существующий приватный ключ целиком (с первой и последней строкой). Если ключ защищён паролем — пароль нужен только один раз, чтобы прочитать ключ, и никуда не сохраняется; сам ключ 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-описания. Агент обращается к сервису сам, секрет никогда не покидает ваш сервер.
  • Входящие события (вебхук) — подключение получает свой адрес вида /api/hooks/<токен>, при желании подписанный HMAC-SHA256. Каждое входящее событие становится сообщением, которое агент читает и на которое может ответить — так же, как на сообщение в мессенджере. Ограничение — 120 событий в минуту на одно подключение; содержимое события никогда не выполняется как команда.
  • MCP-сервер — Neo сам добавляет сервер в рабочий набор инструментов агента, без секретов в открытом виде. Новые инструменты агент видит после перезапуска.

Если сервис переименовали или объединили в каталоге

Иногда один сервис в каталоге заменяет несколько старых карточек (например, у Bitrix24 есть выбор способа подключения — вебхук или логин/пароль). Подключения, сделанные под старой карточкой, переносятся на новую автоматически, со своими значениями; поля способа, который вы не выбрали, просто скрываются, а не требуются.

Задачи по расписанию

Раздел Задачи — то, что агент должен делать сам, без вашего участия: по cron-расписанию, каждые N минут или один раз.

Как это работает

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

Кто может назначать задачи

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

Какие агенты могут брать задачи

Только агенты с собственной постоянной сессией Claude — агенты, работающие только через Codex или через общего бота без своей сессии, задачи по расписанию не выполняют.

Если расписание не совпадает

Если Neo видит, что на сервере выполняется не то расписание, которое вы задали, он отправляет правильное повторно (не чаще одного раза в пять минут) — вручную ничего поправлять не нужно.

Вход, выход и безопасность

Вход

Войти в Neo можно по email и паролю или через подключённый сервис (Google, Яндекс — состав зависит от домена, через который вы входите). Регистрация по email требует подтверждения адреса: на почту приходит ссылка, без перехода по ней войти не получится.

Забыли пароль

На странице входа — ссылка «Забыли пароль?». Укажите email: если на него зарегистрирован аккаунт, придёт ссылка для задания нового пароля; если аккаунта с таким адресом нет, страница ответит точно так же — это осознанно, чтобы по форме восстановления нельзя было проверить, зарегистрирован ли конкретный адрес.

Выход

Настройки → «Выйти» завершает текущий вход. Выйти везде завершает все ваши сеансы сразу, включая текущий — потребуется войти снова. Полезно, если вы входили с устройства, которым больше не пользуетесь.

Рабочее пространство

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

Безопасность подключений к серверам

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

Частые вопросы

У Neo есть публичный API, чтобы подключить его к своим системам?

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

Можно добавить сервер без ключей и паролей в открытом виде?

Да — способ входа «Ключ DaxBax Neo» создаёт ключ сам и просит выполнить только одну команду на сервере; ни ключ, ни пароль после этого не возвращаются обратно через интерфейс. Подробнее — Серверы.

Что будет, если Neo временно недоступен?

Уже назначенные задачи по расписанию продолжат выполняться — расписание хранится на самом сервере агента. Браузер и темы Telegram продолжат работать по уже выданной лицензии как минимум неделю.

Как восстановить доступ, если забыл пароль?

Ссылка «Забыли пароль?» на странице входа. Подробнее — Вход, выход и безопасность.

Чем агент отличается от обычного чат-бота?

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