Документация Neiron — полностью

Сборка: 09.10.2026, 21:04:35 МСК. Оглавление: https://neiron.org/docs/agent/.

Что такое Neiron

Раздел: Документация Neiron. Обновлено: 28.09.2026, версия 6. Адрес для людей: https://neiron.org/docs/chto-takoe-neiron/

Одной фразой

Neiron — это команда ИИ-сотрудников для вашего бизнеса. Оркестр нейросотрудников (AI-агентов), который берёт на себя операционку и работает 24/7.

Это не «умный чат-бот, которому можно задать вопрос», а полноценная рабочая система: она сама выполняет задачи, отслеживает процессы и принимает решения в рамках заданных вами правил.

Почему это не просто ChatGPT?

Многие думают: «Зачем Neiron, если есть Claude или ChatGPT?»

Представьте автомобиль:

Claude в обычном чате:

Агент Neiron умеет всё это и ещё больше.

Главная идея: самообучающаяся компания

Цель Neiron — не «сделать ваших людей на 20% продуктивнее», а перестроить компанию в интеллектуальную систему, где рутина замкнута на ИИ и постоянно сама себя улучшает.

Было:  Вы → ставите задачи → люди  → делают вручную → вы проверяете
Стало: Вы → ставите правила → агенты → делают 24/7   → вы смотрите сводку

Три этапа, через которые проходит каждый клиент:

  1. Агенты помогают людям — каждый сотрудник получает AI-помощника, который ускоряет его работу в разы.
  2. Агенты заменяют рутину — процессы замыкаются в автоматические циклы, люди только подправляют.
  3. Автономная работа — основные бизнес-процессы крутятся без вмешательства; люди занимаются стратегией, продуктом и отношениями.

Из чего состоит система

┌─────────────────────────────────────────────────────┐
│                         ВЫ                          │
│         (Telegram, веб-чат, дашборд компании)       │
└────────────────────┬────────────────────────────────┘
                     │
┌────────────────────▼────────────────────────────────┐
│                  ГЛАВНЫЙ АГЕНТ                      │
│          (оркестратор, ваша точка входа)            │
└──────┬───────────┬───────────────┬──────────────────┘
       │           │               │
┌──────▼──┐  ┌─────▼─────┐  ┌──────▼─────┐
│ Агент   │  │  Агент    │  │   Агент    │
│закупок  │  │маркетинга │  │ аналитики  │  ...
└──────┬──┘  └─────┬─────┘  └──────┬─────┘
       │           │               │
┌──────▼───────────▼───────────────▼──────────────────┐
│                   ДВИЖОК NEIRON                     │
│  (расписания, коннекторы, навыки, память, права)    │
└──────┬───────────┬───────────────┬──────────────────┘
       │           │               │
┌──────▼──┐  ┌─────▼─────┐  ┌──────▼─────┐
│   WB    │  │  1С/ERP   │  │  Telegram  │  ...
│ кабинет │  │   CRM     │  │   чаты     │
└─────────┘  └───────────┘  └────────────┘

Компоненты системы:

КомпонентЧто этоАналогия
LLM (модель)Claude, GPT и другие языковые моделиДвигатель
АгентПерсонаж с ролью, памятью и навыкамиСотрудник
ДвижокОркестрация, права, расписанияМашина
НавыкЗафиксированный способ делать задачуИнструкция в должностном регламенте
КоннекторПодключение к внешней системеИнтеграция
ПамятьФайлы с историей и знаниями агентаБлокнот сотрудника
ДашбордРазделы компании со страницами: цифры, таблицы, задачи — агенты собирают и обновляют их по вашей просьбеПульт управления

Что агенты умеют делать

Ниже — типовые задачи. Больше всего примеров из работы на маркетплейсах, но так же агенты ведут и другие процессы компании: продажи, финансы, документы, поддержку клиентов.

Аналитика и контроль:

Ценообразование:

Закупки и логистика:

Реклама и акции:

Контент-завод:

HR и коммуникации:

Служебные задачи:


Подключение ИИ: подписка или API-токены

Раздел: Документация Neiron. Обновлено: 01.10.2026, версия 3. Адрес для людей: https://neiron.org/docs/podklyuchenie-ii/

Зачем это нужно

Агенты Neiron думают с помощью языковой модели (LLM): Claude от Anthropic, GPT от OpenAI, DeepSeek или любая из 400+ моделей через OpenRouter. Пока модель не подключена, агенты не работают. Поэтому это первый шаг после входа в админ-панель.

Модель вы оплачиваете провайдеру сами, напрямую. Деньги за ИИ через Neiron не проходят.

Подписка или API-токены

ПодпискаAPI-токены
Что этоТариф Claude или ChatGPT — тот же, что для обычного чатаКлюч API провайдера: Claude, ChatGPT, DeepSeek или OpenRouter. Оплата за каждый запрос
Как платитеФиксированная сумма раз в месяцПополняете баланс у провайдера, расход списывается по факту
ОграниченияЛимиты на сессию (несколько часов) и на неделюТолько баланс и лимит, который вы сами поставили на ключ
Когда выбиратьОсновной вариант для агентов: расходы предсказуемыНужны модели, которых нет в подписке; недорогая модель для простых задач; расшифровка голосовых

С чего начать: подписка Claude Max 20x ($200 в месяц). Если агентов мало и задачи простые, хватит Max 5x ($100). ChatGPT хорошо работает с картинками и презентациями, и его проще оплатить, если с Claude не получилось.

Совет. Если вы сами активно пользуетесь Claude или ChatGPT, заведите для агентов отдельную подписку. Иначе вы с агентами делите одни лимиты, и в самый нужный момент их не хватит.

Какие модели можно подключить по API-токенам

По API-ключу модель подключается двумя способами: напрямую у разработчика модели или через OpenRouter, где по одному ключу доступны сразу сотни моделей.

ПровайдерЧто даётГде взять ключ
Claude (Anthropic)Модели Claude напрямуюClaude Console → Settings → API keys. Ключ начинается с sk-ant-
ChatGPT (OpenAI)Модели GPT напрямую и расшифровка голосовыхplatform.openai.com/api-keys. Ключ начинается с sk-
DeepSeekМодели DeepSeek напрямую, обычно дешевле Claude и GPTplatform.deepseek.com → API keys. Ключ начинается с sk-
OpenRouter400+ моделей по одному ключу и с одного баланса: Claude, GPT, Gemini, DeepSeek, Qwen, Kimi, GLM, Llama и другиеopenrouter.ai/settings/keys. Ключ начинается с sk-or-v1-

Пошагово для OpenRouter — на странице Как подключить OpenRouter.

Что важно знать про API-ключи:

Важно. Anthropic и OpenAI не работают с Россией: Россия не входит в список стран, где доступен их API, а российские карты они не принимают. OpenRouter принимает зарубежные карты, AliPay и криптовалюту USDC. Российские карты, как правило, не проходят и там.

Где подключается

Всё подключается в админ-панели:

  1. Нажмите на шестерёнку в правом верхнем углу — откроется окно настроек.
  2. Первая вкладка — подписки. Кнопки «Авторизоваться через Claude» и «Авторизоваться через ChatGPT».
  3. Вторая вкладка — API-ключи. Сюда вставляется ключ Claude, OpenAI, DeepSeek или OpenRouter.

При первом входе в админ-панель кнопка подключения подписки есть и в центре экрана.

Пошагово, с регистрацией и оплатой, — на страницах Как подключить подписку Claude, Как подключить подписку ChatGPT и Как подключить OpenRouter.

Несколько подписок

Какую модель использует агент

Модель выбирается для каждого агента отдельно: админ-панель → агент в списке слева → раздел «Модель и размышление».

  1. Выберите провайдера: Claude, OpenAI, DeepSeek или OpenRouter.
  2. В поле «LLM модель» выберите модель из подсказки. Для OpenRouter впишите ID модели целиком, вместе с названием компании, например moonshotai/kimi-k3.
  3. Нажмите «Сохранить настройки».

Диалог при смене модели не теряется.

Как выбирать:

Примечание. Не каждая модель справится с работой агента. Агент не просто пишет текст: он читает файлы, запускает навыки, работает с таблицами и сервисами. Для этого модель должна уметь вызывать инструменты (tools). Лучше всего это получается у Claude и GPT, их мы и рекомендуем как основные. Другую модель сначала проверьте на одном второстепенном агенте и только потом переводите на неё важную работу.

Как следить за расходом

Больше всего лимитов съедают задачи по расписанию, которые часто запускают модель. Задача раз в 2 минуты, которой нужна модель, выберет лимит быстрее всех. Такие задачи делайте скриптами без ИИ или запускайте реже — см. Задачи по расписанию.

В Дашборде в блоке Расход токенов по агентам можно отслеживать сколько токенов расходует каждый агент за выбранный интервал времени. Поле стоимость показывает сколько стоят израсходованные токены. Но если вы работаете на подписке, то вы за них не платите, это справочная информация сколько вы заплатили бы, если бы работали через API токены.

Голосовые сообщения: нужен ключ OpenAI API

Голосовые расшифровывает модель OpenAI по API. Подписка ChatGPT для этого не подходит — это разные вещи. Без ключа агент попросит написать текстом.

Коротко: карта и баланс на platform.openai.com (от $5, хватает примерно на 14 часов записи) → Settings → API keys → Create new secret key → ключ в админ-панель: шестерёнка → вкладка «API-ключи». Пошагово, с картой, VPN, лимитом расхода и проверкой — на странице Распознавание голосовых сообщений.

Если агенты перестали отвечать

Что видитеЧто делать
Агент пишет про лимиты или не отвечает до конца дняКончился лимит сессии или недели. Подождите сброса, подключите ещё одну подписку или переключите агента на другую модель
Ошибка авторизации, просьба переподключить подпискуШестерёнка → «Удалить» рядом с подпиской → «Авторизоваться» заново
Подписка ChatGPT регулярно слетаетЭтим же аккаунтом входят где-то ещё, например в Codex или другой программе, и вход в Neiron сбрасывается. Заведите для Neiron отдельный аккаунт и переподключите подписку
Ошибка про оплату или баланс, например 402 Payment RequiredНа API-ключе кончились деньги или сработал лимит ключа. Пополните баланс у провайдера или поднимите лимит
Ошибка ключа, например 401 или Invalid API keyКлюч удалён, перевыпущен или скопирован не полностью. Создайте новый и вставьте его в админ-панель заново
Голосовые не расшифровываютсяНет ключа OpenAI API или на нём кончился баланс — см. Распознавание голосовых сообщений

Полный список ошибок с их текстами и способами исправления — на странице Ошибки и как их исправить.

Подразделы


Как подключить подписку Claude

Раздел: Подключение ИИ: подписка или API-токены. Обновлено: 07.10.2026, версия 2. Адрес для людей: https://neiron.org/docs/podpiska-claude/

Claude не принимает оплату российскими картами и не работает с российских адресов. Ниже — порядок, который проходили наши клиенты: зарубежная карта, VPN, регистрация, оплата тарифа Max и подключение подписки в Neiron.

1. Оформите зарубежную банковскую карту

Для оплаты Claude нужна зарубежная банковская карта.

Один из вариантов — виртуальная карта сервиса «Плати по миру»:

  1. Зарегистрируйтесь в сервисе.
  2. Выберите тариф. Лучше карту для путешествий или максимальный тариф с повышенными лимитами.
  3. Оплатите выпуск карты.
  4. Пополните её рублями через СБП с карты российского банка.
  5. Внесите сумму с запасом на конвертацию валюты и комиссии.

2. Подготовьте аккаунт Google

Можно использовать существующий аккаунт Google или завести новый:

  1. Создайте Google-аккаунт.
  2. Привяжите к нему номер телефона, если Google попросит подтверждение.
  3. Сохраните логин и пароль.

3. Включите VPN

Перед входом на сайт Claude обязательно включите VPN:

  1. Выберите стабильный сервер в стране, где официально работает Claude, например в Нидерландах или Германии.
  2. Проверьте, какую страну показывает ваш IP-адрес, например на 2ip.io.
  3. Не меняйте сервер и страну VPN во время регистрации, оформления подписки и подтверждения оплаты.
  4. Дальше для входа в Claude желательно использовать ту же страну VPN.

Например, если подключён сервер в Нидерландах, сайт должен определять ваше местоположение как Нидерланды.

Проверенные VPN: @LagomVPN_bot, @SarafanVPN_bot.

Важно. VPN должен быть включён до открытия Claude, а не после начала регистрации.

Совет. Вместо VPN можно подключить компьютер к прокси Neiron. Тогда Claude видит один и тот же IP-адрес и у агентов, и у вас, и риск блокировки аккаунта ниже. Как настроить — на странице Один IP с Neiron: прокси для Claude и ChatGPT. Страну для платёжного адреса (шаг 4) тогда смотрите на 2ip.io с включённым прокси.

4. Подготовьте платёжные данные

Адрес в платёжных данных должен совпадать со страной, через которую работает VPN. Чтобы его составить, откройте ChatGPT или Gemini и попросите:

«Сформируй адрес для заполнения платёжной формы в [страна]»

Вместо [страна] впишите страну VPN.

5. Зарегистрируйтесь в Claude

  1. С включённым VPN откройте claude.ai.
  2. Нажмите регистрацию или вход через Google.
  3. Выберите подготовленный Google-аккаунт.
  4. Завершите создание аккаунта Claude.

