Документация 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 или GPT — это двигатель. Мощный, но сам по себе никуда не едет.
- Агент Neiron — это вся машина целиком: кузов, руль, педали, навигатор, круиз-контроль.
Claude в обычном чате:
- не умеет ставить задачи другим агентам;
- не может сам запустить проверку остатков в 3:00 ночи;
- не подключён к вашему кабинету Wildberries, CRM или 1С;
- не знает историю ваших продаж и решений.
Агент Neiron умеет всё это и ещё больше.
Главная идея: самообучающаяся компания
Цель Neiron — не «сделать ваших людей на 20% продуктивнее», а перестроить компанию в интеллектуальную систему, где рутина замкнута на ИИ и постоянно сама себя улучшает.
Было: Вы → ставите задачи → люди → делают вручную → вы проверяете
Стало: Вы → ставите правила → агенты → делают 24/7 → вы смотрите сводку
Три этапа, через которые проходит каждый клиент:
- Агенты помогают людям — каждый сотрудник получает AI-помощника, который ускоряет его работу в разы.
- Агенты заменяют рутину — процессы замыкаются в автоматические циклы, люди только подправляют.
- Автономная работа — основные бизнес-процессы крутятся без вмешательства; люди занимаются стратегией, продуктом и отношениями.
Из чего состоит система
┌─────────────────────────────────────────────────────┐
│ ВЫ │
│ (Telegram, веб-чат, дашборд компании) │
└────────────────────┬────────────────────────────────┘
│
┌────────────────────▼────────────────────────────────┐
│ ГЛАВНЫЙ АГЕНТ │
│ (оркестратор, ваша точка входа) │
└──────┬───────────┬───────────────┬──────────────────┘
│ │ │
┌──────▼──┐ ┌─────▼─────┐ ┌──────▼─────┐
│ Агент │ │ Агент │ │ Агент │
│закупок │ │маркетинга │ │ аналитики │ ...
└──────┬──┘ └─────┬─────┘ └──────┬─────┘
│ │ │
┌──────▼───────────▼───────────────▼──────────────────┐
│ ДВИЖОК NEIRON │
│ (расписания, коннекторы, навыки, память, права) │
└──────┬───────────┬───────────────┬──────────────────┘
│ │ │
┌──────▼──┐ ┌─────▼─────┐ ┌──────▼─────┐
│ WB │ │ 1С/ERP │ │ Telegram │ ...
│ кабинет │ │ CRM │ │ чаты │
└─────────┘ └───────────┘ └────────────┘
Компоненты системы:
| Компонент | Что это | Аналогия |
|---|
| LLM (модель) | Claude, GPT и другие языковые модели | Двигатель |
| Агент | Персонаж с ролью, памятью и навыками | Сотрудник |
| Движок | Оркестрация, права, расписания | Машина |
| Навык | Зафиксированный способ делать задачу | Инструкция в должностном регламенте |
| Коннектор | Подключение к внешней системе | Интеграция |
| Память | Файлы с историей и знаниями агента | Блокнот сотрудника |
| Дашборд | Разделы компании со страницами: цифры, таблицы, задачи — агенты собирают и обновляют их по вашей просьбе | Пульт управления |
Что агенты умеют делать
Ниже — типовые задачи. Больше всего примеров из работы на маркетплейсах, но так же агенты ведут и другие процессы компании: продажи, финансы, документы, поддержку клиентов.
Аналитика и контроль:
- полная картина кабинета: остатки, цены, риски, зоны роста;
- конкуренты, доли рынка, аномалии;
- сравнения по запросу: год к году, маржа, динамика.
Ценообразование:
- автоматические реакции (мало остатка → повысить цену, скачок СПП → действие);
- предложения по ценам в виде таблицы → вы подтверждаете → выгружается в WB/Ozon.
Закупки и логистика:
- проверка остатков, формирование заявок, рассылка поставщикам;
- распределение по складам (влияет на ~20% юнит-экономики);
- поиск новых поставщиков в интернете.
Реклама и акции:
- мониторинг автоакций, СПП, ставок;
- A/B-тесты контента, замена победителя.
Контент-завод:
- сбор трендов, сценарии, генерация видео, автопостинг;
- упаковка карточек, инфографика, SEO.
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 и GPT | platform.deepseek.com → API keys. Ключ начинается с sk- |
| OpenRouter | 400+ моделей по одному ключу и с одного баланса: Claude, GPT, Gemini, DeepSeek, Qwen, Kimi, GLM, Llama и другие | openrouter.ai/settings/keys. Ключ начинается с sk-or-v1- |
Пошагово для OpenRouter — на странице Как подключить OpenRouter.
Что важно знать про API-ключи:
- Ключ и подписка — разные вещи. Подписка Claude Max или ChatGPT не даёт API-ключа, а API оплачивается отдельно, с баланса у провайдера.
- Ключ показывается один раз. Сразу скопируйте его и вставьте в админ-панель. Не присылайте ключ агенту в чат: модель видит всё, что написано в переписке. Подробнее — в главе Безопасность.
- Начинайте с небольшой суммы. Пополните баланс на $10–20 и не включайте автопополнение, пока не поймёте, сколько тратят агенты. У OpenRouter на каждый ключ можно поставить свой лимит расхода.
Важно. Anthropic и OpenAI не работают с Россией: Россия не входит в список стран, где доступен их API, а российские карты они не принимают. OpenRouter принимает зарубежные карты, AliPay и криптовалюту USDC. Российские карты, как правило, не проходят и там.
Где подключается
Всё подключается в админ-панели:
- Нажмите на шестерёнку в правом верхнем углу — откроется окно настроек.
- Первая вкладка — подписки. Кнопки «Авторизоваться через Claude» и «Авторизоваться через ChatGPT».
- Вторая вкладка — API-ключи. Сюда вставляется ключ Claude, OpenAI, DeepSeek или OpenRouter.
При первом входе в админ-панель кнопка подключения подписки есть и в центре экрана.
Пошагово, с регистрацией и оплатой, — на страницах Как подключить подписку Claude, Как подключить подписку ChatGPT и Как подключить OpenRouter.
Несколько подписок
- Можно подключить несколько подписок, в том числе Claude и ChatGPT одновременно.
- Если подключено две и больше подписок Claude, система сама распределяет запросы и выбирает менее загруженную.
- Подписку можно закрепить за отделом или группой агентов. Например, отдельная подписка только для отдела продаж.
- Задать долю расхода на отдел, сотрудника или агента нельзя: провайдер показывает только общий остаток лимита.
Какую модель использует агент
Модель выбирается для каждого агента отдельно: админ-панель → агент в списке слева → раздел «Модель и размышление».
- Выберите провайдера: Claude, OpenAI, DeepSeek или OpenRouter.
- В поле «LLM модель» выберите модель из подсказки. Для OpenRouter впишите ID модели целиком, вместе с названием компании, например
moonshotai/kimi-k3. - Нажмите «Сохранить настройки».
Диалог при смене модели не теряется.
Как выбирать:
- сложный анализ, стратегия, разработка навыков и страниц → самая сильная модель;
- регулярные отчёты, форматирование, типовые ответы → более экономичная;
- картинки, графика, презентации → GPT;
- много простых однотипных задач → недорогая модель: DeepSeek или модель через OpenRouter.
Примечание. Не каждая модель справится с работой агента. Агент не просто пишет текст: он читает файлы, запускает навыки, работает с таблицами и сервисами. Для этого модель должна уметь вызывать инструменты (tools). Лучше всего это получается у Claude и GPT, их мы и рекомендуем как основные. Другую модель сначала проверьте на одном второстепенном агенте и только потом переводите на неё важную работу.
Как следить за расходом
- В админ-панели: «Дашборд» → «Операционный дашборд» → блок «Расход токенов по агентам». Период выбирается сверху. Для подписки там показано, сколько стоили бы запросы по ценам API. Так видно, какой агент тратит больше всех.
- Остаток лимитов подписки — «Дашборд» → «Лимиты подписок». У каждой подписки отображается свой доступный лимит на текущую сессию, недельный лимит и опционально лимит на конкретные модели.
- Расход по API-ключу — в личном кабинете провайдера. У OpenRouter это openrouter.ai/activity: расход по дням, моделям и ключам.
Больше всего лимитов съедают задачи по расписанию, которые часто запускают модель. Задача раз в 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 нужна зарубежная банковская карта.
Один из вариантов — виртуальная карта сервиса «Плати по миру»:
- Зарегистрируйтесь в сервисе.
- Выберите тариф. Лучше карту для путешествий или максимальный тариф с повышенными лимитами.
- Оплатите выпуск карты.
- Пополните её рублями через СБП с карты российского банка.
- Внесите сумму с запасом на конвертацию валюты и комиссии.
2. Подготовьте аккаунт Google
Можно использовать существующий аккаунт Google или завести новый:
- Создайте Google-аккаунт.
- Привяжите к нему номер телефона, если Google попросит подтверждение.
- Сохраните логин и пароль.
3. Включите VPN
Перед входом на сайт Claude обязательно включите VPN:
- Выберите стабильный сервер в стране, где официально работает Claude, например в Нидерландах или Германии.
- Проверьте, какую страну показывает ваш IP-адрес, например на 2ip.io.
- Не меняйте сервер и страну VPN во время регистрации, оформления подписки и подтверждения оплаты.
- Дальше для входа в 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
- С включённым VPN откройте claude.ai.
- Нажмите регистрацию или вход через Google.
- Выберите подготовленный Google-аккаунт.
- Завершите создание аккаунта Claude.
6. Выберите тариф
- Откройте Settings → Billing.
- Нажмите Upgrade to Max.
- Выберите тариф:
- Max 5x — $100 в месяц;
- Max 20x — $200 в месяц.
Если агенты будут работать постоянно и интенсивно, выбирайте Max 20x.
7. Заполните платёжные данные
Введите:
- номер зарубежной карты;
- срок её действия;
- CVV-код;
- имя и фамилию латиницей — так, как в загранпаспорте;
- страну — обязательно ту, которую показывает VPN;
- город, улицу и номер дома — адрес из шага 4;
- почтовый индекс (Postal Code).
Страна VPN, страна карты и платёжный профиль по возможности должны совпадать.
8. Оплатите подписку
- Ещё раз убедитесь, что VPN включён и страна не изменилась.
- Проверьте реквизиты карты и платёжный адрес.
- Нажмите кнопку оплаты.
Оплата может пройти сразу, или сервис попросит подтвердить личность.
9. Пройдите проверку личности
Если после оплаты появилась ссылка на сервис проверки:
- Откройте её, не отключая и не меняя VPN.
- Страной проживания укажите страну VPN.
- Тип документа — Passport.
- Страну документа укажите по загранпаспорту. Для российского загранпаспорта это Russia, даже если VPN подключён к Нидерландам.
- Сфотографируйте разворот загранпаспорта.
- Сделайте селфи по инструкции.
- Дождитесь окончания проверки.
После успешной проверки платёж пройдёт, и подписка включится.
10. Подключите подписку в Neiron
- Войдите в админ-панель под логином и паролем, которые вам выдала команда Neiron.
- Нажмите на шестерёнку в правом верхнем углу. На первой вкладке нажмите «Авторизоваться через Claude».
- Откроется вкладка Claude. Войдите в тот же аккаунт с тем же VPN (или с включённым прокси Neiron) и подтвердите доступ.
- Claude покажет код авторизации — скопируйте его. Если вместо кода откроется страница с адресом, который начинается на
localhost, скопируйте весь адрес из адресной строки. - Вернитесь в админ-панель, вставьте код в поле кода авторизации и сохраните.
Подписка появится в списке. Теперь можно создавать агентов.
Если оплата не проходит
Проверьте:
- включён ли VPN и не изменилась ли его страна;
- хватает ли денег с учётом комиссии;
- разрешены ли на карте международные интернет-платежи;
- поддерживает ли карта 3-D Secure;
- правильно ли введены реквизиты;
- совпадает ли платёжный адрес с данными карты.
Не повторяйте отклонённый платёж много раз подряд. Сначала узнайте причину отказа в поддержке сервиса, который выпустил карту.
Если агенты перестали работать с Claude
Иногда Claude сбрасывает авторизацию, и подписку нужно подключить заново:
- Админ-панель → шестерёнка.
- Нажмите «Удалить» рядом с подпиской Claude.
- Снова нажмите «Авторизоваться через Claude» и повторите шаги 3–5 из раздела 10.
Если агенты пишут про лимиты, подписка на месте, просто кончился лимит сессии или недели. Что с этим делать — на странице Подключение ИИ.
Как подключить подписку ChatGPT
Раздел: Подключение ИИ: подписка или API-токены. Обновлено: 07.10.2026, версия 3. Адрес для людей: https://neiron.org/docs/podpiska-chatgpt/
Вместо Claude или вместе с ним агентам можно подключить подписку ChatGPT. В админ-панели это подключение называется Codex — это та же подписка ChatGPT, отдельно Codex покупать не нужно.
Когда подходит ChatGPT:
- агенту нужно работать с картинками, графикой, презентациями;
- оплатить Claude не получилось;
- нужны дополнительные лимиты к подписке Claude.
1. Оформите подписку ChatGPT
- Зарегистрируйтесь на chatgpt.com или войдите в свой аккаунт. Для агентов лучше завести отдельный аккаунт, см. раздел «Важно» ниже.
- Откройте профиль → тарифы (chatgpt.com/#pricing) и выберите платный тариф. Чем выше тариф, тем больше лимитов у агентов.
- Оплатите зарубежной картой. Карта, VPN и платёжный адрес готовятся так же, как для Claude: шаги 1–4 на странице Как подключить подписку Claude.
2. Подключите подписку в Neiron
- Войдите в админ-панель.
- Нажмите на шестерёнку в правом верхнем углу. На первой вкладке нажмите «Авторизоваться через ChatGPT».
- Откроется вкладка OpenAI. Войдите в аккаунт, где оформлена подписка, и подтвердите доступ.
- Скопируйте код авторизации. Если вместо кода откроется страница с адресом, который начинается на
localhost, скопируйте весь адрес из адресной строки. - Вернитесь в админ-панель, вставьте код в поле кода авторизации и сохраните.
3. Переключите агентов на ChatGPT
Подписка сама по себе агентов не переключает. Для каждого агента, который должен работать на ChatGPT:
- Админ-панель → агент в списке слева → раздел «Модель и размышление».
- Сначала поменяйте провайдера на OpenAI, потом выберите модель в поле «LLM модель».
- Нажмите «Сохранить настройки».
Диалог с агентом при этом не теряется. Можно держать часть агентов на Claude, часть — на ChatGPT.
Важно
- Один IP с Neiron. Чтобы ChatGPT видел один и тот же IP-адрес и у агентов, и у вас, заходите в аккаунт с компьютера через прокси Neiron. Это снижает риск блокировки аккаунта. Как настроить — на странице Один IP с Neiron: прокси для Claude и ChatGPT.
- Один аккаунт — одно место. Не пользуйтесь аккаунтом, подключённым к Neiron, в Codex или других программах. Такой вход может сбросить авторизацию в Neiron, и агенты потеряют доступ к модели.
- Если агенты перестали отвечать: админ-панель → шестерёнка → «Удалить» рядом с подпиской → «Авторизоваться через ChatGPT» заново.
- Подписка ChatGPT — это не ключ OpenAI API. Голосовые сообщения расшифровываются только по ключу API с отдельным балансом. Как его получить и привязать карту — на странице Распознавание голосовых сообщений.
Один 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-адрес — и у агентов, и у вас.
Особенно это важно, когда вы:
- регистрируетесь в Claude или ChatGPT и оплачиваете подписку;
- подключаете подписку в админ-панели Neiron («Авторизоваться через Claude» или «Авторизоваться через ChatGPT»);
- сами пользуетесь тем же аккаунтом, к которому подключены агенты.
Что понадобится
- Компьютер на Windows или macOS.
- Бесплатная программа Clash Verge Rev — она направляет трафик компьютера через прокси.
- Данные прокси от поддержки Neiron: порт, логин (username) и пароль. Напишите в общий чат с командой Neiron: «Пришлите, пожалуйста, данные прокси, чтобы подключить компьютер к IP нашего Neiron».
Важно. Данные прокси — это доступ к IP-адресу вашей компании в Neiron. Не пересылайте их другим людям, не публикуйте и не присылайте агенту в чат.
1. Установите Clash Verge Rev
- Откройте страницу релизов программы: github.com/clash-verge-rev/clash-verge-rev/releases.
- В последней версии откройте список файлов (Assets) и скачайте установщик:
- Windows — файл, который заканчивается на
x64-setup.exe. Подходит для большинства компьютеров; - Mac с чипом Apple M1–M4 — файл на
aarch64.dmg; - Mac с процессором Intel — файл на
x64.dmg.
- Установите программу и запустите её.
Какой у Mac процессор, видно в меню Apple (значок яблока в левом верхнем углу) → «Об этом Mac»: «Чип Apple M…» или «Процессор Intel».
Если программа открылась на английском: Settings → Language → Русский.
2. Создайте профиль Neiron
Профиль — это файл настроек, в котором записано, через какой прокси работать.
- Откройте раздел «Профили» и нажмите «Новый».
- Тип — «Локальный», название —
Neiron. Файл не выбирайте. Нажмите «Сохранить». - Нажмите правой кнопкой на карточку профиля Neiron → «Изменить файл».
- Удалите весь текст в окне и вставьте текст ниже.
- Замените
PORT, USERNAME и PASSWORD на порт, логин и пароль от поддержки. Кавычки оставьте: должно получиться, например, port: '12345'. - Нажмите «Сохранить».
- Нажмите на карточку профиля 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. Проверьте режим работы
- Откройте раздел «Прокси» и выберите режим «Правила».
- В группе PROXY должен быть выбран Decodo-HTTP.
Профиль Neiron направляет через прокси весь трафик компьютера, пока Clash включён.
4. Включите прокси и проверьте IP
- Если у вас включён VPN — выключите его. VPN и Clash одновременно мешают друг другу.
- На главной странице Clash Verge или в разделе «Настройки» включите «Системный прокси». «Режим TUN» пока не трогайте.
- Откройте в браузере 2ip.io. Сайт должен показать IP-адрес прокси, а не ваш обычный. Чтобы сравнить, выключите «Системный прокси», обновите страницу и включите его снова.
- Если хотите убедиться, что это именно IP вашего Neiron, спросите поддержку.
Теперь браузер работает через IP Neiron: можно открывать claude.ai и chatgpt.com.
5. Включите режим TUN для приложений
Браузер использует системный прокси, а приложения Claude и ChatGPT для компьютера, Claude Code и другие программы могут его не замечать. Чтобы через прокси шли и они, включите режим TUN — Clash будет перехватывать трафик всех программ.
- На главной странице или в разделе «Настройки» включите «Режим TUN».
- Если программа попросит установить службу, нажмите «Установить службу» и подтвердите запрос администратора. На Mac может понадобиться пароль от компьютера.
- После установки службы снова включите «Режим TUN» и проверьте приложения.
Через этот прокси могут не работать звонки, игры и другие функции, которым нужен протокол UDP. Режим TUN это не исправляет.
Как пользоваться каждый день
- Перед входом в Claude или ChatGPT запустите Clash Verge, проверьте, что выбран профиль Neiron, и включите «Системный прокси» (и «Режим TUN», если пользуетесь приложениями). Зашли без прокси — сервис увидел ваш обычный IP, и смысл настройки теряется.
- Чтобы не забывать, включите «Автозапуск» в разделе «Настройки» и проверьте, что после перезагрузки компьютера прокси включается сам.
- Чтобы вернуться к обычному интернету, выключите оба переключателя: «Режим TUN» и «Системный прокси». Не закрывайте программу, оставив системный прокси включённым, — иначе пропадёт интернет.
- Пока прокси включён, весь интернет идёт через IP Neiron. Некоторые российские сайты, например банки, могут не открываться или просить дополнительное подтверждение. На время работы с ними выключайте прокси.
Если не работает
Если после включения пропал интернет, сначала выключите «Режим 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 и другим. Модель у агента меняется одной строкой в настройках, без новых регистраций и оплат.
Когда подходит:
- хотите попробовать модели, которых нет в подписке Claude или ChatGPT;
- нужна недорогая модель для простых регулярных задач;
- нужен запасной вариант на случай, если кончились лимиты подписки;
- не получается оплатить API у Anthropic или OpenAI напрямую: OpenRouter принимает и криптовалюту USDC.
Понадобится: почта, способ оплаты (зарубежная карта, AliPay или криптовалюта USDC) и 15 минут.
Шаг 1. Зарегистрируйтесь
- Откройте openrouter.ai.
- Нажмите «Sign in» в правом верхнем углу и создайте аккаунт.
Шаг 2. Пополните баланс
- Откройте openrouter.ai/settings/credits.
- Нажмите кнопку пополнения («Add Credits») и введите сумму. Одно пополнение — от $5. Для начала хватит $10–20.
- Выберите способ оплаты:
- банковская карта или AliPay — комиссия 5,5 %, минимум $0,80;
- криптовалюта USDC — комиссия 5 %.
Карты российских банков, как правило, не проходят.
Что важно знать про оплату:
- Наценки на токены нет. Вы платите за модель столько же, сколько у её разработчика. OpenRouter берёт комиссию только при пополнении.
- Возврат. Неиспользованные кредиты можно вернуть в течение 24 часов после оплаты картой. Комиссию не возвращают, оплату криптовалютой не возвращают совсем.
- Срок. Кредиты могут сгореть через год после покупки, поэтому не пополняйте сильно впрок.
- Автопополнение (Auto Recharge) не включайте, пока не поймёте, сколько тратят ваши агенты.
Совет. Если за всё время вы пополнили баланс на $10 и больше, у бесплатных моделей вырастет лимит: 1000 запросов в день вместо 50.
Шаг 3. Создайте API-ключ
- Откройте openrouter.ai/settings/keys.
- Нажмите «Create Key».
- Введите понятное название, например
neiron. - Поставьте лимит расхода на ключ, например $20. Лимит бывает разовым или обновляется раз в день, неделю или месяц. Если агент зациклится или ключ утечёт, больше лимита с ним не потратят.
- Скопируйте ключ — строку вида
sk-or-v1-…. Целиком он показывается только один раз. Не успели скопировать — удалите ключ и создайте новый.
Важно. Не отправляйте ключ агенту в чат, в Telegram или по почте. Он вставляется только в админ-панель. Если ключ мог утечь, удалите его на openrouter.ai/settings/keys и создайте новый.
Шаг 4. Добавьте ключ в Neiron
- Откройте админ-панель и нажмите на шестерёнку в правом верхнем углу.
- Перейдите на вторую вкладку — API-ключи.
- Выберите OpenRouter, вставьте ключ и сохраните.
Шаг 5. Выберите модель
- Откройте каталог моделей: openrouter.ai/models.
- Оставьте только модели, которые умеют работать с инструментами. Эта ссылка сразу включает нужный фильтр: модели с поддержкой tools. Модель без инструментов может переписываться, но не сможет читать файлы, запускать навыки и работать с сервисами. Для агента она бесполезна.
- Откройте страницу модели. Там указаны:
- ID модели вида
компания/модель, например moonshotai/kimi-k3. Его нужно скопировать; - цена за 1 млн токенов — отдельно за вход (что модель читает) и за выход (что пишет);
- контекст — сколько текста модель удерживает за один раз.
Модели с пометкой :free бесплатные, но с лимитом: 20 запросов в минуту и 50 в день, после пополнения на $10 — 1000 в день. На одну задачу агент делает несколько запросов, поэтому бесплатных моделей хватит только на то, чтобы попробовать.
Шаг 6. Переключите агента на модель
- Админ-панель → агент в списке слева → раздел «Модель и размышление».
- Провайдер — OpenRouter.
- В поле «LLM модель» вставьте ID модели целиком, вместе с названием компании:
moonshotai/kimi-k3, а не kimi-k3. - Нажмите «Сохранить настройки». Диалог с агентом при этом не теряется.
- Проверьте работу: дайте агенту задачу с действием, например «прочитай свою память и перескажи её в трёх пунктах». Если агент справился, через пару минут запрос появится на странице openrouter.ai/activity.
Сколько это стоит
- Цена — по тарифу модели, он указан на её странице. Цены меняются, сверяйтесь перед выбором.
- Агент тратит заметно больше, чем обычный чат. В каждый запрос уходят инструкции агента, его память и список навыков — это десятки тысяч токенов. На одну задачу приходится несколько запросов.
- Больше всего съедают задачи по расписанию, которые часто запускают модель. Такие задачи делайте скриптами без ИИ или запускайте реже — см. Задачи по расписанию.
- Расход по дням, моделям и ключам — на openrouter.ai/activity, остаток баланса — на openrouter.ai/settings/credits.
Совет. Начните с одного второстепенного агента и лимита $10–20 на ключе. Через пару дней посмотрите расход в Activity и решите, переводить ли на эту модель других агентов.
Какую модель выбрать
- Основная работа агентов — Claude или GPT. Они лучше всего справляются с многошаговыми задачами и инструментами. Через OpenRouter они тоже доступны.
- Много простых однотипных задач (разобрать, классифицировать, коротко ответить) — недорогие модели: DeepSeek, Qwen, GLM и другие. Проверьте их сначала на одном агенте.
- Если модель ошибается или бросает задачу на полпути, переключите агента на более сильную. Это делается одной строкой в настройках.
Если не работает
| Что видите | Что делать |
|---|
| Ошибка 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. Подойдёт тот же, под которым вы заходите в ChatGPT, или новый.
- Зарубежная банковская карта. OpenAI не принимает карты российских банков. Предоплаченные и подарочные карты тоже не принимаются. Как оформить карту — шаг 1 на странице Как подключить подписку Claude.
- VPN со страной из списка, где OpenAI работает: например Нидерланды, Германия, Казахстан, Армения, Грузия, Турция или Сербия. России и Беларуси в списке нет. Страну VPN не меняйте от регистрации до первого пополнения, а платёжный адрес укажите в этой же стране — шаги 3–4 на странице Как подключить подписку Claude.
- Вход в админ-панель Neiron с правами на настройки компании.
Важно. OpenAI предупреждает, что доступ из страны вне списка может привести к блокировке аккаунта, а карту банка из такой страны платёж не пройдёт. Поэтому VPN, карта и платёжный адрес должны быть из поддерживаемых стран.
1. Войдите на платформу OpenAI
- Включите VPN и проверьте, какую страну показывает ваш IP-адрес, например на 2ip.io.
- Откройте platform.openai.com. Это кабинет для разработчиков: отдельный сайт, но логин и пароль те же, что в ChatGPT. Войдите или зарегистрируйтесь, можно через Google.
- При первом входе OpenAI может спросить название организации. Впишите название компании или своё имя — на работу это не влияет.
2. Привяжите карту и пополните баланс
- Нажмите на шестерёнку (Settings) в правом верхнем углу и откройте Organization → Billing.
- Нажмите Add payment details. Введите номер карты, срок действия, CVV, имя и фамилию латиницей, страну и адрес — те же, что подготовили для VPN, и почтовый индекс.
- Выберите сумму первого пополнения. Минимум $5, по умолчанию предлагается $10. Для голосовых этого хватит надолго, см. раздел «Сколько это стоит».
- Проверьте переключатель Use auto-reload (автопополнение). При настройке он включён по умолчанию. Рекомендуем выключить его, пока не увидите реальный расход. Позже автопополнение можно включить: задать порог баланса, сумму пополнения и месячный лимит.
- Подтвердите покупку. Баланс появится в Billing → Overview в поле Credit balance.
Купленные кредиты действуют 1 год и не возвращаются. Когда баланс кончается, расшифровка останавливается, пока вы не пополните его снова.
3. Ограничьте расход
Чтобы расход не вышел из-под контроля, поставьте месячный лимит: Settings → Organization → Limits → Edit spend limit. Впишите сумму, например $20, и включите Enforce a hard limit — при достижении лимита запросы остановятся до начала следующего месяца. Там же можно задать порог для уведомления на почту.
4. Создайте API-ключ
- Откройте platform.openai.com/api-keys (Settings → API keys).
- Нажмите + Create new secret key.
- Дайте ключу имя, например
Neiron, проект оставьте Default project, права — All. Нажмите Create secret key. - При создании первого ключа OpenAI просит подтвердить номер телефона кодом из SMS. Если ваш номер не принимается, используйте номер из страны, где OpenAI работает.
- Ключ вида
sk-… показывается один раз. Сразу скопируйте его и переходите к следующему шагу. Если ключ потерялся, создайте новый, а старый удалите.
5. Вставьте ключ в Neiron
- Войдите в админ-панель.
- Нажмите на шестерёнку в правом верхнем углу — откроется окно настроек компании.
- Перейдите на вкладку «API-ключи» (вторая вкладка).
- Вставьте ключ в поле 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-бота.
Все агенты создаются и настраиваются через админ-панель.
Роли агентов
У каждого агента есть роль, которая определяет его возможности.
Директор
- Может создавать новые подключения (коннекторы), инструкции и навыки.
- Может ставить задачи подчинённым агентам (если они есть).
- Основная точка входа для собственника.
- Знает всю структуру компании.
- Собирает сводки и отчёты.
Пример: главный агент компании — Директор. Он принимает ваши запросы и координирует всю работу.
Сотрудник (работник)
- Работает по уже созданным навыкам.
- Выполняет конкретные задачи в своей области.
- Не может создавать новые навыки или подключения — только использовать.
Примеры: агент-аналитик, агент-закупщик, агент-маркетолог, персональный агент сотрудника.
Публичный агент
- Может общаться с внешними пользователями (клиентами, лидами).
- Имеет доступ только к своим данным.
- Не имеет доступа к общим файлам компании и общим навыкам — работает в изолированной среде.
- Отвечает на заявки и вопросы, обрабатывает входящие обращения.
- Может отправлять сообщения в корпоративный чат, например пересылать заявки (настраивается в админ-панели).
Иерархия агентов: руководитель и подчинённый
Кроме роли, агенты различаются по положению в иерархии.
Руководитель
Агент, у которого есть подчинённые агенты. Руководитель:
- может ставить задачи своим подчинённым;
- видит логи и сообщения подчинённых агентов;
- может писать через подчинённых сотрудникам или в чаты Telegram;
- имеет доступ к файлам подчинённых агентов.
Подчинённый
Агент, у которого есть руководитель. Подчинённый:
- выполняет задачи, которые ставит руководитель;
- если у него самого нет подчинённых — не может ставить задачи другим агентам и читать их логи.
Главный агент (Директор + Руководитель)
├── Агент-закупщик (Сотрудник + Подчинённый)
├── Агент-маркетолог (Сотрудник + Руководитель)
│ └── Специалист по рекламе (Сотрудник + Подчинённый)
├── Агент-ассистент (Сотрудник + Подчинённый)
└── Публичный агент (Публичный + Подчинённый)
Примеры специализаций агентов-сотрудников
| Агент | Что делает |
|---|
| Аналитик | Отчёты, динамика, аномалии, сравнения |
| Закупщик | Остатки, заявки, поставщики, подсорт |
| Маркетолог | Реклама, акции, СПП, A/B-тесты |
| Контентщик | Видео, карточки, SEO, инфографика |
| Менеджер по клиентам | Отзывы, вопросы, претензии |
| HR-агент | Сводки по команде, расшифровки, KPI |
| Персональный ассистент | Помощник конкретного сотрудника |
Как агент «знает» ваш бизнес?
При запуске агент получает:
- Системный промпт — его роль, правила, характер.
- Базу знаний компании — продукты, KPI, правила.
- Личную память — накопленную историю взаимодействий.
- Навыки — инструкции, как выполнять конкретные задачи.
Чем дольше агент работает, тем лучше он знает ваш бизнес. Знания накапливаются в файлах и не теряются.
Модель ИИ агента
Каждый агент работает на своей языковой модели (LLM), модель выбирается для каждого агента отдельно. Сначала подключите подписку или API-ключ — см. Подключение ИИ.
Принцип экономии: не всем задачам нужна дорогая модель.
- Простые задачи (форматирование, стандартные отчёты) → экономичная модель.
- Сложные задачи (анализ, стратегия, нестандартные ситуации, разработка) → мощная модель.
Модель можно поменять в любой момент, диалог с агентом при этом не теряется.
Как создать агента
Агента создают в админ-панели. Можно попросить об этом команду Neiron: пришлите ей токен бота в личные сообщения.
Шаг 1. Создайте Telegram-бота
- Откройте в Telegram @BotFather и нажмите «Open» (или отправьте команду
/newbot). - Выберите «Create a new bot», задайте имя и username бота, например
company_sales_bot. - Скопируйте токен бота — строку вида
123456789:AAF....
Подробная инструкция — через мини-приложение или командами, настройки для групп, что делать с токеном — в разделе Каналы общения.
Если агент будет работать только в веб-чате, этот шаг можно пропустить.
Важно. Токен бота — это ключ доступа к боту. Не отправляйте его в группы.
Шаг 2. Добавьте агента в админ-панели
- Перейдите на app.neiron.org.
- Создайте нового агента.
- Вставьте токен Telegram-бота.
- Выберите языковую модель.
- Привяжите агента к нужным сотрудникам.
- Пропишите промпт: роль, правила, характер агента.
Шаг 3. Проверьте
Откройте бота в Telegram, нажмите «Старт» и напишите что-нибудь. Если агент молчит, проверьте, что подписка ИИ подключена и у агента выбрана модель.
Настройки агента в админ-панели
Откройте админ-панель и нажмите на агента в списке слева.
| Настройка | Где найти | Что делает |
|---|
| Тип | Переключатель справа от имени агента | Роль агента: директор, сотрудник или публичный |
| Промпт | Настройки агента | Роль, правила, характер: кто он и как работает |
| Telegram-бот | Настройки агента → «Telegram бот» | Токен бота и его @username. Бота можно заменить — агент и его память останутся |
| Модель | Раздел «Модель и размышление» → «LLM модель» | Провайдер (Claude, OpenAI, DeepSeek или OpenRouter) и модель. Подробнее — Подключение ИИ |
| Размышление | Раздел «Модель и размышление» | Насколько глубоко агент обдумывает задачу: глубже — точнее, но дольше и дороже |
| Лимит ходов на запуск | Раздел «Модель и размышление» | Сколько шагов агент может сделать за один запуск |
| Чаты | Вкладка «Связи» → «Telegram чаты» | Групповые чаты, где работает агент |
| Коннекторы | Вкладка «Коннекторы» → «Персональные коннекторы» | Подключения, выданные лично этому агенту |
| Навыки | Навыки агента | Какие навыки есть у агента. У навыка можно указать отдел |
После изменений нажмите «Сохранить настройки».
Совет. Агент останавливается посреди длинной задачи? Увеличьте «Лимит ходов на запуск», например на 15, или разбейте задачу на части.
Отделы. Агентов можно объединять в отделы. От отдела зависит, какие навыки, подключения и подписка ИИ доступны агенту. Подробнее — в разделах Навыки и Подключение сервисов.
Как добавить агента в групповой чат
Шаг 1. Разрешите боту работать в группах
В @BotFather откройте своего бота → «Bot Settings»:
- «Groups and Channels» (чаты и каналы) — разрешите группы, иначе бота нельзя будет добавить в чат;
- «Group Privacy» — выключите (Turn off), чтобы бот читал сообщения группы, а не только команды. То же делает команда
/setprivacy → Disable. Если бот уже был в группе, после этого удалите его из группы и добавьте заново.
Шаг 2. Добавьте бота в чат
Добавьте бота в группу как обычного участника. Ищите его по @username — он указан в админ-панели в настройках агента, «Telegram бот». Система автоматически обнаружит новый чат.
Если бот не добавился автоматически
- Узнайте ID группы, например через бота @userinfobot: выберите в нём нужную группу.
- Админ-панель → агент → вкладка «Связи» → «Telegram чаты» → «+».
- Введите ID группы. Галочки настроек оставьте включёнными.
Память агентов
Раздел: Документация Neiron. Обновлено: 28.09.2026, версия 2. Адрес для людей: https://neiron.org/docs/pamyat-agentov/
Как агент запоминает
Агент не теряет контекст между разговорами — у него есть постоянная память в виде файлов.
Структура памяти
- Долгосрочная память агента (MEMORY.md). Отобранные ключевые факты, стратегические решения, выводы. Этот файл подгружается в каждый разговор агента. Здесь — суть, а не сырые логи.
- Ежедневные записи. Сырые заметки о том, что происходило за день. Со временем важное из них переносится в долгосрочную память.
- Данные о компании (общие для всех агентов). Общая база знаний компании: продукты, правила, KPI, стратегия. Доступна всем агентам компании.
- Память о сотруднике. На каждого сотрудника, с которым работает агент, ведётся отдельная папка:
- 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) | Директор Ромашка | Любое, на любом языке. Видно в списке чатов и в профиле бота. Можно поменять потом |
| Username | romashka_ceo_bot | 5–32 символа: латиница, цифры и _. Обязательно заканчивается на bot. Должен быть свободен. Поменять потом нельзя |
Совет. Называйте ботов по роли агента: romashka_ceo_bot, romashka_sales_bot, romashka_buh_bot. Так сотрудники не перепутают, кому писать.
Способ 1. Через мини-приложение BotFather
- Откройте в Telegram чат с @BotFather.
- Нажмите кнопку «Open» («Открыть») рядом с полем ввода сообщения. Откроется окно BotFather со списком ваших ботов. Открыть его можно и по ссылке t.me/botfather?startapp.
- Нажмите «Create a new bot».
- Введите имя бота и username и подтвердите создание.
- Откроется страница нового бота. Нажмите «Copy» рядом с токеном — токен скопируется.
- Вставьте токен в админ-панели при создании агента. Если агента создаёт команда Neiron — пришлите токен ей в личные сообщения.
На странице бота в мини-приложении можно сразу поставить аватар, описание и настройки для групп (см. ниже).
Примечание. Названия кнопок в мини-приложении зависят от языка Telegram и версии приложения. Если кнопки называются иначе, ищите по смыслу: «создать бота», «настройки бота», «скопировать».
Способ 2. Через команды в чате
- Откройте чат с @BotFather. Если открываете впервые, нажмите «Старт» (Start).
- Отправьте команду
/newbot. - BotFather попросит имя бота («Please choose a name for your bot»). Отправьте имя, например:
Директор Ромашка. - Затем он попросит username («Now let's choose a username for your bot. It must end in
bot»). Отправьте username, например: romashka_ceo_bot. Если BotFather ответит, что username занят или не подходит, придумайте другой и отправьте снова. - BotFather пришлёт сообщение «Done! Congratulations on your new bot» со ссылкой на бота. Токен стоит после строки «Use this token to access the HTTP API». Он выглядит так:
123456789:AAF... — цифры, двоеточие и длинная строка из букв и цифр. Нажмите на токен — он скопируется. - Вставьте токен в админ-панели при создании агента или пришлите его команде Neiron в личные сообщения.
Передумали на любом шаге — отправьте /cancel.
Токен: как хранить и что делать, если он утёк
- Токен — полный ключ к боту. Кто его знает, может писать от имени бота и читать сообщения, которые ему присылают. Храните токен как пароль: не пересылайте в группы, не публикуйте на скриншотах.
- Где он нужен. Админ-панель → агент → настройки → «Telegram бот». Бота можно заменить там же: агент и его память останутся.
- Посмотреть токен ещё раз: @BotFather →
/mybots → ваш бот → «API Token». Или откройте страницу бота в мини-приложении. - Токен утёк: @BotFather →
/mybots → ваш бот → «API Token» → «Revoke current token». Старый токен сразу перестанет работать. Новый вставьте в админ-панели в настройках агента («Telegram бот»), иначе агент замолчит.
Важно. Один бот — один агент. Не подключайте тот же токен к другим сервисам (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, а владеть им должна компания? Бота можно передать:
- Новый владелец открывает @BotFather и нажимает «Старт».
- Нынешний владелец: @BotFather →
/mybots → бот → «Transfer Ownership» → выбирает нового владельца и подтверждает облачным паролем Telegram.
Передача необратима: вернуть бота сможет только новый владелец. Для передачи у владельца должен быть включён облачный пароль (двухэтапная аутентификация). Если его включили недавно, Telegram может разрешить передачу только через несколько дней. После передачи напишите агенту и проверьте, что он отвечает.
Если что-то не получается
| Проблема | Что сделать |
|---|
| BotFather пишет, что username занят или не подходит | Придумайте другой: латиница, цифры и _, в конце bot |
| Бота нельзя добавить в группу | Разрешите группы: /setjoingroups → Enable |
| В группе бот не видит обычные сообщения, только команды и ответы ему | Выключите режим приватности (/setprivacy → Disable), удалите бота из группы и добавьте заново |
| Бот не пишет сотруднику | Сотрудник должен один раз открыть бота и нажать «Старт» |
| BotFather не даёт создать ещё одного бота | У Telegram есть лимит ботов на один аккаунт. Удалите ненужного (/deletebot) или создайте бота с другого аккаунта |
| Агент молчит | Проверьте, что токен вставлен в настройках агента («Telegram бот») и подключена подписка ИИ. Токен перевыпускали — вставьте новый |
Веб-чат
Веб-чат — работа с агентами в браузере: chat.neiron.org. Сотрудник входит по email и паролю и видит только тех агентов, которых ему назначил администратор.
- Сессии и проекты. В проекте можно объединить нужных агентов и общие файлы.
- Видно больше, чем в Telegram: действия агентов, расписания, результаты в виде таблиц.
- Как приложение. В Chrome веб-чат можно установить на компьютер и открывать отдельным окном, как обычную программу.
Новая сессия не переносит историю предыдущей автоматически. Чтобы продолжать работу с контекстом, используйте файлы проекта, сохранённые планы и другие материалы проекта.
WhatsApp
Агента можно подключить к номеру WhatsApp — например, чтобы публичный агент принимал заявки клиентов. Чтобы подключить номер, напишите команде Neiron.
- Агент отвечает в личных чатах этого номера. Сообщения, которые вы сами пишете с телефона, тоже попадают в историю.
- В WhatsApp агент отвечает только текстом. Файлы и отчёты он присылает в Telegram или веб-чат.
- Если у агента есть навыки, написанные под Telegram (например, «сообщить менеджеру о новом лиде»), проверьте их на заявке из WhatsApp.
Важно. Подключайте отдельный рабочий номер, а не личный. Мессенджер может ограничить номер, с которого приходит много автоматических ответов.
Дашборд
В дашборде компании агенты показывают цифры и отчёты. Под виджетами бывают кнопки, которые отправляют агенту готовое сообщение или ставят ему задачу. А законченную работу агент присылает карточкой результата: что сделано, что проверено. Подробнее — в разделе Дашборд.
Как правильно писать агенту
Будьте конкретны
| Плохо | Хорошо |
|---|
| «Как дела?» | «Покажи топ-10 артикулов по выручке за апрель» |
| «Что-нибудь по остаткам» | «Какие артикулы в красной зоне по остаткам на WB? Сколько дней осталось?» |
Давайте контекст
«Акция на WB заканчивается послезавтра. Какие артикулы стоит повысить в цене и на сколько?»
Просите конкретный формат
«Дай сводку в виде таблицы: артикул, текущий остаток, рекомендация»
Уточняйте действие
| Что написать | Когда |
|---|
| «Только проанализируй» | Нужны данные, без действий |
| «Выполни» | Агент должен что-то сделать: выгрузить файл, отправить заявку |
| «Предложи варианты» | Нужна помощь с решением |
Управление через текст
Агент понимает обычный язык, команды знать не нужно:
| Что вы пишете | Что делает агент |
|---|
| «Запомни, что наш приоритет — маржинальность, а не оборот» | Записывает в память |
| «Каждый понедельник в 9:00 присылай мне сводку продаж» | Создаёт задачу по расписанию |
| «Отправь это Ивану» | Пересылает указанному сотруднику |
| «Сохрани это в базу знаний» | Добавляет в wiki |
| «Научись делать X» | Создаёт новый навык (только агент-директор) |
Файлы и вложения
Через Telegram и веб-чат можно:
- отправить агенту файл (Excel, PDF, CSV) — он его прочитает и обработает;
- получить от агента файл — отчёт, выгрузку, результат работы;
- отправить фото — агент его проанализирует (карточка товара, скриншот кабинета). Несколько фото в одном сообщении обрабатываются одним запросом.
Пример:
Вы → [прикрепляете файл прайса поставщика]
«Сравни с нашими текущими ценами закупки и покажи, где можем сэкономить»
Голосовые сообщения
Агенту можно отправлять голосовые сообщения. Голосовые расшифровывает модель OpenAI по API, поэтому в настройках компании нужен ключ OpenAI API с балансом. Без ключа агент попросит написать текстом. Как выпустить ключ, привязать карту и вставить ключ в настройки компании — на странице Распознавание голосовых сообщений.
Вопросы с вариантами ответа
Если для задачи агенту не хватает вашего решения, в личном чате или в веб-чате он может задать до четырёх вопросов с готовыми вариантами ответа. Нажмите кнопку или напишите свой вариант — агент продолжит работу, когда получит все ответы.
Уведомления от агентов
Агенты могут сами вам писать, а не только отвечать:
- по расписанию — «Доброе утро, вот сводка на сегодня»;
- по триггеру — «Внимание: артикул 12345 вышел в красную зону по остаткам»;
- по результату задачи — «Заявка поставщикам отправлена, жду ответов»;
- по ошибке — «Не смог подключиться к кабинету WB, нужна авторизация».
Вы можете настроить, какие уведомления хотите получать и в каком чате.
Примечание. Бот в 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. Сервис есть в библиотеке
- Откройте библиотеку в админ-панели и перейдите на вкладку «Коннекторы».
- Найдите сервис в списке и нажмите на него. Откроется окно с инструкцией: какие данные нужны и где их взять.
- Дальше один из двух вариантов:
- Ключ или токен. Возьмите его в кабинете сервиса по инструкции, впишите в поля коннектора и сохраните.
- Вход через аккаунт (например, сервисы Яндекса). Нажмите «Подключить» и войдите в свой аккаунт этого сервиса. Ключ вписывать не нужно.
- Выберите, кому доступно подключение: всей компании, отделу или конкретному агенту (см. ниже).
Ключ, вписанный в библиотеке, не проходит через переписку с агентом. Это самый безопасный способ.
Способ 2. Сервиса нет в библиотеке — через агента-директора
Шаг 1. Скажите агенту
«Хочу подключить нашу CRM, вот документация её API»
«Добавь интеграцию с 1С»
Если у сервиса есть документация API, сразу пришлите на неё ссылку: так агент быстрее разберётся.
Шаг 2. Агент создаёт коннектор
Агент изучит документацию сервиса и составит инструкцию: какие данные нужны для подключения (API-ключ или токен, адрес сервиса, логин технического пользователя) и где их взять. Затем создаст коннектор.
Шаг 3. Впишите данные в админ-панели
Откройте в админ-панели коннектор, который создал агент, нажмите на него и впишите данные по инструкции агента.
Важно. Данные доступа можно прислать и самому агенту, но мы так делать не советуем: пока сообщение лежит в переписке, его видит языковая модель. Если всё же присылаете, то только агенту-директору в личный чат, никогда в группу. Удалите сообщение сразу, как агент подтвердит, что сохранил данные.
Шаг 4. Агент проверяет подключение
Попросите агента проверить подключение: «Проверь подключение к CRM — покажи последние сделки». Он убедится, что получает данные, а если что-то не так, попросит проверить ключ.
Кто может создавать коннекторы: только агент с ролью Директор. Агенты-сотрудники пользуются уже настроенными подключениями, но не создают новые.
Кому доступно подключение
| Уровень | Кто пользуется | Как настроить |
|---|
| Вся компания | Все агенты компании, кроме публичных | По умолчанию |
| Отдел | Только агенты этого отдела, например почта отдела продаж | При подключении выберите отдел |
| Конкретный агент | Только этот агент | Админ-панель → агент → вкладка «Коннекторы» → «Персональные коннекторы» → «+» |
Публичный агент получает подключение только персонально: общие и отдельские ему не выдаются.
Одну систему можно подключить несколько раз с разными правами. Например, 1С «только чтение» для всех и 1С «с правом записи» для агента бухгалтерии.
То же можно попросить словами:
«Подключи почту Ивана и дай доступ только агенту продаж»
Программировать ничего не нужно
При подключении вашей компании основные системы вы подключаете вместе с менеджером Neiron:
- На созвоне вместе составляем список сервисов, с которыми вы работаете. Менеджер записывает его и отмечает, какие сервисы уже есть в библиотеке.
- На созвоне менеджер показывает, как подключить каждый сервис в админ-панели. Ключи вы вписываете сами, пересылать пароли никому не нужно.
- Сервисы, которых нет в библиотеке, подключаем через вашего агента-директора (способ 2).
- Готово — агент работает с системами.
Дальше новые подключения вы делаете сами — через библиотеку или агента-директора.
Несколько кабинетов — не проблема
Если у вас несколько кабинетов на WB/Ozon или несколько компаний — можно подключить все. Агент будет работать со всеми кабинетами и при необходимости сводить данные вместе:
«Покажи сравнение продаж между кабинетом 1 и кабинетом 2 за прошлую неделю»
Агент не хранит ваши пароли
При работе ключ берёт скрипт коннектора прямо из зашифрованного хранилища, а агенту возвращает только данные. Поэтому ключа нет ни в памяти агента, ни в его файлах. Подробнее — в разделе Безопасность.
Навыки
Раздел: Документация Neiron. Обновлено: 28.09.2026, версия 2. Адрес для людей: https://neiron.org/docs/navyki/
Что такое навык
Навык — это инструкция для агента, как выполнять конкретную задачу.
Без навыка агент каждый раз «думает заново»: анализирует запрос, вырабатывает подход, делает. На это уходят токены и время, и результат может каждый раз немного отличаться.
С навыком агент действует по готовой инструкции — быстро, предсказуемо, без лишних токенов.
Аналогия: навык — как должностная инструкция сотрудника. Один раз написали «как делать закупки» — сотрудник (агент) всегда делает по ней, без повторного объяснения.
Как появляется навык
Способ 1. Агент сам предлагает
После того как вы несколько раз повторили похожие задачи, агент может предложить:
«Вы несколько раз просили отчёт в таком формате. Хотите, закреплю это как навык "Еженедельный отчёт по продажам"?»
Вы говорите «да» — навык создан.
Способ 2. Вы просите явно
«Запомни этот подход к формированию заявок — сделай навык»
«Закрепи как рабочий этот сценарий работы с поставщиками»
«Научись делать автоматические ответы на отзывы по такому шаблону»
Способ 3. Готовый навык из библиотеки
В админ-панели есть библиотека готовых навыков — см. раздел ниже.
Способ 4. Навык создаёт команда Neiron
При внедрении команда Neiron создаёт базовые навыки под ваши бизнес-процессы.
Примечание. Создавать новые навыки может только агент с ролью Директор. Агенты-сотрудники могут только использовать уже созданные навыки.
Готовые навыки из библиотеки
- Откройте библиотеку в админ-панели и перейдите на вкладку «Навыки».
- Выберите нужный навык и подключите его.
- Если навык работает с внешним сервисом, сначала подключите этот сервис на вкладке «Коннекторы». Например: сначала коннектор MPStats, потом навык аналитики MPStats.
Нужного навыка в библиотеке нет — попросите агента-директора его создать.
Примеры навыков
| Навык | Что делает |
|---|
| weekly-sales-report | Формирует еженедельный отчёт по продажам в вашем формате |
| stock-alert | Проверяет остатки и выдаёт список «красных» артикулов |
| supplier-request | Формирует и отправляет стандартную заявку поставщику |
| price-proposal | Строит таблицу с предложениями по ценам для подтверждения |
| review-response | Отвечает на отзывы покупателей в вашем стиле |
| content-brief | Создаёт ТЗ для нового контента по вашим шаблонам |
Как использовать навык
Просто опишите задачу — агент сам определит, какой навык подходит, и запустит его:
«Сделай отчёт по продажам за эту неделю»
→ агент запускает навык weekly-sales-report
Можно запустить явно:
«Запусти навык проверки остатков»
«Используй шаблон для ответа на этот отзыв»
Общие и личные навыки
Общие навыки компании доступны всем агентам (кроме публичного). Например, правила ответов клиентам, формат отчётов, стандарты контента.
Личные навыки агента — только для конкретного агента. Например, специфическая логика закупщика, которая не нужна другим.
Если у агента есть личный навык с тем же именем, что и общий, — личный имеет приоритет.
Директор может создавать как общие навыки компании, так и личные навыки конкретного агента.
Как раздать навык:
- Подчинённому агенту — попросите директора: «Передай навык отчётов агенту-аналитику».
- Всей компании — «Сделай навык проверки остатков общим для компании».
- Одному отделу — админ-панель → агент, у которого есть навык → кнопка редактирования навыка → поле «Отдел». Навык, привязанный к отделу, доступен только агентам этого отдела.
Навыки можно копировать между агентами
Если один агент научился делать что-то хорошо, этот навык можно дать другому агенту:
«Скопируй навык формирования отчётов от агента аналитики агенту-ассистенту Ивана»
Так лучшие практики быстро расходятся по вашей компании.
Навыки с подключением к внешним системам
Некоторые навыки работают с внешними API (например, скачивают данные из кабинета WB или обращаются к 1С). Такие навыки устроены чуть сложнее: у них есть скрипт, который выполняет технические действия.
Для вас это выглядит так же — просто просите задачу:
«Скачай текущие остатки из кабинета WB по всем артикулам»
Агент сам запускает нужный скрипт, получает данные, обрабатывает и выдаёт результат.
Навык-скрипт без ИИ. Если задача не требует рассуждений (выгрузить данные, обновить таблицу, проверить оплату), навык можно сделать чистым скриптом. Он выполняется без языковой модели, не тратит лимиты подписки и всегда работает одинаково. Такие навыки удобно ставить на расписание:
«Сделай выгрузку остатков скриптом без ИИ и запускай каждый час»
Как убедиться, что навык работает правильно
После создания навыка попросите агента его протестировать:
«Запусти навык на тестовых данных и покажи результат»
«Выполни навык так, как если бы сейчас был понедельник»
Если результат не тот — дайте обратную связь:
«Не то, хочу видеть ещё столбец с маржой. Обнови навык.»
Задачи по расписанию
Раздел: Документация 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 по московскому времени — еженедельный отчёт в нашу группу "Отчёты"»
Куда приходят уведомления
Уведомления можно направить:
- лично вам — в личный чат с агентом;
- в группу — в конкретный Telegram-чат;
- в топик группы — в конкретную тему форума;
- нескольким людям — разным сотрудникам одновременно.
Задачи без уведомлений
Не все задачи должны присылать сообщения. Иногда нужно просто выполнить действие фоном:
«Каждую ночь обновляй данные о ценах конкурентов в нашей базе знаний — результат не присылай, просто обновляй файл»
Агент выполнит задачу и ничего не пришлёт — только обновит данные.
Одноразовые отложенные задачи
Можно запланировать действие на конкретное время:
«Завтра в 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 директор-агент не делает всё сам — он распределяет задачи между специализированными агентами, как настоящий руководитель.
Вы пишете директору → директор решает, кому передать →
подчинённый агент выполняет → директор проверяет →
вы получаете финальный результат
Вам не нужно знать, кто именно выполняет задачу. Вы общаетесь только с директором.
Пример делегирования
Вы пишете директору:
«Подготовь план закупок на следующий месяц с учётом сезонности и остатков»
Что происходит «за кулисами»:
- Директор анализирует задачу.
- Передаёт агенту-аналитику: «собери данные по остаткам и сезонной динамике».
- Передаёт агенту-закупщику: «на основе данных аналитика составь план заявок».
- Получает результаты от обоих.
- Проверяет и собирает финальный документ.
- Отправляет вам готовый план.
Вы видите только финальный ответ. Всю координацию делает директор.
Как правильно ставить задачи
Формула хорошей задачи
ЧТО нужно сделать + ЗАЧЕМ / КОНТЕКСТ + КРИТЕРИЙ ГОТОВНОСТИ
Примеры:
| Плохо | Хорошо |
|---|
| «Посмотри закупки» | «Проверь остатки по всем артикулам. Выдели те, у которых осталось меньше 20 дней. Сформируй заявку для топ-5 поставщиков по объёму.» |
| «Сделай отчёт» | «Сделай еженедельный отчёт по продажам: выручка, маржа, топ-10 артикулов, аномалии. Формат — таблица плюс текстовый вывод на 3–5 строк.» |
Задачи с подтверждением
Для критичных действий (изменение цен, отправка заявок поставщикам) агент по умолчанию спрашивает подтверждение, прежде чем действовать:
Агент: «Подготовил заявку для поставщика ООО "Ткани". Артикулы: [список], сумма: 340 000 ₽. Отправить?»
Вы: «Да, отправляй»
Агент: «Заявка отправлена, ожидаю ответа»
Это правило в инструкциях агента, а не техническая блокировка. Чтобы оно действовало всегда, закрепите его в правилах компании, например: «Цены и заявки поставщикам — только после моего "да"». Подробнее — в разделе Безопасность.
Задачи для нескольких агентов параллельно
Если задача сложная, директор может запустить несколько агентов одновременно.
Пример:
«Нужно принять решение по новому SKU. Подготовь: анализ конкурентов в нише, расчёт юнит-экономики, контент-план для запуска»
Директор запустит аналитика, финансиста и контентщика параллельно, соберёт все результаты и выдаст вам сводное решение.
Задачи с отложенным сроком выполнения
Можно указать, когда задача должна быть запущена:
«В пятницу утром — скинь анализ конкурентов»
«В следующий четверг в 9 утра скинь отчёт по закупкам»
Куда прислать результат
По умолчанию итог приходит туда, откуда вы написали. Можно попросить иначе:
«Когда закончишь, пришли итог в группу "Отчёты"»
«Результат отправь Ивану в личку»
«Сделай в фоне, мне ничего не присылай — просто сохрани результат»
Как узнать, что с задачей
Спросите директора:
«Что с задачей по плану закупок? Кто её делает и на каком этапе?»
Директор проверит статус поручений у подчинённых и ответит. Если результат подчинённого его не устроил, он сам вернёт задачу на доработку и пришлёт вам уже исправленный итог.
Итерации и уточнения
Агент не всегда делает всё идеально с первого раза — и это нормально. Работайте итерациями:
Вы: «Сделай анализ»
Агент: [выдаёт результат]
Вы: «Хорошо, добавь сравнение с прошлым месяцем»
Агент: [дополняет]
Вы: «Теперь сохрани это как шаблон для еженедельных отчётов»
Агент: [создаёт навык с шаблоном]
Совет. Когда агент сделал что-то правильно, скажите «запомни этот подход» или «закрепи как рабочий». Он запишет сценарий в навык и будет делать так всегда.
Дашборд
Раздел: Документация Neiron. Обновлено: 28.09.2026, версия 1. Адрес для людей: https://neiron.org/docs/dashbord/
Что это
Дашборд компании — ваши рабочие страницы в браузере: цифры, графики, таблицы, списки, задачи. Собирают и обновляют их агенты по вашей просьбе, программировать ничего не нужно. Сотрудники открывают дашборд после входа и видят только те разделы, которые для них открыты.
Не путайте с дашбордом админ-панели: там расход токенов и работа агентов. Дашборд компании — про ваш бизнес.
Как устроен
- Разделы — крупные блоки: «Продажи», «Финансы», «Склад». Раздел виден всей компании или только выбранным отделам.
- Страницы — внутри раздела, например «Продажи → Обзор» и «Продажи → Воронка».
- Виджеты — карточки на странице. Ширина задаётся долей строки, как в сетке из 12 колонок: 12 — на всю ширину, 6 — половина, 4 — треть.
| Виджет | Для чего |
|---|
| Показатель (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? Его агенты ничего о вас не знают.
Что хранится в файлах памяти агентов
В файлах памяти хранится:
- история разговоров;
- ваши решения и договорённости;
- контекст о бизнесе.
В файлах памяти не хранятся:
- пароли и токены;
- конфиденциальные личные данные, которые вы не просили сохранить.
Ваши агенты на ваших аккаунтах
Агенты работают на ваших подписках и аккаунтах (подписка на языковую модель, аккаунты маркетплейсов). Это означает:
- вы платите только за свои токены;
- ваши данные не смешиваются с данными других клиентов 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 напомни отправить отчёт руководителю»
💰 Экономия на токенах
Токены = деньги. Вот как тратить их разумно:
- Используйте навыки. Зафиксированные задачи выполняются без повторного «обдумывания», это дешевле.
- Разделяйте сложные задачи. Лучше несколько простых запросов, чем один огромный.
- Для простых задач — более дешёвая модель. Скажите агенту или команде Neiron, если хотите оптимизировать расходы.
- Фоновые задачи без LLM. Некоторые технические задачи (сбор данных, выгрузки) можно настроить как скрипты без участия языковой модели. Это в разы дешевле.
🔗 Работа в группах
Используйте группы для командных обсуждений
Создайте группу с агентом и командой — тогда задачи можно ставить в общем чате, и все видят результаты.
Топики для разных процессов
Если группа с форумом, создайте топики:
- 📦 Закупки
- 💰 Ценообразование
- 📊 Аналитика
- 📣 Маркетинг
Агент будет отвечать в нужном топике.
🔁 Создание «кругов» — шаг за шагом
Не пытайтесь запустить всё сразу. Лучшая стратегия:
- Автоматизируйте одну самую болезненную задачу — добейтесь, чтобы она работала идеально.
- Создайте навык — зафиксируйте рабочий сценарий.
- Добавьте расписание — запустите задачу автоматически.
- Наблюдайте неделю — убедитесь, что всё работает правильно.
- Переходите к следующей задаче.
Через 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 по будням — сводка каждому. Ставить задачи можно сообщением любому агенту.»
Что понадобится:
- База данных. Задачи лучше хранить в базе, а не в файлах агента: так их видят и дашборд, и все агенты. Если базы нет, попросите команду Neiron её подключить.
- Бот для уведомлений. Каждый сотрудник один раз открывает его и нажимает «Старт», иначе бот не сможет написать первым.
- Список сотрудников с их Telegram — агент сверит его с разделом сотрудников.
Собирайте по шагам: сначала задачи и раздел в дашборде, неделю поработайте, потом добавьте уведомления и сводки. Когда задачник заработает, закрепите в правилах компании: «Задачи сотрудникам ставим только в задачнике, напоминания шлёт только бот задачника». Так агенты не будут дублировать друг друга.
Тикеты для разработки
Раздел: Полезные рекомендации. Обновлено: 28.09.2026, версия 1. Адрес для людей: https://neiron.org/docs/tikety-dlya-razrabotki/
Зачем
Агент-директор умеет писать код: навыки, скрипты, страницы дашборда, сайт, задачи по расписанию. Большая доработка не всегда укладывается в один разговор. Сессия может прерваться, а через неделю уже никто не помнит, что меняли и почему. Тикеты для разработки решают это так же, как у программистов: у каждой доработки есть номер, план, журнал шагов и история кода.
Что умеет
| Функция | Зачем |
|---|
| Реестр тикетов | У каждой доработки номер (DEV-12), цель, критерий приёмки, этап и агент-владелец |
| Этапы | Идея → готово к работе → в работе → на проверке → внедрено |
| Чекпоинты | После каждого шага агент записывает «что сделано» и «что дальше». Прерванная работа продолжается с этого места, а не с начала |
| «Ждём человека» | Тикет, которому нужно ваше решение или доступ, помечается — видно, кто и что держит |
| История кода (git) | Каждое изменение сохраняется с номером тикета: видно, кто и что менял, можно откатить |
| Паспорт проекта | Файл «что работает, какие решения приняты, какие долги и риски». Новый агент быстро входит в контекст |
| Сторож | Если сессия прервалась без записи, через 30 минут вам приходит сообщение: какой тикет и на каком шаге остановился |
| Доска | Раздел дашборда «Разработка»: тикеты по этапам, только для просмотра |
Как работает агент по тикету
- В начале сессии агент смотрит свои незакрытые тикеты. Прерванный продолжает с последнего чекпоинта.
- Берёт тикет в работу. Два агента не возьмут один тикет одновременно.
- После каждого шага пишет чекпоинт и сохраняет код в git.
- Ждёт вашего решения — помечает тикет «ждём человека».
- Закрывает тикет с итогом и записью в паспорт проекта.
Как создать через агента
Напишите агенту-директору:
«Заведи процесс разработки через тикеты. Реестр тикетов в нашей базе данных: номер 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»
Агент просмотрит базу знаний и выдаст подходящий результат.
Автоматическая обработка
Раз в сутки (или по вашему расписанию, хоть каждый час) запускается обработка:
- Агент берёт все материалы, которые вы добавили за день.
- Структурирует их: выделяет ключевые факты, создаёт страницы.
- Обновляет или создаёт нужные разделы в wiki.
- Обновляет общий индекс.
К утру вся вчерашняя информация уже структурирована и доступна для поиска.
Умная обработка материалов на несколько тем
Если вы загрузили большой документ с разными темами (например, расшифровку встречи, где обсуждали и клиентов, и стратегию, и инструменты), агент:
- Анализирует весь документ.
- Разбивает его на смысловые блоки.
- Создаёт отдельные страницы в нужных категориях.
Один файл → несколько аккуратных страниц 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
В нём три части:
- Через что работал агент —
claude_oauth, openai_api и так далее, расшифровка в таблице ниже. - Тип отказа — слово перед двоеточием:
limit, auth, terminal или provider_unknown. - Текст провайдера — всё после двоеточия. Именно он говорит, что случилось.
Важно. Начало «All … subscriptions are exhausted or failed» («Все подписки провайдера … исчерпаны или отказали») ещё не значит, что кончились лимиты. Так платформа начинает любую ошибку подписки. Дальше может оказаться и лимит, и слетевший вход, и слишком большой файл. Решение выбирайте по тексту после двоеточия.
| В тексте ошибки | Что это |
|---|
claude_oauth | подписка Claude |
anthropic_api | API-ключ Claude |
openai_oauth | подписка ChatGPT |
openai_api | API-ключ 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 по Москве.
Что делать:
- Подождать до времени сброса. Агент заработает сам, ничего переподключать не нужно.
- Переключиться на другую подписку, если работа не ждёт. Подключите вторую подписку Claude или ChatGPT: шестерёнка в админ-панели → первая вкладка. Если подписок Claude несколько, платформа сама распределяет запросы между ними.
- Поставить модель полегче: агент → «Модель и размышление» → «LLM модель» → «Сохранить настройки». Самые мощные модели тратят лимит в разы быстрее, а на большинстве задач разницы не видно.
- Докупить продолжение у Anthropic: claude.ai → Settings → Usage → Usage credits → Enable → Add funds. Сверх лимита запросы оплачиваются по тарифам API. По справке Anthropic, это работает и для Claude Code, через который работают агенты.
- Перейти на тариф выше, если лимита не хватает регулярно.
Недельный лимит и лимит самой мощной модели
Кроме 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: в чате лимит может ещё оставаться, а у агента уже кончиться.
Что делать:
- подождать до времени из ошибки (
try again at …); - посмотреть остаток и докупить кредиты на странице chatgpt.com/codex/settings/usage;
- перейти на тариф выше;
- переключить агента на подписку Claude.
Подписка «в паузе после ошибки»
Сейчас нет доступной 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:
- Шестерёнка в правом верхнем углу админ-панели → первая вкладка, подписки.
- «Удалить» рядом с подпиской Claude.
- «Авторизоваться через Claude», войдите в аккаунт и вставьте код в поле, как при первом подключении. Пошагово — на странице Как подключить подписку Claude.
Как переподключить подписку ChatGPT:
- Шестерёнка → первая вкладка → блок OpenAI Codex (ChatGPT) → «Переподключить» или «Авторизоваться через ChatGPT».
- Выберите аккаунт. После входа скопируйте из адресной строки ссылку вида
http://localhost:1455/… и вставьте её в поле в админ-панели. Пошагово — на странице Как подключить подписку ChatGPT.
Чтобы подписка не слетала:
- Заведите для Neiron отдельный аккаунт Claude или 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 сразу и обычно проходит сам, от нескольких минут до нескольких часов.
Что делать:
- Повторить запрос через несколько минут.
- Проверить состояние на status.claude.com.
- Если работа срочная — временно переключить агента на ChatGPT или другого провайдера.
То же самое делайте при похожих ошибках:
| Ошибка | Провайдер | Что это |
|---|
500 api_error, 504 timeout_error | Claude | внутренняя ошибка или таймаут у Anthropic |
500 The server had an error while processing your request, 503 Model temporarily overloaded | OpenAI | сбой или перегрузка у OpenAI, состояние — status.openai.com |
502 | OpenRouter | выбранная модель сейчас недоступна. Выберите другую модель |
503 | OpenRouter | нет свободного поставщика для этой модели. Подождите или выберите другую модель |
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, поэтому подписка для них перестаёт работать.
Что делать — любой из вариантов:
- администратор организации снова включает доступ;
- подключите личную подписку Pro или Max;
- подключите API-ключ Claude.
Слишком большой файл: контекст переполнен
Контекст задачи переполнен: файл или вывод инструмента оказался слишком большим даже после повторной попытки. Сократите задачу или укажите конкретный файл/фрагмент.
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», хотя лимиты тут ни при чём.
Что делать:
- разбейте задачу на части;
- вместо «всё» укажите конкретный файл, лист таблицы или период;
- большие выгрузки попросите обрабатывать скриптом, а не читать целиком;
- если разговор очень длинный, начните его заново командой
/clear в личном чате с агентом. Команда очищает историю разговора, память агента остаётся.
Агент останавливается на середине долгой задачи
Что это. У агента сработал «Лимит ходов на запуск» — сколько шагов он может сделать за одну задачу.
Что делать: агент → «Модель и размышление» → «Лимит ходов на запуск» → увеличьте значение, например на 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, если:
- ошибка из раздела «Ошибки платформы Neiron»;
- сбой у провайдера держится больше пары часов, а на его странице состояния всё в порядке;
- после переподключения подписки ошибка повторяется;
- ошибки нет на этой странице.
Что прислать:
- Полный текст ошибки — скопируйте его текстом, а не скриншотом.
- Какой агент.
- Когда это случилось.
- Что вы попросили агента сделать.