6. Выберите тариф

  1. Откройте Settings → Billing.
  2. Нажмите Upgrade to Max.
  3. Выберите тариф:
    • Max 5x — $100 в месяц;
    • Max 20x — $200 в месяц.

Если агенты будут работать постоянно и интенсивно, выбирайте Max 20x.

7. Заполните платёжные данные

Введите:

Страна VPN, страна карты и платёжный профиль по возможности должны совпадать.

8. Оплатите подписку

  1. Ещё раз убедитесь, что VPN включён и страна не изменилась.
  2. Проверьте реквизиты карты и платёжный адрес.
  3. Нажмите кнопку оплаты.

Оплата может пройти сразу, или сервис попросит подтвердить личность.

9. Пройдите проверку личности

Если после оплаты появилась ссылка на сервис проверки:

  1. Откройте её, не отключая и не меняя VPN.
  2. Страной проживания укажите страну VPN.
  3. Тип документа — Passport.
  4. Страну документа укажите по загранпаспорту. Для российского загранпаспорта это Russia, даже если VPN подключён к Нидерландам.
  5. Сфотографируйте разворот загранпаспорта.
  6. Сделайте селфи по инструкции.
  7. Дождитесь окончания проверки.

После успешной проверки платёж пройдёт, и подписка включится.

10. Подключите подписку в Neiron

  1. Войдите в админ-панель под логином и паролем, которые вам выдала команда Neiron.
  2. Нажмите на шестерёнку в правом верхнем углу. На первой вкладке нажмите «Авторизоваться через Claude».
  3. Откроется вкладка Claude. Войдите в тот же аккаунт с тем же VPN (или с включённым прокси Neiron) и подтвердите доступ.
  4. Claude покажет код авторизации — скопируйте его. Если вместо кода откроется страница с адресом, который начинается на localhost, скопируйте весь адрес из адресной строки.
  5. Вернитесь в админ-панель, вставьте код в поле кода авторизации и сохраните.

Подписка появится в списке. Теперь можно создавать агентов.

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

Проверьте:

Не повторяйте отклонённый платёж много раз подряд. Сначала узнайте причину отказа в поддержке сервиса, который выпустил карту.

Если агенты перестали работать с Claude

Иногда Claude сбрасывает авторизацию, и подписку нужно подключить заново:

  1. Админ-панель → шестерёнка.
  2. Нажмите «Удалить» рядом с подпиской Claude.
  3. Снова нажмите «Авторизоваться через Claude» и повторите шаги 3–5 из раздела 10.

Если агенты пишут про лимиты, подписка на месте, просто кончился лимит сессии или недели. Что с этим делать — на странице Подключение ИИ.


Как подключить подписку ChatGPT

Раздел: Подключение ИИ: подписка или API-токены. Обновлено: 07.10.2026, версия 3. Адрес для людей: https://neiron.org/docs/podpiska-chatgpt/

Вместо Claude или вместе с ним агентам можно подключить подписку ChatGPT. В админ-панели это подключение называется Codex — это та же подписка ChatGPT, отдельно Codex покупать не нужно.

Когда подходит ChatGPT:

1. Оформите подписку ChatGPT

  1. Зарегистрируйтесь на chatgpt.com или войдите в свой аккаунт. Для агентов лучше завести отдельный аккаунт, см. раздел «Важно» ниже.
  2. Откройте профиль → тарифы (chatgpt.com/#pricing) и выберите платный тариф. Чем выше тариф, тем больше лимитов у агентов.
  3. Оплатите зарубежной картой. Карта, VPN и платёжный адрес готовятся так же, как для Claude: шаги 1–4 на странице Как подключить подписку Claude.

2. Подключите подписку в Neiron

  1. Войдите в админ-панель.
  2. Нажмите на шестерёнку в правом верхнем углу. На первой вкладке нажмите «Авторизоваться через ChatGPT».
  3. Откроется вкладка OpenAI. Войдите в аккаунт, где оформлена подписка, и подтвердите доступ.
  4. Скопируйте код авторизации. Если вместо кода откроется страница с адресом, который начинается на localhost, скопируйте весь адрес из адресной строки.
  5. Вернитесь в админ-панель, вставьте код в поле кода авторизации и сохраните.

3. Переключите агентов на ChatGPT

Подписка сама по себе агентов не переключает. Для каждого агента, который должен работать на ChatGPT:

  1. Админ-панель → агент в списке слева → раздел «Модель и размышление».
  2. Сначала поменяйте провайдера на OpenAI, потом выберите модель в поле «LLM модель».
  3. Нажмите «Сохранить настройки».

Диалог с агентом при этом не теряется. Можно держать часть агентов на Claude, часть — на ChatGPT.

Важно


Один IP с Neiron: прокси для Claude и ChatGPT

Раздел: Подключение ИИ: подписка или API-токены. Обновлено: 07.10.2026, версия 2. Адрес для людей: https://neiron.org/docs/odin-ip-s-neiron-proksi-dlya-claude-i-chatgpt/

Claude и ChatGPT видят, с какого IP-адреса заходят в аккаунт. Агенты Neiron работают с вашей подпиской с IP-адреса Neiron, а вы заходите в тот же аккаунт со своего компьютера — из дома, из офиса, через VPN. Если один аккаунт постоянно используется с разных адресов и из разных стран, сервис может счесть это подозрительным и заблокировать аккаунт.

Чтобы снизить этот риск, подключите свой компьютер к тому же прокси, через который работает ваш Neiron. Тогда Claude и ChatGPT видят один и тот же IP-адрес — и у агентов, и у вас.

Особенно это важно, когда вы:

Что понадобится

Важно. Данные прокси — это доступ к IP-адресу вашей компании в Neiron. Не пересылайте их другим людям, не публикуйте и не присылайте агенту в чат.

1. Установите Clash Verge Rev

  1. Откройте страницу релизов программы: github.com/clash-verge-rev/clash-verge-rev/releases.
  2. В последней версии откройте список файлов (Assets) и скачайте установщик:
    • Windows — файл, который заканчивается на x64-setup.exe. Подходит для большинства компьютеров;
    • Mac с чипом Apple M1–M4 — файл на aarch64.dmg;
    • Mac с процессором Intel — файл на x64.dmg.
  3. Установите программу и запустите её.

Какой у Mac процессор, видно в меню Apple (значок яблока в левом верхнем углу) → «Об этом Mac»: «Чип Apple M…» или «Процессор Intel».

Если программа открылась на английском: Settings → Language → Русский.

2. Создайте профиль Neiron

Профиль — это файл настроек, в котором записано, через какой прокси работать.

  1. Откройте раздел «Профили» и нажмите «Новый».
  2. Тип — «Локальный», название — Neiron. Файл не выбирайте. Нажмите «Сохранить».
  3. Нажмите правой кнопкой на карточку профиля Neiron → «Изменить файл».
  4. Удалите весь текст в окне и вставьте текст ниже.
  5. Замените PORT, USERNAME и PASSWORD на порт, логин и пароль от поддержки. Кавычки оставьте: должно получиться, например, port: '12345'.
  6. Нажмите «Сохранить».
  7. Нажмите на карточку профиля Neiron (или правой кнопкой → «Выбрать»), чтобы сделать его активным.
# Профиль Neiron для Clash Verge Rev
mixed-port: 7897
allow-lan: false
mode: rule
log-level: info

proxies:
  - name: Decodo-HTTP
    type: http
    server: isp.decodo.com
    port: PORT
    username: 'USERNAME'
    password: 'PASSWORD'

proxy-groups:
  - name: PROXY
    type: select
    proxies:
      - Decodo-HTTP

rules:
  - MATCH,PROXY

Совет. Если поддержка прислала готовый файл профиля (.yaml), профиль создавать не нужно: перетащите файл в окно раздела «Профили» и выберите появившийся профиль. Проверьте через «Изменить файл», что вместо PORT, USERNAME и PASSWORD стоят настоящие данные.

3. Проверьте режим работы

  1. Откройте раздел «Прокси» и выберите режим «Правила».
  2. В группе PROXY должен быть выбран Decodo-HTTP.

Профиль Neiron направляет через прокси весь трафик компьютера, пока Clash включён.

4. Включите прокси и проверьте IP

  1. Если у вас включён VPN — выключите его. VPN и Clash одновременно мешают друг другу.
  2. На главной странице Clash Verge или в разделе «Настройки» включите «Системный прокси». «Режим TUN» пока не трогайте.
  3. Откройте в браузере 2ip.io. Сайт должен показать IP-адрес прокси, а не ваш обычный. Чтобы сравнить, выключите «Системный прокси», обновите страницу и включите его снова.
  4. Если хотите убедиться, что это именно IP вашего Neiron, спросите поддержку.

Теперь браузер работает через IP Neiron: можно открывать claude.ai и chatgpt.com.

5. Включите режим TUN для приложений

Браузер использует системный прокси, а приложения Claude и ChatGPT для компьютера, Claude Code и другие программы могут его не замечать. Чтобы через прокси шли и они, включите режим TUN — Clash будет перехватывать трафик всех программ.

  1. На главной странице или в разделе «Настройки» включите «Режим TUN».
  2. Если программа попросит установить службу, нажмите «Установить службу» и подтвердите запрос администратора. На Mac может понадобиться пароль от компьютера.
  3. После установки службы снова включите «Режим TUN» и проверьте приложения.

Через этот прокси могут не работать звонки, игры и другие функции, которым нужен протокол UDP. Режим TUN это не исправляет.

Как пользоваться каждый день

Если не работает

Если после включения пропал интернет, сначала выключите «Режим TUN» и «Системный прокси». Потом проверяйте по шагам: сначала только «Системный прокси», TUN выключен.

Что видитеЧто сделать
Ошибка 407Неверный логин или пароль. Откройте «Изменить файл» и проверьте, что USERNAME и PASSWORD заменены на данные от поддержки, а кавычки на месте
Timeout при проверке задержкиОткройте любой сайт. Если открывается — не прошла только проверка задержки, это не мешает работе. Если не открывается — посмотрите ошибку в разделе «Логи»
Could not resolve proxyПроверьте, что в профиле указан адрес isp.decodo.com, и что интернет работает с выключенным прокси
Профиль не сохраняется или не выбираетсяСкорее всего, сбились отступы. Удалите текст и вставьте его заново целиком, как на этой странице
Браузер работает, а с «Режимом TUN» интернет пропадаетПрокси в порядке, дело в службе. Посмотрите ошибки в разделе «Логи»

Не получилось — напишите в общий чат с командой Neiron, что видите на экране, и приложите снимок раздела «Логи».


Как подключить OpenRouter

Раздел: Подключение ИИ: подписка или API-токены. Обновлено: 28.09.2026, версия 1. Адрес для людей: https://neiron.org/docs/openrouter/

OpenRouter — сервис-посредник между вами и разработчиками моделей. Один аккаунт, один баланс и один API-ключ дают доступ к 400+ моделям разных компаний: Claude, GPT, Gemini, DeepSeek, Qwen, Kimi, GLM, Llama и другим. Модель у агента меняется одной строкой в настройках, без новых регистраций и оплат.

Когда подходит:

Понадобится: почта, способ оплаты (зарубежная карта, AliPay или криптовалюта USDC) и 15 минут.

Шаг 1. Зарегистрируйтесь

  1. Откройте openrouter.ai.
  2. Нажмите «Sign in» в правом верхнем углу и создайте аккаунт.

Шаг 2. Пополните баланс

  1. Откройте openrouter.ai/settings/credits.
  2. Нажмите кнопку пополнения («Add Credits») и введите сумму. Одно пополнение — от $5. Для начала хватит $10–20.
  3. Выберите способ оплаты:
    • банковская карта или AliPay — комиссия 5,5 %, минимум $0,80;
    • криптовалюта USDC — комиссия 5 %.

Карты российских банков, как правило, не проходят.

Что важно знать про оплату:

Совет. Если за всё время вы пополнили баланс на $10 и больше, у бесплатных моделей вырастет лимит: 1000 запросов в день вместо 50.

Шаг 3. Создайте API-ключ

  1. Откройте openrouter.ai/settings/keys.
  2. Нажмите «Create Key».
  3. Введите понятное название, например neiron.
  4. Поставьте лимит расхода на ключ, например $20. Лимит бывает разовым или обновляется раз в день, неделю или месяц. Если агент зациклится или ключ утечёт, больше лимита с ним не потратят.
  5. Скопируйте ключ — строку вида sk-or-v1-…. Целиком он показывается только один раз. Не успели скопировать — удалите ключ и создайте новый.

Важно. Не отправляйте ключ агенту в чат, в Telegram или по почте. Он вставляется только в админ-панель. Если ключ мог утечь, удалите его на openrouter.ai/settings/keys и создайте новый.

Шаг 4. Добавьте ключ в Neiron

  1. Откройте админ-панель и нажмите на шестерёнку в правом верхнем углу.
  2. Перейдите на вторую вкладку — API-ключи.
  3. Выберите OpenRouter, вставьте ключ и сохраните.

Шаг 5. Выберите модель

  1. Откройте каталог моделей: openrouter.ai/models.
  2. Оставьте только модели, которые умеют работать с инструментами. Эта ссылка сразу включает нужный фильтр: модели с поддержкой tools. Модель без инструментов может переписываться, но не сможет читать файлы, запускать навыки и работать с сервисами. Для агента она бесполезна.
  3. Откройте страницу модели. Там указаны:
    • ID модели вида компания/модель, например moonshotai/kimi-k3. Его нужно скопировать;
    • цена за 1 млн токенов — отдельно за вход (что модель читает) и за выход (что пишет);
    • контекст — сколько текста модель удерживает за один раз.

Модели с пометкой :free бесплатные, но с лимитом: 20 запросов в минуту и 50 в день, после пополнения на $10 — 1000 в день. На одну задачу агент делает несколько запросов, поэтому бесплатных моделей хватит только на то, чтобы попробовать.

Шаг 6. Переключите агента на модель

  1. Админ-панель → агент в списке слева → раздел «Модель и размышление».
  2. Провайдер — OpenRouter.
  3. В поле «LLM модель» вставьте ID модели целиком, вместе с названием компании: moonshotai/kimi-k3, а не kimi-k3.
  4. Нажмите «Сохранить настройки». Диалог с агентом при этом не теряется.
  5. Проверьте работу: дайте агенту задачу с действием, например «прочитай свою память и перескажи её в трёх пунктах». Если агент справился, через пару минут запрос появится на странице openrouter.ai/activity.

Сколько это стоит

Совет. Начните с одного второстепенного агента и лимита $10–20 на ключе. Через пару дней посмотрите расход в Activity и решите, переводить ли на эту модель других агентов.

Какую модель выбрать

Если не работает

Что видитеЧто делать
Ошибка 402 Payment Required или про балансБаланс ушёл в ноль или в минус, либо ключ упёрся в свой лимит. Пополните баланс или поднимите лимит ключа на openrouter.ai/settings/keys
Ошибка 401 или «неверный ключ»Ключ удалён или скопирован не полностью. Создайте новый и вставьте его в админ-панель заново
Модель не найденаВ ID опечатка или нет названия компании. Скопируйте ID со страницы модели целиком
Агент отвечает, но ничего не делает: не читает файлы, не запускает навыкиМодель не поддерживает инструменты. Выберите модель по фильтру tools (шаг 5)
Бесплатная модель перестала отвечать к середине дняКончился дневной лимит бесплатных запросов. Подождите до завтра или переключите агента на платную модель
Модель недоступна в вашем регионеНекоторые разработчики закрывают свои модели для отдельных стран. Выберите другую модель

Распознавание голосовых сообщений

Раздел: Подключение ИИ: подписка или API-токены. Обновлено: 01.10.2026, версия 1. Адрес для людей: https://neiron.org/docs/raspoznavanie-golosovykh-soobshcheniy/

Агенту можно отправлять голосовые сообщения: в Telegram и в веб-чате. Расшифровывает их модель распознавания речи OpenAI (Whisper) по API. Чтобы это заработало, в настройках компании должен быть ключ OpenAI API с балансом. Без ключа агент попросит написать текстом.

Примечание. Подписка ChatGPT (Plus, Pro, Team) для расшифровки не подходит. Подписка и API у OpenAI оплачиваются отдельно: подписка не даёт API-ключа и не включает API-баланс. Для голосовых нужен именно ключ API и пополненный баланс, минимум $5.

Что понадобится

Важно. OpenAI предупреждает, что доступ из страны вне списка может привести к блокировке аккаунта, а карту банка из такой страны платёж не пройдёт. Поэтому VPN, карта и платёжный адрес должны быть из поддерживаемых стран.

1. Войдите на платформу OpenAI

  1. Включите VPN и проверьте, какую страну показывает ваш IP-адрес, например на 2ip.io.
  2. Откройте platform.openai.com. Это кабинет для разработчиков: отдельный сайт, но логин и пароль те же, что в ChatGPT. Войдите или зарегистрируйтесь, можно через Google.
  3. При первом входе OpenAI может спросить название организации. Впишите название компании или своё имя — на работу это не влияет.

2. Привяжите карту и пополните баланс

  1. Нажмите на шестерёнку (Settings) в правом верхнем углу и откройте Organization → Billing.
  2. Нажмите Add payment details. Введите номер карты, срок действия, CVV, имя и фамилию латиницей, страну и адрес — те же, что подготовили для VPN, и почтовый индекс.
  3. Выберите сумму первого пополнения. Минимум $5, по умолчанию предлагается $10. Для голосовых этого хватит надолго, см. раздел «Сколько это стоит».
  4. Проверьте переключатель Use auto-reload (автопополнение). При настройке он включён по умолчанию. Рекомендуем выключить его, пока не увидите реальный расход. Позже автопополнение можно включить: задать порог баланса, сумму пополнения и месячный лимит.
  5. Подтвердите покупку. Баланс появится в Billing → Overview в поле Credit balance.

Купленные кредиты действуют 1 год и не возвращаются. Когда баланс кончается, расшифровка останавливается, пока вы не пополните его снова.

3. Ограничьте расход

Чтобы расход не вышел из-под контроля, поставьте месячный лимит: Settings → Organization → Limits → Edit spend limit. Впишите сумму, например $20, и включите Enforce a hard limit — при достижении лимита запросы остановятся до начала следующего месяца. Там же можно задать порог для уведомления на почту.

4. Создайте API-ключ

  1. Откройте platform.openai.com/api-keys (Settings → API keys).
  2. Нажмите + Create new secret key.
  3. Дайте ключу имя, например Neiron, проект оставьте Default project, права — All. Нажмите Create secret key.
  4. При создании первого ключа OpenAI просит подтвердить номер телефона кодом из SMS. Если ваш номер не принимается, используйте номер из страны, где OpenAI работает.
  5. Ключ вида sk-… показывается один раз. Сразу скопируйте его и переходите к следующему шагу. Если ключ потерялся, создайте новый, а старый удалите.

5. Вставьте ключ в Neiron

  1. Войдите в админ-панель.
  2. Нажмите на шестерёнку в правом верхнем углу — откроется окно настроек компании.
  3. Перейдите на вкладку «API-ключи» (вторая вкладка).
  4. Вставьте ключ в поле OpenAI и сохраните.

Осторожно. Не присылайте ключ агенту в чат и не пишите его в переписках: модель видит всё, что написано в диалоге. Ключ вставляется только в админ-панели. Подробнее — в главе Безопасность.

Этот же ключ платформа использует, если какой-то агент работает на моделях GPT по API-ключу: расход идёт с того же баланса. Как выбрать модель агенту — на странице Подключение ИИ.

6. Проверьте

Отправьте любому агенту голосовое сообщение в Telegram. Если агент ответил по содержанию сказанного, расшифровка работает. Включать её отдельно для каждого агента не нужно: ключ действует на всю компанию.

Сколько это стоит

Распознавание речи у OpenAI стоит $0,006 за минуту записи, то есть около полуцента за минуту. Баланса $5 хватает примерно на 14 часов голосовых. Например, 20 голосовых по минуте в день — это около $0,12 в день, или $3–4 в месяц. Расход виден в кабинете OpenAI: Settings → Organization → Usage.

Если не работает

Что видитеПричинаЧто делать
Агент просит написать текстомКлюч не добавлен или не сохранилсяПовторите шаг 5
Ошибка 401, Incorrect API key, Invalid AuthenticationКлюч скопирован не полностью, удалён или перевыпущенСоздайте новый ключ и вставьте его заново
Ошибка 402, credit_balance_exhausted, insufficient credits, billing_errorНа балансе OpenAI кончились деньгиПополните баланс: Billing → Buy credits
Organization spend limit reached, Project spend limit reachedСработал ваш лимит расхода из шага 3Поднимите лимит или дождитесь нового месяца
Расшифровка работала и пересталаЧаще всего кончился баланс или истёк срок кредитовПроверьте Credit balance в кабинете OpenAI

Тексты других ошибок и способы их исправить — на странице Ошибки и как их исправить.


Агенты и иерархия

Раздел: Документация Neiron. Обновлено: 28.09.2026, версия 2. Адрес для людей: https://neiron.org/docs/agenty-i-ierarkhiya/

Что такое агент?

Агент — это AI-сотрудник с:

В Telegram каждый агент — это отдельный бот, с которым вы общаетесь напрямую. В веб-чате агент работает и без Telegram-бота.

Все агенты создаются и настраиваются через админ-панель.

Роли агентов

У каждого агента есть роль, которая определяет его возможности.

Директор

Пример: главный агент компании — Директор. Он принимает ваши запросы и координирует всю работу.

Сотрудник (работник)

Примеры: агент-аналитик, агент-закупщик, агент-маркетолог, персональный агент сотрудника.

Публичный агент

Иерархия агентов: руководитель и подчинённый

Кроме роли, агенты различаются по положению в иерархии.

Руководитель

Агент, у которого есть подчинённые агенты. Руководитель:

Подчинённый

Агент, у которого есть руководитель. Подчинённый:

Главный агент (Директор + Руководитель)
 ├── Агент-закупщик (Сотрудник + Подчинённый)
 ├── Агент-маркетолог (Сотрудник + Руководитель)
 │     └── Специалист по рекламе (Сотрудник + Подчинённый)
 ├── Агент-ассистент (Сотрудник + Подчинённый)
 └── Публичный агент (Публичный + Подчинённый)

Примеры специализаций агентов-сотрудников

АгентЧто делает
АналитикОтчёты, динамика, аномалии, сравнения
ЗакупщикОстатки, заявки, поставщики, подсорт
МаркетологРеклама, акции, СПП, A/B-тесты
КонтентщикВидео, карточки, SEO, инфографика
Менеджер по клиентамОтзывы, вопросы, претензии
HR-агентСводки по команде, расшифровки, KPI
Персональный ассистентПомощник конкретного сотрудника

Как агент «знает» ваш бизнес?

При запуске агент получает:

  1. Системный промпт — его роль, правила, характер.
  2. Базу знаний компании — продукты, KPI, правила.
  3. Личную память — накопленную историю взаимодействий.
  4. Навыки — инструкции, как выполнять конкретные задачи.

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

Модель ИИ агента

Каждый агент работает на своей языковой модели (LLM), модель выбирается для каждого агента отдельно. Сначала подключите подписку или API-ключ — см. Подключение ИИ.

Принцип экономии: не всем задачам нужна дорогая модель.

Модель можно поменять в любой момент, диалог с агентом при этом не теряется.

Как создать агента

Агента создают в админ-панели. Можно попросить об этом команду Neiron: пришлите ей токен бота в личные сообщения.

Шаг 1. Создайте Telegram-бота

  1. Откройте в Telegram @BotFather и нажмите «Open» (или отправьте команду /newbot).
  2. Выберите «Create a new bot», задайте имя и username бота, например company_sales_bot.
  3. Скопируйте токен бота — строку вида 123456789:AAF....

Подробная инструкция — через мини-приложение или командами, настройки для групп, что делать с токеном — в разделе Каналы общения.

Если агент будет работать только в веб-чате, этот шаг можно пропустить.

Важно. Токен бота — это ключ доступа к боту. Не отправляйте его в группы.

Шаг 2. Добавьте агента в админ-панели

  1. Перейдите на app.neiron.org.
  2. Создайте нового агента.
  3. Вставьте токен Telegram-бота.
  4. Выберите языковую модель.
  5. Привяжите агента к нужным сотрудникам.
  6. Пропишите промпт: роль, правила, характер агента.

Шаг 3. Проверьте

Откройте бота в Telegram, нажмите «Старт» и напишите что-нибудь. Если агент молчит, проверьте, что подписка ИИ подключена и у агента выбрана модель.

Настройки агента в админ-панели

Откройте админ-панель и нажмите на агента в списке слева.

НастройкаГде найтиЧто делает
ТипПереключатель справа от имени агентаРоль агента: директор, сотрудник или публичный
ПромптНастройки агентаРоль, правила, характер: кто он и как работает
Telegram-ботНастройки агента → «Telegram бот»Токен бота и его @username. Бота можно заменить — агент и его память останутся
МодельРаздел «Модель и размышление» → «LLM модель»Провайдер (Claude, OpenAI, DeepSeek или OpenRouter) и модель. Подробнее — Подключение ИИ
РазмышлениеРаздел «Модель и размышление»Насколько глубоко агент обдумывает задачу: глубже — точнее, но дольше и дороже
Лимит ходов на запускРаздел «Модель и размышление»Сколько шагов агент может сделать за один запуск
ЧатыВкладка «Связи» → «Telegram чаты»Групповые чаты, где работает агент
КоннекторыВкладка «Коннекторы» → «Персональные коннекторы»Подключения, выданные лично этому агенту
НавыкиНавыки агентаКакие навыки есть у агента. У навыка можно указать отдел

После изменений нажмите «Сохранить настройки».

Совет. Агент останавливается посреди длинной задачи? Увеличьте «Лимит ходов на запуск», например на 15, или разбейте задачу на части.

Отделы. Агентов можно объединять в отделы. От отдела зависит, какие навыки, подключения и подписка ИИ доступны агенту. Подробнее — в разделах Навыки и Подключение сервисов.

Как добавить агента в групповой чат

Шаг 1. Разрешите боту работать в группах

В @BotFather откройте своего бота → «Bot Settings»:

Шаг 2. Добавьте бота в чат

Добавьте бота в группу как обычного участника. Ищите его по @username — он указан в админ-панели в настройках агента, «Telegram бот». Система автоматически обнаружит новый чат.

Если бот не добавился автоматически

  1. Узнайте ID группы, например через бота @userinfobot: выберите в нём нужную группу.
  2. Админ-панель → агент → вкладка «Связи» → «Telegram чаты» → «+».
  3. Введите ID группы. Галочки настроек оставьте включёнными.

Память агентов

Раздел: Документация Neiron. Обновлено: 28.09.2026, версия 2. Адрес для людей: https://neiron.org/docs/pamyat-agentov/

Как агент запоминает

Агент не теряет контекст между разговорами — у него есть постоянная память в виде файлов.

Структура памяти

  1. Долгосрочная память агента (MEMORY.md). Отобранные ключевые факты, стратегические решения, выводы. Этот файл подгружается в каждый разговор агента. Здесь — суть, а не сырые логи.
  2. Ежедневные записи. Сырые заметки о том, что происходило за день. Со временем важное из них переносится в долгосрочную память.
  3. Данные о компании (общие для всех агентов). Общая база знаний компании: продукты, правила, KPI, стратегия. Доступна всем агентам компании.
  4. Память о сотруднике. На каждого сотрудника, с которым работает агент, ведётся отдельная папка:
    • MEMORY.md — долгосрочная память об этом сотруднике;
    • TASKS.md — его задачи;
    • PROFILE.md — профиль сотрудника (роль, ответственность, контакты);
    • PREFERENCES.md — предпочтения (стиль общения, форматы, приоритеты).

Даже если вы долго не общались с агентом, он помнит всё важное из прошлых разговоров.

Примечание. Если MEMORY.md слишком разрастается, его конец при загрузке обрезается. Поэтому в долгосрочной памяти держат только главное. Попросите агента время от времени сжимать память или поставьте сжатие на расписание, например раз в сутки ночью.

Что агент запоминает автоматически

Агент сам решает, что важно запомнить. Как правило, это:

Что вы можете попросить агента запомнить

Просто скажите прямо:

«Запомни: наш главный приоритет — маржинальность выше 25%»
«Запомни формат этого отчёта, используй его всегда»
«Запомни, что с поставщиком Ивановым связываемся только по почте»
«Сохрани контекст нашего сегодняшнего разговора»

Агент запишет это в файл памяти.

Как проверить, что агент помнит

«Что ты помнишь о наших договорённостях?»
«Напомни, какой формат отчётов мы используем»
«Что ты знаешь о поставщике ООО "Ткани"?»
«Покажи свою память о нашем бизнесе»

Память накапливается — и это ценность

С каждым днём агент знает ваш бизнес лучше:

Это накопленная экспертиза — и она принадлежит вам.

«Выгрузи всё»

Если вы хотите забрать накопленные знания агента (при смене системы или для архива):

«Выгрузи всё, что ты знаешь, в файл»
«Сделай экспорт всей памяти»

Агент отдаст вам файл со всеми накопленными знаниями. Это ваши данные — вы можете забрать их в любой момент.

Совет. Можно поставить автовыгрузку раз в неделю — на случай, если понадобится откатиться или что-то восстановить.

Файлы агента

Помимо памяти, у каждого агента есть файловая система. Три типа файлов:

Личные файлы агента

Документы, отчёты, черновики, результаты работы. Доступны только этому агенту и его руководителю.

Временные файлы (.tmp/)

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

Общие файлы компании

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

Изоляция памяти

Каждый агент помнит только то, что касается его работы. Память агента-закупщика не смешивается с памятью HR-агента. Память одного клиента Neiron не пересекается с памятью другого клиента.


Каналы общения

Раздел: Документация Neiron. Обновлено: 01.10.2026, версия 3. Адрес для людей: https://neiron.org/docs/kanaly-obshcheniya/

Где можно общаться с агентами

КаналДля чего удобенКак подключить
TelegramБыстрые запросы, групповые чаты, уведомленияУ каждого агента свой бот. Как его создать — ниже, как подключить к агенту — Агенты и иерархия
Веб-чатПроекты, файлы, таблицы, длинная работаchat.neiron.org, вход по email и паролю
WhatsAppПереписка с клиентами через ваш номерНомер подключается к агенту — напишите команде Neiron
Дашборд компанииЦифры и отчёты в браузере, кнопки «поручить агенту»См. Дашборд

Память агента общая для всех каналов, а история переписки у каждого чата своя. Важное просите «запомнить» — тогда агент будет знать это в любом канале.

Telegram: форматы общения

1. Личный чат с агентом

Вы пишете напрямую боту-агенту. Он видит только ваши сообщения и отвечает только вам.

Когда использовать: конфиденциальные запросы, личные задачи, настройка агента.

Пример:

Вы → @ваш_агент_bot:
«Покажи динамику продаж по артикулу 12345 за последние 30 дней»

2. Групповой чат (несколько агентов + сотрудники)

Все участники видят сообщения. К конкретному агенту обращайтесь через @упоминание или ответом на его сообщение.

Когда использовать: командные обсуждения, когда нужен ответ от нескольких агентов, совместная работа.

Пример:

Группа «Общий чат»:
Иван: «@ваш_агент_bot, нужна сводка по всем кабинетам»
Агент: «Собираю… [ответ]»

3. Топики (forum threads) в группах

Если группа настроена как форум, каждый топик — отдельная тема. Агент может отвечать в конкретном топике.

Когда использовать: когда хотите разделить обсуждения по темам (закупки / маркетинг / аналитика).

Как создать Telegram-бота через @BotFather

В Telegram каждый агент — отдельный бот. Бота создают в официальном боте Telegram — @BotFather. Это бесплатно и занимает 2–3 минуты. В итоге вы получите токен бота. Его вставляют в админ-панели при создании агента — см. Агенты и иерархия.

Создать бота можно двумя способами: кнопками в мини-приложении BotFather или командами в чате с ним. Результат одинаковый — выбирайте, как удобнее.

Важно. Настоящий @BotFather — с синей галочкой. Ищите его по точному имени @BotFather: у поддельных ботов похожие названия, и они крадут токены.

Перед началом: имя и username

ЧтоПримерПравила
Имя (name)Директор РомашкаЛюбое, на любом языке. Видно в списке чатов и в профиле бота. Можно поменять потом
Usernameromashka_ceo_bot5–32 символа: латиница, цифры и _. Обязательно заканчивается на bot. Должен быть свободен. Поменять потом нельзя

Совет. Называйте ботов по роли агента: romashka_ceo_bot, romashka_sales_bot, romashka_buh_bot. Так сотрудники не перепутают, кому писать.

Способ 1. Через мини-приложение BotFather

  1. Откройте в Telegram чат с @BotFather.
  2. Нажмите кнопку «Open» («Открыть») рядом с полем ввода сообщения. Откроется окно BotFather со списком ваших ботов. Открыть его можно и по ссылке t.me/botfather?startapp.
  3. Нажмите «Create a new bot».
  4. Введите имя бота и username и подтвердите создание.
  5. Откроется страница нового бота. Нажмите «Copy» рядом с токеном — токен скопируется.
  6. Вставьте токен в админ-панели при создании агента. Если агента создаёт команда Neiron — пришлите токен ей в личные сообщения.

На странице бота в мини-приложении можно сразу поставить аватар, описание и настройки для групп (см. ниже).

Примечание. Названия кнопок в мини-приложении зависят от языка Telegram и версии приложения. Если кнопки называются иначе, ищите по смыслу: «создать бота», «настройки бота», «скопировать».

Способ 2. Через команды в чате

  1. Откройте чат с @BotFather. Если открываете впервые, нажмите «Старт» (Start).
  2. Отправьте команду /newbot.
  3. BotFather попросит имя бота («Please choose a name for your bot»). Отправьте имя, например: Директор Ромашка.
  4. Затем он попросит username («Now let's choose a username for your bot. It must end in bot»). Отправьте username, например: romashka_ceo_bot. Если BotFather ответит, что username занят или не подходит, придумайте другой и отправьте снова.
  5. BotFather пришлёт сообщение «Done! Congratulations on your new bot» со ссылкой на бота. Токен стоит после строки «Use this token to access the HTTP API». Он выглядит так: 123456789:AAF... — цифры, двоеточие и длинная строка из букв и цифр. Нажмите на токен — он скопируется.
  6. Вставьте токен в админ-панели при создании агента или пришлите его команде Neiron в личные сообщения.

Передумали на любом шаге — отправьте /cancel.

Токен: как хранить и что делать, если он утёк

Важно. Один бот — один агент. Не подключайте тот же токен к другим сервисам (CRM, конструкторам ботов, чат-виджетам). Telegram отдаёт сообщения бота только одному получателю, и агент начнёт пропускать сообщения или замолчит совсем.

Настройки для групповых чатов

Нужны, только если агент будет работать в группах. Как добавить агента в группу — в разделе Агенты и иерархия.

Что сделатьВ мини-приложении или через /mybotsКомандой
Разрешить добавлять бота в группыБот → «Bot Settings» → «Groups and Channels» (чаты и каналы) → разрешить группы/setjoingroups → выберите бота → Enable
Выключить режим приватности, чтобы бот видел все сообщения группы, а не только команды и ответы емуБот → «Bot Settings» → «Group Privacy» → «Turn off»/setprivacy → выберите бота → Disable

Важно. Бот уже был в группе? После смены режима приватности удалите его из группы и добавьте заново. Иначе Telegram продолжит присылать ему только команды и ответы на его сообщения.

Бот, которого сделали администратором группы, получает все её сообщения при любом режиме приватности.

Оформление бота (по желанию)

ЧтоКомандаГде видно
Имя/setnameСписок чатов, профиль бота
Описание (до 512 символов)/setdescriptionПустой чат с ботом, блок «Что умеет этот бот?»
О боте (до 120 символов)/setabouttextПрофиль бота
Аватар/setuserpicСписок чатов, профиль бота
Меню команд/setcommandsКнопка «Меню» в чате с ботом

Всё это можно сделать и в мини-приложении на странице бота. Меню команд агенту не обязательно: он понимает обычный текст (см. раздел «Управление через текст» ниже).

Шпаргалка команд @BotFather

КомандаЧто делает
/newbotСоздать бота
/mybotsСписок ваших ботов и все их настройки кнопками: токен, настройки, передача, удаление
/setnameСменить имя бота
/setdescriptionОписание в пустом чате с ботом
/setabouttextТекст в профиле бота
/setuserpicАватар бота
/setcommandsМеню команд бота
/setjoingroupsРазрешить или запретить добавлять бота в группы
/setprivacyРежим приватности в группах
/deletebotУдалить бота навсегда. Username освободится, вернуть бота нельзя
/cancelОтменить текущую команду

Полный список команд — отправьте BotFather /help.

Передать бота другому владельцу

Бота создал сотрудник или команда Neiron, а владеть им должна компания? Бота можно передать:

  1. Новый владелец открывает @BotFather и нажимает «Старт».
  2. Нынешний владелец: @BotFather → /mybots → бот → «Transfer Ownership» → выбирает нового владельца и подтверждает облачным паролем Telegram.

Передача необратима: вернуть бота сможет только новый владелец. Для передачи у владельца должен быть включён облачный пароль (двухэтапная аутентификация). Если его включили недавно, Telegram может разрешить передачу только через несколько дней. После передачи напишите агенту и проверьте, что он отвечает.

Если что-то не получается

ПроблемаЧто сделать
BotFather пишет, что username занят или не подходитПридумайте другой: латиница, цифры и _, в конце bot
Бота нельзя добавить в группуРазрешите группы: /setjoingroups → Enable
В группе бот не видит обычные сообщения, только команды и ответы емуВыключите режим приватности (/setprivacy → Disable), удалите бота из группы и добавьте заново
Бот не пишет сотрудникуСотрудник должен один раз открыть бота и нажать «Старт»
BotFather не даёт создать ещё одного ботаУ Telegram есть лимит ботов на один аккаунт. Удалите ненужного (/deletebot) или создайте бота с другого аккаунта
Агент молчитПроверьте, что токен вставлен в настройках агента («Telegram бот») и подключена подписка ИИ. Токен перевыпускали — вставьте новый

Веб-чат

Веб-чат — работа с агентами в браузере: chat.neiron.org. Сотрудник входит по email и паролю и видит только тех агентов, которых ему назначил администратор.

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

WhatsApp

Агента можно подключить к номеру WhatsApp — например, чтобы публичный агент принимал заявки клиентов. Чтобы подключить номер, напишите команде Neiron.

Важно. Подключайте отдельный рабочий номер, а не личный. Мессенджер может ограничить номер, с которого приходит много автоматических ответов.

Дашборд

В дашборде компании агенты показывают цифры и отчёты. Под виджетами бывают кнопки, которые отправляют агенту готовое сообщение или ставят ему задачу. А законченную работу агент присылает карточкой результата: что сделано, что проверено. Подробнее — в разделе Дашборд.

Как правильно писать агенту

Будьте конкретны

ПлохоХорошо
«Как дела?»«Покажи топ-10 артикулов по выручке за апрель»
«Что-нибудь по остаткам»«Какие артикулы в красной зоне по остаткам на WB? Сколько дней осталось?»

Давайте контекст

«Акция на WB заканчивается послезавтра. Какие артикулы стоит повысить в цене и на сколько?»

Просите конкретный формат

«Дай сводку в виде таблицы: артикул, текущий остаток, рекомендация»

Уточняйте действие

Что написатьКогда
«Только проанализируй»Нужны данные, без действий
«Выполни»Агент должен что-то сделать: выгрузить файл, отправить заявку
«Предложи варианты»Нужна помощь с решением

Управление через текст

Агент понимает обычный язык, команды знать не нужно:

Что вы пишетеЧто делает агент
«Запомни, что наш приоритет — маржинальность, а не оборот»Записывает в память
«Каждый понедельник в 9:00 присылай мне сводку продаж»Создаёт задачу по расписанию
«Отправь это Ивану»Пересылает указанному сотруднику
«Сохрани это в базу знаний»Добавляет в wiki
«Научись делать X»Создаёт новый навык (только агент-директор)

Файлы и вложения

Через Telegram и веб-чат можно:

Пример:

Вы → [прикрепляете файл прайса поставщика]
«Сравни с нашими текущими ценами закупки и покажи, где можем сэкономить»

Голосовые сообщения

Агенту можно отправлять голосовые сообщения. Голосовые расшифровывает модель OpenAI по API, поэтому в настройках компании нужен ключ OpenAI API с балансом. Без ключа агент попросит написать текстом. Как выпустить ключ, привязать карту и вставить ключ в настройки компании — на странице Распознавание голосовых сообщений.

Вопросы с вариантами ответа

Если для задачи агенту не хватает вашего решения, в личном чате или в веб-чате он может задать до четырёх вопросов с готовыми вариантами ответа. Нажмите кнопку или напишите свой вариант — агент продолжит работу, когда получит все ответы.

Уведомления от агентов

Агенты могут сами вам писать, а не только отвечать:

Вы можете настроить, какие уведомления хотите получать и в каком чате.

Примечание. Бот в Telegram не может написать первым человеку, который ни разу не нажал у него «Старт». Попросите сотрудников один раз открыть бота и нажать «Старт» — иначе уведомления до них не дойдут.

Агенты в группах: правила хорошего тона

Когда агент находится в групповом чате с несколькими людьми:


Подключение сервисов

Раздел: Документация Neiron. Обновлено: 29.09.2026, версия 3. Адрес для людей: https://neiron.org/docs/podklyuchenie-servisov/

Что такое коннектор

Коннектор — это подключение агента к внешней системе. Через коннектор агент получает данные из сторонних сервисов и отправляет в них данные.

Без коннекторов агент работает только с тем, что вы ему говорите и что хранится в его памяти. С коннекторами он работает с реальными данными вашего бизнеса в реальном времени.

Что можно подключить

СистемаЧто агент может делать
Кабинет WildberriesСмотреть остатки, цены, рекламу; выгружать отчёты; менять цены (с подтверждением)
Кабинет OzonАналогично WB
1С / ERPПроверять остатки сырья и продукции, создавать заявки
Email (Gmail, Яндекс Почта, Mail)Отправлять письма поставщикам, получать ответы
Telegram APIАнализировать чаты, отправлять сообщения
Google ТаблицыЧитать и обновлять таблицы
CRM (Bitrix24, amoCRM)Работать с лидами, сделками, клиентами
Ваш сервер (SSH)Выполнять команды на сервере: проверить сервис, выгрузить данные
Любой REST APIЕсли у сервиса есть API — его можно подключить

Есть два способа подключить сервис. Если сервис есть в библиотеке админ-панели, подключите его там сами. Если его там нет, подключите через агента-директора: он создаст коннектор, а данные доступа вы впишете в админ-панели.

Способ 1. Сервис есть в библиотеке

  1. Откройте библиотеку в админ-панели и перейдите на вкладку «Коннекторы».
  2. Найдите сервис в списке и нажмите на него. Откроется окно с инструкцией: какие данные нужны и где их взять.
  3. Дальше один из двух вариантов:
    • Ключ или токен. Возьмите его в кабинете сервиса по инструкции, впишите в поля коннектора и сохраните.
    • Вход через аккаунт (например, сервисы Яндекса). Нажмите «Подключить» и войдите в свой аккаунт этого сервиса. Ключ вписывать не нужно.
  4. Выберите, кому доступно подключение: всей компании, отделу или конкретному агенту (см. ниже).

Ключ, вписанный в библиотеке, не проходит через переписку с агентом. Это самый безопасный способ.

Способ 2. Сервиса нет в библиотеке — через агента-директора

Шаг 1. Скажите агенту

«Хочу подключить нашу CRM, вот документация её API»
«Добавь интеграцию с 1С»

Если у сервиса есть документация API, сразу пришлите на неё ссылку: так агент быстрее разберётся.

Шаг 2. Агент создаёт коннектор

Агент изучит документацию сервиса и составит инструкцию: какие данные нужны для подключения (API-ключ или токен, адрес сервиса, логин технического пользователя) и где их взять. Затем создаст коннектор.

Шаг 3. Впишите данные в админ-панели

Откройте в админ-панели коннектор, который создал агент, нажмите на него и впишите данные по инструкции агента.

Важно. Данные доступа можно прислать и самому агенту, но мы так делать не советуем: пока сообщение лежит в переписке, его видит языковая модель. Если всё же присылаете, то только агенту-директору в личный чат, никогда в группу. Удалите сообщение сразу, как агент подтвердит, что сохранил данные.

Шаг 4. Агент проверяет подключение

Попросите агента проверить подключение: «Проверь подключение к CRM — покажи последние сделки». Он убедится, что получает данные, а если что-то не так, попросит проверить ключ.

Кто может создавать коннекторы: только агент с ролью Директор. Агенты-сотрудники пользуются уже настроенными подключениями, но не создают новые.

Кому доступно подключение

УровеньКто пользуетсяКак настроить
Вся компанияВсе агенты компании, кроме публичныхПо умолчанию
ОтделТолько агенты этого отдела, например почта отдела продажПри подключении выберите отдел
Конкретный агентТолько этот агентАдмин-панель → агент → вкладка «Коннекторы» → «Персональные коннекторы» → «+»

Публичный агент получает подключение только персонально: общие и отдельские ему не выдаются.

Одну систему можно подключить несколько раз с разными правами. Например, 1С «только чтение» для всех и 1С «с правом записи» для агента бухгалтерии.

То же можно попросить словами:

«Подключи почту Ивана и дай доступ только агенту продаж»

Программировать ничего не нужно

При подключении вашей компании основные системы вы подключаете вместе с менеджером Neiron:

  1. На созвоне вместе составляем список сервисов, с которыми вы работаете. Менеджер записывает его и отмечает, какие сервисы уже есть в библиотеке.
  2. На созвоне менеджер показывает, как подключить каждый сервис в админ-панели. Ключи вы вписываете сами, пересылать пароли никому не нужно.
  3. Сервисы, которых нет в библиотеке, подключаем через вашего агента-директора (способ 2).
  4. Готово — агент работает с системами.

Дальше новые подключения вы делаете сами — через библиотеку или агента-директора.

Несколько кабинетов — не проблема

Если у вас несколько кабинетов на WB/Ozon или несколько компаний — можно подключить все. Агент будет работать со всеми кабинетами и при необходимости сводить данные вместе:

«Покажи сравнение продаж между кабинетом 1 и кабинетом 2 за прошлую неделю»

Агент не хранит ваши пароли

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



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

Раздел: Документация Neiron. Обновлено: 28.09.2026, версия 2. Адрес для людей: https://neiron.org/docs/zadachi-po-raspisaniyu/

Что такое задача по расписанию

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

Это ключевой инструмент для построения «кругов» — самостоятельных бизнес-процессов, которые крутятся 24/7.

Примеры задач по расписанию

Что автоматизироватьРасписаниеЧто получаете
Утренняя сводка продажКаждый день в 9:00Сообщение в Telegram с ключевыми цифрами
Проверка остатковКаждый день в 06:00Уведомление, если кто-то в «красной зоне»
Еженедельный отчётКаждый понедельникПолный отчёт по неделе
Мониторинг цен конкурентовКаждые 4 часаУведомление при изменениях
Заявки поставщикамКаждый вторникАвтоматически сформированные заявки
Отчёт по командеКаждую пятницу в 17:00Сводка по активности сотрудников
Обработка базы знанийКаждую ночь в 02:00Новые материалы структурированы в wiki

Как создать задачу по расписанию

Просто напишите агенту обычным языком:

«Каждый день в 9:00 утра присылай мне сводку:
— топ-5 продаж вчера
— что в красной зоне по остаткам
— любые аномалии»

Агент сам создаст задачу с нужным расписанием.

Или укажите точнее:

«Каждый понедельник в 8:30 по московскому времени — еженедельный отчёт в нашу группу "Отчёты"»

Куда приходят уведомления

Уведомления можно направить:

Задачи без уведомлений

Не все задачи должны присылать сообщения. Иногда нужно просто выполнить действие фоном:

«Каждую ночь обновляй данные о ценах конкурентов в нашей базе знаний — результат не присылай, просто обновляй файл»

Агент выполнит задачу и ничего не пришлёт — только обновит данные.

Одноразовые отложенные задачи

Можно запланировать действие на конкретное время:

«Завтра в 15:00 напомни мне про созвон с поставщиком»
«В пятницу в 17:00 отправь Ивану итоги недели»
«Через 3 часа проверь, пришёл ли ответ от ООО "Ткани"»

После выполнения одноразовая задача автоматически отключается.

Как задачи по расписанию создают «круги»

«Круг» — это самостоятельный автоматический процесс без вашего участия.

Пример круга «Остатки → Закупка»:

06:00 — агент проверяет остатки (расписание)
   └─ если артикул < 20 дней → формирует заявку
   └─ отправляет заявку поставщику (автоматически)
   └─ записывает в базу данных (автоматически)
09:00 — агент присылает вам сводку с результатами
   └─ вы видите: «Отправлены заявки 3 поставщикам, ожидаем ответ»

Пример круга «Реклама → CTR → Контент»:

Каждые 4 часа — агент проверяет CTR карточек
   └─ если CTR упал → предлагает замену инфографики
   └─ если подтвердили → генерирует новую
   └─ заменяет в кабинете

Таких кругов в компании может быть 5–6 одновременно. Каждый работает сам.

Управление задачами через агента

Что сделатьКак попросить
Создать«Каждый день в 9:00 присылай сводку»
Изменить время«Перенеси утренний отчёт на 8:00»
Отключить«Отключи еженедельный отчёт»
Включить снова«Включи снова утренний дайджест»
Посмотреть список«Покажи все мои задачи по расписанию»

Контроль в админ-панели

Все задачи по расписанию видны в админ-панели: app.neiron.org/scheduled-tasks. Там можно:

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

Задачи без ИИ — дешевле и надёжнее

Задача по расписанию может работать двумя способами:

Скрипт не тратит лимиты подписки и всегда работает одинаково. Частые задачи ставьте скриптом: задача с ИИ раз в 2 минуты за день выберет лимит подписки быстрее всего остального.

«Сделай обновление остатков скриптом без ИИ и запускай каждые 30 минут. Мне пиши, только если что-то сломалось»

Хорошая схема: скрипт собирает данные часто, а ИИ раз в день делает по ним выводы.

Если задача перестала выполняться

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

«Почему остановилась задача утренней сводки? Исправь и включи снова»


Делегирование задач

Раздел: Документация Neiron. Обновлено: 28.09.2026, версия 2. Адрес для людей: https://neiron.org/docs/delegirovanie-zadach/

Как работает делегирование

В Neiron директор-агент не делает всё сам — он распределяет задачи между специализированными агентами, как настоящий руководитель.

Вы пишете директору → директор решает, кому передать →
подчинённый агент выполняет → директор проверяет →
вы получаете финальный результат

Вам не нужно знать, кто именно выполняет задачу. Вы общаетесь только с директором.

Пример делегирования

Вы пишете директору:

«Подготовь план закупок на следующий месяц с учётом сезонности и остатков»

Что происходит «за кулисами»:

  1. Директор анализирует задачу.
  2. Передаёт агенту-аналитику: «собери данные по остаткам и сезонной динамике».
  3. Передаёт агенту-закупщику: «на основе данных аналитика составь план заявок».
  4. Получает результаты от обоих.
  5. Проверяет и собирает финальный документ.
  6. Отправляет вам готовый план.

Вы видите только финальный ответ. Всю координацию делает директор.

Как правильно ставить задачи

Формула хорошей задачи

ЧТО нужно сделать + ЗАЧЕМ / КОНТЕКСТ + КРИТЕРИЙ ГОТОВНОСТИ

Примеры:

ПлохоХорошо
«Посмотри закупки»«Проверь остатки по всем артикулам. Выдели те, у которых осталось меньше 20 дней. Сформируй заявку для топ-5 поставщиков по объёму.»
«Сделай отчёт»«Сделай еженедельный отчёт по продажам: выручка, маржа, топ-10 артикулов, аномалии. Формат — таблица плюс текстовый вывод на 3–5 строк.»

Задачи с подтверждением

Для критичных действий (изменение цен, отправка заявок поставщикам) агент по умолчанию спрашивает подтверждение, прежде чем действовать:

Агент: «Подготовил заявку для поставщика ООО "Ткани". Артикулы: [список], сумма: 340 000 ₽. Отправить?»
Вы: «Да, отправляй»
Агент: «Заявка отправлена, ожидаю ответа»

Это правило в инструкциях агента, а не техническая блокировка. Чтобы оно действовало всегда, закрепите его в правилах компании, например: «Цены и заявки поставщикам — только после моего "да"». Подробнее — в разделе Безопасность.

Задачи для нескольких агентов параллельно

Если задача сложная, директор может запустить несколько агентов одновременно.

Пример:

«Нужно принять решение по новому SKU. Подготовь: анализ конкурентов в нише, расчёт юнит-экономики, контент-план для запуска»

Директор запустит аналитика, финансиста и контентщика параллельно, соберёт все результаты и выдаст вам сводное решение.

Задачи с отложенным сроком выполнения

Можно указать, когда задача должна быть запущена:

«В пятницу утром — скинь анализ конкурентов»
«В следующий четверг в 9 утра скинь отчёт по закупкам»

Куда прислать результат

По умолчанию итог приходит туда, откуда вы написали. Можно попросить иначе:

«Когда закончишь, пришли итог в группу "Отчёты"»
«Результат отправь Ивану в личку»
«Сделай в фоне, мне ничего не присылай — просто сохрани результат»

Как узнать, что с задачей

Спросите директора:

«Что с задачей по плану закупок? Кто её делает и на каком этапе?»

Директор проверит статус поручений у подчинённых и ответит. Если результат подчинённого его не устроил, он сам вернёт задачу на доработку и пришлёт вам уже исправленный итог.

Итерации и уточнения

Агент не всегда делает всё идеально с первого раза — и это нормально. Работайте итерациями:

Вы: «Сделай анализ»
Агент: [выдаёт результат]
Вы: «Хорошо, добавь сравнение с прошлым месяцем»
Агент: [дополняет]
Вы: «Теперь сохрани это как шаблон для еженедельных отчётов»
Агент: [создаёт навык с шаблоном]

Совет. Когда агент сделал что-то правильно, скажите «запомни этот подход» или «закрепи как рабочий». Он запишет сценарий в навык и будет делать так всегда.


Дашборд

Раздел: Документация Neiron. Обновлено: 28.09.2026, версия 1. Адрес для людей: https://neiron.org/docs/dashbord/

Что это

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

Не путайте с дашбордом админ-панели: там расход токенов и работа агентов. Дашборд компании — про ваш бизнес.

Как устроен

ВиджетДля чего
Показатель (KPI) и строка показателейОдна или несколько главных цифр с изменением
План-факт: линия или столбцыВыполнение плана по дням, неделям, месяцам
Кольцевая диаграммаДоли: каналы, категории, склады
ВоронкаЭтапы: лиды → встречи → оплаты
Рейтинг-списокТоп артикулов, менеджеров, клиентов
Мини-графикиОдна метрика по нескольким объектам рядом
ТаблицаЛюбые строки и столбцы
Список статусовЧто в норме, что требует внимания
ТекстПояснения, инструкции, выводы
Отчёт продавца маркетплейсаОПиУ, финансовый отчёт, история остатков и юнит-экономика по Wildberries с фильтрами по периоду, кабинетам, брендам и товарам
Свой виджетЛюбая страница под задачу: форма, калькулятор, живые данные из ваших систем

Как создать дашборд через агента

Напишите агенту-директору, какой раздел нужен и что в нём показать:

«Сделай раздел "Продажи" для всей компании. На странице "Обзор": выручка и заказы за вчера и за месяц, план-факт по дням, топ-10 артикулов по выручке, воронка "показы → корзина → заказ".»

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

Дальше правьте словами:

«Поменяй местами воронку и таблицу»
«Сделай таблицу на всю ширину»
«Раздел "Финансы" покажи только отделу финансов»
«Сделай цвета и шрифты в стиле нашего бренда» + логотип или брендбук

Кнопки «поручить агенту»

К виджету можно добавить до 10 кнопок. Кнопка отправляет агенту готовое сообщение или ставит ему задачу:

«Добавь к таблице остатков кнопку "Сформировать заявку поставщику" — пусть ставит задачу агенту-закупщику»

Сотрудник смотрит на цифры и одним нажатием отдаёт работу агенту, не переписывая задачу.

Как обновляются данные

Виджет показывает данные, которые туда положил агент. Чтобы цифры были свежими, поставьте обновление по расписанию:

«Каждый день в 8:00 обновляй цифры на странице "Продажи → Обзор" из кабинета WB»

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

Кто может менять

Доска задач и результаты

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


Безопасность

Раздел: Документация Neiron. Обновлено: 29.09.2026, версия 3. Адрес для людей: https://neiron.org/docs/bezopasnost/

Главное: как защищены ваши доступы

Безопасность в Neiron построена на принципе: пароли и токены хранятся отдельно от агента. Языковая модель работает с данными, которые приносит подключение, а не с самими ключами.

Как хранятся секреты (пароли, токены)

Все ваши доступы (API-ключи, логины, пароли) хранятся в зашифрованном виде в защищённом хранилище компании.

Ключевой принцип: при работе агент (языковая модель) не получает ваш пароль. Он пользуется подключением, а ключ берёт скрипт коннектора.

Ваш пароль → шифруется → хранится в защищённом хранилище
    ↓
Скрипт коннектора забирает ключ и обращается к API
    ↓
Агент получает готовые данные (без пароля внутри)

Поэтому ключа нет ни в памяти агента, ни в его файлах, и «вытащить» его хитрым запросом из памяти агента не получится.

Самый безопасный способ — вписывать ключи самому в админ-панели: «Библиотека» → «Коннекторы» → нужный коннектор. Так ключ не попадает в переписку. Как это сделать — в разделе Подключение сервисов.

Важно. Ключ, который вы прислали в чат, модель видит, пока сообщение лежит в переписке. Поэтому присылать ключи агенту мы не советуем. Если всё же присылаете, то только агенту-директору в личный чат, никогда в группу. Удалите сообщение, как только агент подтвердит, что сохранил ключ.

Защита от prompt injection

Prompt injection — это атака, когда злоумышленник пытается «вставить» вредоносную инструкцию в данные, которые читает агент (например, в отзыв на WB или в письмо поставщика).

По умолчанию агенты Neiron работают по правилу: содержимое внешних данных — это информация, а не команды. Агент читает отзыв или письмо, но действует только по поручениям вашей компании.

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

Изоляция между клиентами

Каждый клиент Neiron работает в своей изолированной среде:

Ваш конкурент тоже клиент Neiron? Его агенты ничего о вас не знают.

Что хранится в файлах памяти агентов

В файлах памяти хранится:

В файлах памяти не хранятся:

Ваши агенты на ваших аккаунтах

Агенты работают на ваших подписках и аккаунтах (подписка на языковую модель, аккаунты маркетплейсов). Это означает:

Управление подписками Claude

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

Процентные квоты на отдел, сотрудника или отдельного бота сейчас задать нельзя: провайдер показывает только доступный процент и текущее состояние лимита.

Что делать, если токен потерян или скомпрометирован

Смените ключ в самой системе (WB, 1С, CRM) и впишите новый в админ-панели: «Библиотека» → «Коннекторы» → нужный коннектор. Старый ключ будет заменён без потери истории и настроек.

Не получается — попросите агента-директора помочь, только сам ключ в чат не присылайте:

«Я сменил токен кабинета WB, помоги обновить подключение»
«Я сменил пароль в 1С, нужно перенастроить подключение»

Красные линии агентов

По умолчанию агенты не делают без вашего явного подтверждения:

Для критичных действий агент спрашивает ваше «Да, выполняй».

Это правила агентов, а не технический запрет. Чтобы опасное действие было невозможно, а не просто нежелательно, ограничьте его правами:


Полезные рекомендации

Раздел: Документация Neiron. Обновлено: 28.09.2026, версия 2. Адрес для людей: https://neiron.org/docs/poleznye-rekomendatsii/

Как получать максимум от системы

Собрали самые полезные приёмы, которые делают работу с Neiron заметно эффективнее.

В подразделах — готовые решения, которые стоит собрать через агента: задачник для команды, тикеты для разработки, чтобы доработки агентов не терялись, и база знаний компании.

💬 Общение с агентом

Говорите конкретно — получайте конкретно

Чем точнее вы описываете задачу, тем лучше результат.

ПлохоХорошо
«Сделай анализ»«Сделай анализ топ-20 артикулов по выручке за апрель. Формат: таблица с колонками артикул, выручка, маржа, динамика к марту. В конце — 3 строки вывода.»

Сложные задачи начинайте с планирования

Если агенту необходимо выполнить объемную задачу, то не ставьте ее в лоб. Сначала начните с постановки задачи и вопроса агенту, как он видит ее решение. Например: «Мне нужно сделать сервис сквозной аналитики в дашборде, который будет сопоставлять продажи из нашей CRM и рекламную аналитику из Яндекс Метрики. Как это реализовать?»

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

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

Показывайте примеры

Если хотите определённый формат:

«Хочу отчёт в таком формате:
[вставляете пример]
Сделай так же для наших данных»

Уточняйте по шагам

Не бойтесь переспрашивать и уточнять. Каждая итерация — шаг к тому, что нужно именно вам:

«Добавь ещё столбец с маржой»
«Отсортируй по убыванию»
«Теперь убери артикулы с нулевыми остатками»

🧠 Память и накопление знаний

Скажите «запомни» после важного решения

После любого стратегического разговора добавьте:

«Запомни этот вывод: [суть]»
«Зафиксируй это как правило работы с ценообразованием»

Обновляйте базу знаний регулярно

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

Попросите агента рассказать, что он помнит

Раз в месяц полезно проверять:

«Покажи, что ты помнишь о нашем бизнесе и наших договорённостях»

Так вы убедитесь, что агент работает с правильными данными.

⚡ Навыки: автоматизация через «закрепи»

Главный лайфхак: «закрепи как рабочий»

Когда агент сделал что-то хорошо, сразу закрепите:

«Отличный результат. Закрепи этот подход как навык.»
«Запомни этот шаблон отчёта и используй всегда.»
«Сохрани этот сценарий как инструкцию для закупок.»

Один раз — и агент всегда будет делать именно так.

Делитесь лучшими практиками между агентами

Если один агент научился делать что-то хорошо:

«Скопируй этот навык агенту-ассистенту Ивана»

Попросите показать список навыков

«Покажи, что ты умеешь делать»
«Какие у тебя есть навыки?»

🔄 Расписания и автоматизация

Начните с утреннего дайджеста

Первая задача по расписанию, которую стоит создать:

«Каждый день в 9:00 присылай утренний дайджест:
— ключевые показатели за вчера
— что требует внимания сегодня
— напоминания и дедлайны»

«Тихие» задачи — для фоновой работы

Задачи, которые просто обновляют данные без уведомлений, экономят токены и не засоряют чат:

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

Одноразовые напоминания

«Напомни мне через 2 часа проверить ответ от поставщика»
«В пятницу в 16:00 напомни отправить отчёт руководителю»

💰 Экономия на токенах

Токены = деньги. Вот как тратить их разумно:

🔗 Работа в группах

Используйте группы для командных обсуждений

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

Топики для разных процессов

Если группа с форумом, создайте топики:

Агент будет отвечать в нужном топике.

🔁 Создание «кругов» — шаг за шагом

Не пытайтесь запустить всё сразу. Лучшая стратегия:

  1. Автоматизируйте одну самую болезненную задачу — добейтесь, чтобы она работала идеально.
  2. Создайте навык — зафиксируйте рабочий сценарий.
  3. Добавьте расписание — запустите задачу автоматически.
  4. Наблюдайте неделю — убедитесь, что всё работает правильно.
  5. Переходите к следующей задаче.

Через 2–3 месяца у вас будут работать 5–6 автономных кругов.

🚀 Быстрые команды на каждый день

Что нужноЧто написать
Быстрый статус«Как дела? Что важного за сегодня?»
Поставить задачу«Сделай [описание] и пришли результат»
Запомнить«Запомни: [важная информация]»
Добавить в базу знаний«Сохрани в вики» + [материал]
Создать расписание«Каждый [день / неделю / месяц] в [время] делай [задача]»
Делегировать«Передай это [имя агента или роль] и пришли мне итог»
Уточнить«Переделай, но [что изменить]»
Зафиксировать процесс«Закрепи этот подход как навык»

⚠️ Чего делать не нужно

Neiron — команда ИИ-сотрудников для вашего бизнеса | neiron.org

Подразделы


Задачник

Раздел: Полезные рекомендации. Обновлено: 28.09.2026, версия 1. Адрес для людей: https://neiron.org/docs/zadachnik/

Что это

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

Доска задач в дашборде

В дашборде компании есть доска задач сотрудников. Агент ставит туда задачу от вашего имени, достаточно написать:

«Поставь Ивану задачу подготовить КП для ООО "Ромашка" до пятницы 18:00, приоритет высокий»

У задачи есть исполнитель, срок, приоритет (низкий, средний, высокий, критичный), описание и метки. Новая задача появляется в первой колонке доски.

Если исполнителя агент не нашёл, задача появится без исполнителя — назначьте его на доске.

Задачник как у нас: что можно собрать через агента

Команда Neiron сама работает в расширенном задачнике, который собрали агенты. Такой же можно попросить у своего агента-директора. Вот что в нём есть:

ФункцияКак работает
ЗадачиПостановщик, исполнитель, срок, приоритет, статус, комментарии
Где ставитьВ дашборде, в мини-приложении Telegram или сообщением любому агенту
КалендарьЗадачи по дням и неделям
План-факт дняУтренний план сотрудника превращается в задачи, вечером видно, что сделано
Уведомления в TelegramБот пишет исполнителю: новая задача, за сутки и за 2 часа до срока, просрочка (один раз), сдача и приёмка
Тихие часыНочью бот не пишет, сообщения ждут утра
Утренняя сводкаКаждому — его задачи на сегодня и просроченные
Вопрос о статусе«Узнай у Ивана, что с задачей» — бот спрашивает, ответ записывается в задачу и приходит вам
Мини-приложение в TelegramЗадачи открываются прямо в боте, вход по аккаунту Telegram без пароля
ИсторияКто, когда и что поменял в задаче

Как создать через агента

Напишите агенту-директору, можно одним сообщением:

«Сделай задачник команды. Задачи храни в нашей базе данных. У задачи: постановщик, исполнитель, срок, приоритет, статус, комментарии, история изменений. Раздел "Задачи" в дашборде: список, календарь и план-факт. Уведомления исполнителю через бота @ваш_бот: новая задача, за сутки и за 2 часа до срока, просрочка один раз. Тихие часы с 21:00 до 9:00. В 9:00 по будням — сводка каждому. Ставить задачи можно сообщением любому агенту.»

Что понадобится:

Собирайте по шагам: сначала задачи и раздел в дашборде, неделю поработайте, потом добавьте уведомления и сводки. Когда задачник заработает, закрепите в правилах компании: «Задачи сотрудникам ставим только в задачнике, напоминания шлёт только бот задачника». Так агенты не будут дублировать друг друга.


Тикеты для разработки

Раздел: Полезные рекомендации. Обновлено: 28.09.2026, версия 1. Адрес для людей: https://neiron.org/docs/tikety-dlya-razrabotki/

Зачем

Агент-директор умеет писать код: навыки, скрипты, страницы дашборда, сайт, задачи по расписанию. Большая доработка не всегда укладывается в один разговор. Сессия может прерваться, а через неделю уже никто не помнит, что меняли и почему. Тикеты для разработки решают это так же, как у программистов: у каждой доработки есть номер, план, журнал шагов и история кода.

Что умеет

ФункцияЗачем
Реестр тикетовУ каждой доработки номер (DEV-12), цель, критерий приёмки, этап и агент-владелец
ЭтапыИдея → готово к работе → в работе → на проверке → внедрено
ЧекпоинтыПосле каждого шага агент записывает «что сделано» и «что дальше». Прерванная работа продолжается с этого места, а не с начала
«Ждём человека»Тикет, которому нужно ваше решение или доступ, помечается — видно, кто и что держит
История кода (git)Каждое изменение сохраняется с номером тикета: видно, кто и что менял, можно откатить
Паспорт проектаФайл «что работает, какие решения приняты, какие долги и риски». Новый агент быстро входит в контекст
СторожЕсли сессия прервалась без записи, через 30 минут вам приходит сообщение: какой тикет и на каком шаге остановился
ДоскаРаздел дашборда «Разработка»: тикеты по этапам, только для просмотра

Как работает агент по тикету

  1. В начале сессии агент смотрит свои незакрытые тикеты. Прерванный продолжает с последнего чекпоинта.
  2. Берёт тикет в работу. Два агента не возьмут один тикет одновременно.
  3. После каждого шага пишет чекпоинт и сохраняет код в git.
  4. Ждёт вашего решения — помечает тикет «ждём человека».
  5. Закрывает тикет с итогом и записью в паспорт проекта.

Как создать через агента

Напишите агенту-директору:

«Заведи процесс разработки через тикеты. Реестр тикетов в нашей базе данных: номер DEV-N, проект, цель, критерий приёмки, этап, владелец, журнал чекпоинтов. Сделай навык: в начале любой сессии, где меняешь код, навыки или расписания, показывай свои незакрытые тикеты; бери тикет в работу; после каждого шага записывай "что сделано" и "что дальше"; сохраняй код в git с номером тикета; закрывай тикет с итогом. Если сессия прервалась без чекпоинта, через 30 минут пиши мне, какой тикет остановился. Добавь в дашборд раздел "Разработка" с доской тикетов.»

Потом закрепите в правилах компании: «Любую доработку кода, навыков и расписаний агенты ведут через тикеты разработки». Без этого правила агенты будут вспоминать про тикеты через раз.

Совет. Процесс нужен, когда агенты разрабатывают много и регулярно. Если навыков пара штук и меняются они редко, хватит обычной просьбы «сохрани, что поменял, в память».


База знаний (Wiki)

Раздел: Полезные рекомендации. Обновлено: 28.09.2026, версия 2. Адрес для людей: https://neiron.org/docs/baza-znaniy-wiki/

Что такое база знаний

Wiki — это корпоративная база знаний вашей компании. Туда можно сохранить всё, что важно: информацию о клиентах, продуктах, технологиях, стратегических выводах, кейсах продаж.

В отличие от памяти отдельного агента, wiki доступна всем агентам вашей компании.

Это как Википедия, только для вашего бизнеса и ваших агентов.

Как установить базу знаний

Wiki не устанавливается автоматически — её нужно создать один раз. Это просто: отправьте вашему агенту-директору промпт ниже.

Сначала решите: база знаний будет общей для всей компании (рекомендуется) или только для конкретного агента? Если для одного агента — добавьте это уточнение в промпт.

Промпт для создания базы знаний (LLM Wiki)

Скопируйте текст целиком:

Я хочу, чтобы ты изучил метод Андрея Карпати про создание LLM Wiki
https://x.com/karpathy/status/2039805659525644595 и создал в общих
файлах вики. Там будет твоя база знаний по всем необходимым компании
категориям. Нужно создать новый навык, который запускается раз в сутки,
обрабатывает папку с сырыми данными и записывает в вики уже отобранные
данные. Ведётся лог уже обработанных файлов, чтобы повторно их не
обрабатывать при новом запуске. Сырые данные хранятся только в одной
папке сырых данных. Также должен быть навык работы с вики.

Алгоритм работы такой: я или другой сотрудник скидывает агенту файл,
ссылку на статью, текст, документ и говорит «сохрани». Запускается
навык и сохраняет данные в папку с сырыми данными. Далее ночью в режиме
тишины по расписанию запускается задача — обработать новые сырые данные
и записать их в вики. Если файл относится к разным темам, его нужно
разбить по смысловым блокам и перенести каждый блок в нужную категорию.
Если сотрудник спрашивает что-то по клиенту, проекту или тому, что
занесено в базу знаний, нужно сделать поиск по ней.

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

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

Пример структуры базы знаний

Базу знаний можно организовать по таким категориям:

КатегорияЧто хранится
clients/Страница на каждого клиента: контакты, боли, история, KPI
products/Описание продуктов, конкурентов, возможностей
tech/AI-инструменты, технические фреймворки, инструкции
strategy/Стратегические выводы, фреймворки, решения
sales/Кейсы, скрипты, возражения, лиды
docs/Документация по инструментам, которые использует ваш бизнес

Как добавить материал в базу знаний

Через сообщение агенту

«Сохрани это в базу знаний»
«Добавь в вики»
«Запиши в базу»

Вместе с этим передайте материал — ссылку, файл или текст:

«Сохрани эту статью в вики: https://...»
«Сохрани в базу знаний» + [прикреплённый файл]
«Запомни в базу: клиент ИП Иванов, ниша — детская одежда, болит логистика и сезонность, обсуждали в мае 2026»

Агент сохранит материал и ночью автоматически его структурирует.

Категории присваиваются автоматически

Агент сам определяет, в какую категорию поместить материал. Если хотите указать явно:

«Сохрани в категорию clients»
«Добавь в раздел strategy»

Как найти информацию в базе знаний

«Что мы знаем о клиенте Иванове?»
«Найди в базе информацию о конкурентах в нише детской одежды»
«Есть ли в вики что-то о распределении остатков по складам?»
«Покажи, что у нас есть по стратегии»
«Расскажи про технологию LLM Wiki»

Агент просмотрит базу знаний и выдаст подходящий результат.

Автоматическая обработка

Раз в сутки (или по вашему расписанию, хоть каждый час) запускается обработка:

  1. Агент берёт все материалы, которые вы добавили за день.
  2. Структурирует их: выделяет ключевые факты, создаёт страницы.
  3. Обновляет или создаёт нужные разделы в wiki.
  4. Обновляет общий индекс.

К утру вся вчерашняя информация уже структурирована и доступна для поиска.

Умная обработка материалов на несколько тем

Если вы загрузили большой документ с разными темами (например, расшифровку встречи, где обсуждали и клиентов, и стратегию, и инструменты), агент:

  1. Анализирует весь документ.
  2. Разбивает его на смысловые блоки.
  3. Создаёт отдельные страницы в нужных категориях.

Один файл → несколько аккуратных страниц wiki.

Что стоит сохранять в базу знаний

СохраняйтеНе сохраняйте
Интересные статьи, видео, кейсыПароли и токены (для этого есть коннекторы)
Информацию о клиентах и переговорахЛичную конфиденциальную информацию
Конкурентную разведкуВременные заметки, которые нужны только сегодня
Успешные стратегии и подходы
Технические инструкции и решения
Итоги важных встреч и созвонов

Совет: заведите привычку

После каждой важной встречи, звонка или когда нашли полезный материал, одним сообщением отправьте агенту:

«Сохрани в базу знаний» + материал

Через месяц у вас будет база знаний, с которой агенты отвечают точнее и с учётом контекста.


Ошибки и как их исправить

Раздел: Документация Neiron. Обновлено: 28.09.2026, версия 1. Адрес для людей: https://neiron.org/docs/oshibki-i-kak-ikh-ispravit/

Здесь собраны ошибки, которые агенты и платформа Neiron на самом деле показывали нашим клиентам. Для каждой написано, что она значит и как её исправить.

Как найти свою ошибку: скопируйте из сообщения агента кусок текста на английском, например hit your limit или Refresh token expired, и найдите его на этой странице (Ctrl+F или «Найти на странице» в телефоне).

Как читать сообщение об ошибке

Когда агент не может закончить работу, он присылает сообщение такого вида:

Я не смог корректно завершить ответ. Причина: All claude_oauth subscriptions are exhausted or failed for this company. auth: Error: Refresh token expired

В нём три части:

  1. Через что работал агент — claude_oauth, openai_api и так далее, расшифровка в таблице ниже.
  2. Тип отказа — слово перед двоеточием: limit, auth, terminal или provider_unknown.
  3. Текст провайдера — всё после двоеточия. Именно он говорит, что случилось.

Важно. Начало «All … subscriptions are exhausted or failed» («Все подписки провайдера … исчерпаны или отказали») ещё не значит, что кончились лимиты. Так платформа начинает любую ошибку подписки. Дальше может оказаться и лимит, и слетевший вход, и слишком большой файл. Решение выбирайте по тексту после двоеточия.

В тексте ошибкиЧто это
claude_oauthподписка Claude
anthropic_apiAPI-ключ Claude
openai_oauthподписка ChatGPT
openai_apiAPI-ключ OpenAI
не настроеноэтот способ у вас не подключён. Это не ошибка: просто нет запасного варианта
Тип отказаЧто значит
limitкончился лимит подписки
authподписка требует нового входа
terminalпровайдер отказал, и платформа не будет повторять запрос сама. Причина — в тексте дальше
provider_unknownдругая ошибка провайдера. Причина — в тексте дальше

Самые частые ошибки

Фрагмент текстаЧто случилосьЧто делать
You've hit your limit · resets …, session limitкончился лимит 5-часового окна подписки Claudeподождать до времени сброса или переключиться на другую подписку
You've hit your usage limit … chatgpt.com/codexкончился лимит подписки ChatGPTподождать до указанного времени, докупить или переключиться
в паузе после ошибки … Повторите примерно через N мин.подписка временно отложена, чаще всего из-за лимитаподождать N минут или переключиться на другую подписку
Refresh token expired, refresh token was already used, отключено или требует переподключенияподписка отключиласьпереподключить подписку в админ-панели
529 Overloadedперегружены серверы Anthropicповторить позже
Контекст задачи переполнен, Autocompact is thrashingагенту попал слишком большой файлразбить задачу на части

Подробности и остальные ошибки — ниже.

Кончился лимит подписки

Лимит сессии Claude (5 часов)

You've hit your limit · resets 6pm (UTC)
You've hit your session limit · resets 6pm (UTC)

Что это. У подписки Claude есть лимит на 5-часовое окно. Лимит общий на аккаунт: если этим же аккаунтом пользуются в обычном чате Claude, он кончается быстрее.

Время сброса указано по UTC. Чтобы получить московское, прибавьте 3 часа: resets 6pm (UTC) — это 21:00 по Москве.

Что делать:

  1. Подождать до времени сброса. Агент заработает сам, ничего переподключать не нужно.
  2. Переключиться на другую подписку, если работа не ждёт. Подключите вторую подписку Claude или ChatGPT: шестерёнка в админ-панели → первая вкладка. Если подписок Claude несколько, платформа сама распределяет запросы между ними.
  3. Поставить модель полегче: агент → «Модель и размышление» → «LLM модель» → «Сохранить настройки». Самые мощные модели тратят лимит в разы быстрее, а на большинстве задач разницы не видно.
  4. Докупить продолжение у Anthropic: claude.ai → Settings → Usage → Usage credits → Enable → Add funds. Сверх лимита запросы оплачиваются по тарифам API. По справке Anthropic, это работает и для Claude Code, через который работают агенты.
  5. Перейти на тариф выше, если лимита не хватает регулярно.

Недельный лимит и лимит самой мощной модели

Кроме 5-часового окна, у подписки Claude есть недельный лимит на все модели. У самой мощной модели (например, Fable) бывает ещё и свой недельный лимит. Он может кончиться, когда общий лимит ещё есть: агент на мощной модели встанет, а на соседней модели работал бы дальше.

Где посмотреть: claude.ai → Settings → Usage. Там видно, сколько израсходовано и когда сброс. День и время сброса недельного лимита у каждого аккаунта свои и не зависят от даты оплаты.

Что делать: переключить агента на другую модель, подождать сброса, докупить продолжение или повысить тариф — как в разделе выше.

Примечание. Пока лимит исчерпан, попросить самого агента сменить модель не получится: он не сможет ответить. Меняйте модель в админ-панели: агент → «Модель и размышление» → «LLM модель» → «Сохранить настройки».

Месячный лимит организации Claude

You've hit your org's monthly usage limit

Что это. В аккаунте Claude стоит лимит расходов на месяц. Если подписка входит в организацию (тариф Team или Enterprise), такой лимит задаёт администратор организации.

Что делать: поднять лимит в настройках аккаунта или организации Claude, подождать начала следующего месяца или подключить другую подписку.

Лимит подписки ChatGPT

You've hit your usage limit. Upgrade to Pro (https://chatgpt.com/explore/pro), visit https://chatgpt.com/codex/settings/usage to purchase more credits or try again at 1:58 PM.

Что это. Агент на подписке ChatGPT тратит лимиты Codex. У них тоже есть 5-часовое окно и недельный лимит. Считаются они отдельно от обычного чата ChatGPT: в чате лимит может ещё оставаться, а у агента уже кончиться.

Что делать:

Подписка «в паузе после ошибки»

Сейчас нет доступной LLM-подписки — claude_oauth: 1 в паузе после ошибки; anthropic_api: не настроено. Повторите примерно через 221 мин.

Что это. Платформа временно отложила подписку после ошибки и вернёт её в работу через указанное время.

Что делать, если ждать нельзя: подключите вторую подписку, тогда агенты перейдут на неё.

Лимиты и баланс API-ключей

Если агент работает по API-ключу Claude, OpenAI, DeepSeek или OpenRouter:

ОшибкаЧто этоЧто делать
429 Rate limit reached, rate_limit_error, Too Many Requestsслишком много запросов за минуту. Например, альбом из 10 фото запустил несколько задач сразу, и вместе они превысили лимитобычно проходит само через минуту. Если повторяется — не запускайте много задач одновременно
429 You have no credits remaining, 402, insufficient credits, billing_errorна балансе кончились деньгипополнить баланс у провайдера
Organization spend limit reached, Project spend limit reachedсработал ваш лимит расходов в OpenAIподнять лимит в настройках OpenAI или дождаться нового месяца
401 Incorrect API key, Invalid Authentication, authentication_errorключ неверный, удалён или перевыпущенсоздать новый ключ и заново вставить его в админ-панели

Где взять ключ и как пополнить баланс — в главе Подключение ИИ и на странице Как подключить OpenRouter.

Подписка отключилась: нужно войти заново

All claude_oauth subscriptions are exhausted or failed for this company. auth: Error: Refresh token expired
Сейчас нет доступной LLM-подписки — claude_oauth: 1 отключено или требует переподключения; anthropic_api: не настроено.
Failed to authenticate. API Error: 401 … "authentication_error" … "Invalid authentication credentials"
Your access token could not be refreshed because your refresh token was already used. Please log out and sign in again.

Что это. Платформа потеряла вход в ваш аккаунт Claude или ChatGPT. Сама подписка у Claude или ChatGPT при этом активна и оплачена, но заново подключить её нужно именно в админ-панели Neiron.

Частая причина — тем же аккаунтом пользуются где-то ещё: в Claude Code или Codex на компьютере, в другой программе или сервисе. При каждом таком входе провайдер выдаёт новый ключ доступа, и старый, которым пользовалась Neiron, перестаёт работать.

Как переподключить подписку Claude:

  1. Шестерёнка в правом верхнем углу админ-панели → первая вкладка, подписки.
  2. «Удалить» рядом с подпиской Claude.
  3. «Авторизоваться через Claude», войдите в аккаунт и вставьте код в поле, как при первом подключении. Пошагово — на странице Как подключить подписку Claude.

Как переподключить подписку ChatGPT:

  1. Шестерёнка → первая вкладка → блок OpenAI Codex (ChatGPT) → «Переподключить» или «Авторизоваться через ChatGPT».
  2. Выберите аккаунт. После входа скопируйте из адресной строки ссылку вида http://localhost:1455/… и вставьте её в поле в админ-панели. Пошагово — на странице Как подключить подписку ChatGPT.

Чтобы подписка не слетала:

Нет ни одной работающей подписки

No active LLM subscriptions configured for this company. Checked providers: claude_oauth, anthropic_api

Что это. Сейчас не работает ни одна подписка компании: либо все отключились, либо у всех кончился лимит.

Что делать: переподключите подписку, как описано выше. Если ошибка осталась, значит, это лимит: дождитесь сброса или подключите ещё одну подписку.

Не работает один агент, остальные в порядке

Агент пишет «Сейчас нет доступной LLM-подписки», а другие агенты отвечают. Значит, этот агент настроен на провайдера, подписка которого отключилась. Например, агент работает на OpenAI, а подписка ChatGPT слетела, при этом остальные агенты на Claude работают.

Что делать: переподключите подписку этого провайдера или переключите агента на другого провайдера: агент → «Модель и размышление».

Задачи по расписанию без ИИ у такого агента продолжают работать: падает только то, для чего нужна модель.

Перегрузка и сбои у провайдера ИИ

API Error: 529 Overloaded. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.

Что это. Перегружены серверы Anthropic. Ваши настройки тут ни при чём: сбой бьёт по всем пользователям Claude сразу и обычно проходит сам, от нескольких минут до нескольких часов.

Что делать:

  1. Повторить запрос через несколько минут.
  2. Проверить состояние на status.claude.com.
  3. Если работа срочная — временно переключить агента на ChatGPT или другого провайдера.

То же самое делайте при похожих ошибках:

ОшибкаПровайдерЧто это
500 api_error, 504 timeout_errorClaudeвнутренняя ошибка или таймаут у Anthropic
500 The server had an error while processing your request, 503 Model temporarily overloadedOpenAIсбой или перегрузка у OpenAI, состояние — status.openai.com
502OpenRouterвыбранная модель сейчас недоступна. Выберите другую модель
503OpenRouterнет свободного поставщика для этой модели. Подождите или выберите другую модель
Upstream idle timeout exceededлюбойпровайдер слишком долго не отвечал, и платформа прервала задачу. Повторите

Страница «Claude will return soon»

При входе в Claude открывается страница «Claude will return soon — temporary service disruption», а при подключении подписки видно, что регион недоступен.

Что это. Если на status.claude.com всё в порядке, а у других Claude работает, то это не сбой. Anthropic ограничил доступ с вашего адреса в интернете: он не обслуживает Россию и блокирует многие VPN и общие адреса.

Что делать: смените сеть или VPN. Если не получается, напишите нам — поможем.

Ошибки модели и объёма работы

Модель не поддерживается

API Error: 400 Claude Code 2.1.219 does not support this model; version 2.1.251 or newer is required

Что это. Вы выбрали новую модель, которую платформа ещё не поддерживает.

Что делать: верните агенту предыдущую модель («Модель и размышление» → «LLM модель») и напишите нам. Обновление делается на нашей стороне.

Организация запретила подписку в Claude Code

Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access

Что это. Подписка Claude входит в организацию (тариф Team или Enterprise), и администратор организации запретил пользоваться подпиской в Claude Code. Агенты работают через Claude Code, поэтому подписка для них перестаёт работать.

Что делать — любой из вариантов:

Слишком большой файл: контекст переполнен

Контекст задачи переполнен: файл или вывод инструмента оказался слишком большим даже после повторной попытки. Сократите задачу или укажите конкретный файл/фрагмент.
Autocompact is thrashing: the context refilled to the limit within 3 turns of the previous compact, 3 times in a row. A file being read or a tool output is likely too large…

Что это. Агенту попал слишком большой файл или ответ сервиса, и он не помещается в память модели. Такая ошибка может прийти и под заголовком «subscriptions are exhausted», хотя лимиты тут ни при чём.

Что делать:

Агент останавливается на середине долгой задачи

Что это. У агента сработал «Лимит ходов на запуск» — сколько шагов он может сделать за одну задачу.

Что делать: агент → «Модель и размышление» → «Лимит ходов на запуск» → увеличьте значение, например на 15, и нажмите «Сохранить настройки». Можно и разбить задачу на части.

ЗначениеКогда ставить
0без ограничения. Подходит внутренним рабочим агентам
15–25публичным агентам: защита от зацикливания на вопросах посторонних людей

Инструменты агента несовместимы с моделью

400 Invalid schema for function 'WebFetch': … 'uri' is not a valid format

Что это. Встречалось у агентов на моделях OpenAI по API-ключу. Модель не принимает описание одного из встроенных инструментов агента. Настройками агента это не исправить, это делается на стороне платформы.

Что делать: временно переключите агента на Claude и напишите нам.

Ошибки платформы Neiron

Ошибка или что видитеЧто этоЧто делать
terminal: [object Object]платформа не смогла прочитать ответ провайдераповторите запрос. Не помогло — переподключите подписку. Снова не помогло — напишите нам
Codex CLI exited with code 1 … Operation not permittedсбой запуска агента на подписке ChatGPT на стороне платформынапишите нам, а пока переключите агента на Claude
Не удалось выполнить задачу «…». Попробуйте повторить её позже. или Сервис временно недоступен: не удалось подтвердить обработку сообщениязадача не уложилась во время ожиданиясначала проверьте результат: бывает, что агент всё сделал. Если нет — повторите
Ошибки 502, 503 или 504 на сайте компании или в его API, the database system is shutting down, no space left on deviceсбой хостинга или базы данныхобычно проходит сам, от нескольких минут до часа. Если дольше — напишите нам
HTTP 500 {"error":"storage_readonly"}бэкенду сайта компании не разрешена запись в хранилищенапишите нам: откроем доступ к нужным разделам
Бот молчит несколько минут, потом отвечает на всё сразу, иногда дваждызадержка доставки сообщений из Telegram на стороне платформы. Сообщения не теряютсяподождите. Если бот молчит дольше 15 минут — напишите нам

Telegram

Ошибка или что видитеЧто этоЧто делать
Sender bot cannot send chat messages in private-only modeагент настроен только на личные диалогиразрешите агенту работу в группах в настройках агента в админ-панели (если не нашли — напишите нам). В @BotFather разрешите добавлять бота в группы, а в «Связи» → «Telegram чаты» добавьте группу
Бот в группе не видит сообщенияу бота включён режим приватности@BotFather → Bot Settings → Group Privacy → выключить. Затем удалите бота из группы и добавьте заново
Too Many Requests: retry after Nбот отправил слишком много сообщений за короткое время. Это ограничение Telegramподождите N секунд. Не делайте массовые рассылки одним ботом
Бот перестал получать сообщения, хотя в админ-панели всё подключенотокен бота подключён ещё к одному сервису (CRM, конструктор ботов), и тот забирает сообщения себеодин токен — один агент. Отключите бота в другом сервисе или заведите для него отдельного бота
chat not foundбота нет в группе или указан неверный id чатадобавьте бота в группу и проверьте id в «Связи» → «Telegram чаты»
bot can't initiate conversation with a user, Forbidden: bot was blocked by the userбот не может написать первым человеку, который не нажимал «Start» или заблокировал ботапопросите человека открыть бота и нажать «Start»

Как создать бота и настроить его для групп — в главе Каналы общения.

Подключение сервисов

Ошибка или что видитеЧто этоЧто делать
needs_connector, Connector "…" is not granted to this siteбэкенду сайта компании не открыт доступ к сервисуадмин-панель → «Сайт» → «Доступ» → разрешите нужный сервис
Агент пишет, что сервис не подключён, хотя в библиотеке он есть, или получает 403сервис открыт только другому отделу или другим агентамоткройте доступ отделу этого агента или самому агенту
Google: invalid_grant через несколько дней после подключенияваше приложение Google в режиме тестирования, а в нём вход живёт 7 днейGoogle Cloud Console → Google Auth Platform → Audience → Publish app. Затем подключите Google заново
Яндекс: ошибка 400 при подтверждении доступаприложение Яндекса ещё не прошло проверкудождитесь, пока статус приложения сменится на «Подключён»
Яндекс Директ: error 58регистрация в API Директа не завершена: заявку на доступ ещё не одобрили или токен получен через другое приложение Яндексапроверьте статус заявки в веб-интерфейсе Директа. Получите токен через то приложение, для которого одобрена заявка
WB или Ozon: 429превышен лимит запросов маркетплейса по вашему токену. У методов аналитики лимиты особенно низкиеподождите и запускайте задачу реже. Попросите агента делать меньше запросов за один запуск
Любой сервис: 401, «токен истёк», «ключ недействителен»ключ сервиса истёк или отозванвыпустите новый ключ в кабинете сервиса и обновите его в библиотеке коннекторов

Как подключать сервисы и раздавать к ним доступ — в главе Подключение сервисов.

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

Что видитеЧто этоЧто делать
Задача перестала запускаться, уведомления не былозадача 5 раз подряд завершилась ошибкой, и платформа её остановилапопросите агента: «Почему остановилась задача утренней сводки? Исправь и включи снова»
Каждый запуск падает с «Сейчас нет доступной LLM-подписки», а задачи без ИИ работаютподписка провайдера этого агента отключиласьпереподключите подписку, как описано выше. Такие ошибки задачу не останавливают: она будет падать при каждом запуске, пока подписку не переподключат
Задача падает на одном и том же местекончился ключ сервиса, сменился адрес или формат данныхпопросите агента запустить задачу вручную и показать ошибку

Подробнее — в главе Задачи по расписанию.

Когда писать нам

Напишите в общий чат с командой Neiron, если:

Что прислать:

  1. Полный текст ошибки — скопируйте его текстом, а не скриншотом.
  2. Какой агент.
  3. Когда это случилось.
  4. Что вы попросили агента сделать.