# AgentRunner

> AgentRunner — расширение для 1С:Предприятие 8.3.26+, запускающее автономных ИИ-агентов внутри базы 1С. Любое изменение данных проходит через подтверждение оператором; ведётся неизменяемый журнал; агент действует от прав конкретного пользователя 1С (RLS сохраняется). Ядро под лицензией AGPL-3.0; два пути монетизации — внедрение «под ключ» и платный доступ к нейросетям за рубли через российский шлюз. Полная версия этого файла со всеми материалами — см. раздел «Про этот файл» в конце; лёгкая версия для быстрого просмотра — [/llms.txt](/llms.txt).

## Что это и для кого

- [/](/) — лендинг проекта: первый экран, что такое AgentRunner, для кого (1С-разработчики, внедренцы, ответственные за автоматизацию), системные требования (8.3.26+, только клиент-серверный режим), два способа заработка, вопросы и ответы
- [/docs](/docs) — концентратор документации: быстрый старт, совместимость с типовыми конфигурациями (Бухгалтерия предприятия 3.0, Управление торговлей 11, ERP 2, Зарплата и управление персоналом 3.1), агенты, инструменты, триггеры, безопасность, подключение шлюза
- [/#faq](/#faq) — блок «Вопросы и ответы» с разметкой FAQPage (Schema.org): типовые возражения про безопасность, стоимость, совместимость, 152-ФЗ

## Возможности (агенты, инструменты, расписания)

- [/#features](/#features) — концентратор возможностей: агенты, инструменты, подтверждение действий, журнал, расписания и триггеры, поставщики нейросетей —agentу даёт единый вход в описание функциональности
- [/docs#agents](/docs#agents) — агенты: инструкция на естественном языке, выбор модели, набор инструментов, степень самостоятельности; один агент = один сценарий автоматизации в базе 1С
- [/docs#tools](/docs#tools) — инструменты: единый диспетчер с проверкой прав пользователя 1С перед вызовом и записью в журнал; новый инструмент добавляется как 1С-обработка с описанием для агента
- [/docs#triggers](/docs#triggers) — расписания и триггеры запуска агента: по расписанию, по событию 1С, по внешнему HTTP-вызову, по упоминанию @агент в комментарии задачи — для политик автоматизации без участия оператора
- [/docs#providers](/docs#providers) — список поддерживаемых поставщиков нейросетей: OpenAI, Anthropic, YandexGPT, ГигаЧат, OpenRouter, локальные модели (LOCAL = «локальная модель на вашем контуре», обработка в РФ по 152-ФЗ)

## Безопасность и контроль (подтверждение, журнал, 152-ФЗ)

- [/#security](/#security) — концентратор безопасности: подтверждение, журнал, права пользователя 1С, защищённое хранилище секретов, 152-ФЗ, шлюз в контуре клиента для крупных заказчиков
- [/docs#confirmation](/docs#confirmation) — подтверждение действий: любое изменение данных в базе 1С вступает в силу только после явного согласия оператора; агент может только предложить действие, исполнение — за человеком
- [/docs#journal](/docs#journal) — неизменяемый (append-only) журнал всех действий агентов: кто, когда, что предложил, что подтвердили; очистка журнала — отдельная роль, недоступная обычному оператору
- [/docs#rights](/docs#rights) — агент всегда выполняется от прав конкретного пользователя 1С: RLS клиента сохраняется, доступ агента к данным не шире доступа этого пользователя
- [/docs#secrets](/docs#secrets) — секретные ключи API хранятся в защищённом хранилище 1С, не попадают в журнал и не передаются в запросы в открытом виде
- [/docs#152fz](/docs#152fz) — 152-ФЗ: обезличивание персональных данных на стороне 1С через псевдонимы; персональные данные направляются только в российские нейросети (ГигаЧат, YandexGPT); для крупных заказчиков — шлюз в контуре клиента. Дисклеймер: это инженерная оценка соответствия, а не юридическое заключение

## Быстрый старт и документация

- [/#quickstart](/#quickstart) — четыре шага запуска: скачать .cfe → добавить расширение в 1С → пройти мастер настройки → создать первого агента по шаблону; работает на 1С:Предприятие 8.3.26+ в клиент-серверном режиме
- [/docs#quickstart](/docs#quickstart) — подробный быстрый старт с системными требованиями, снимками экрана мастера и типовыми ошибками установки
- [/docs#compatibility](/docs#compatibility) — таблица совместимости с типовыми конфигурациями: Бухгалтерия предприятия 3.0, Управление торговлей 11, ERP 2, Зарплата и управление персоналом 3.1
- [/news](/news) — архив анонсов выпусков с перечнем изменений по версиям

## Доступ к нейросетям (российский шлюз, оплата в рублях)

- [/llm-proxy](/llm-proxy) — концентратор шлюза: оплата в рублях через российское юрлицо, закрывающие документы, предоплата, баланс как жёсткий потолок расходов, тарифы, обезличивание персональных данных по 152-ФЗ
- [/llm-proxy#pricing](/llm-proxy#pricing) — тарифы и прозрачная экономия: рядом показаны «сколько бы стоило напрямую у провайдера» и «сколько у нас» — агенту даёт фактические цифры экономии, а не оценку
- [/llm-proxy#how](/llm-proxy#how) — режим работы «запрос — полный ответ» без стриминга наружу: прокси получает полный ответ от провайдера, считает токены из тела ответа, списывает с баланса в одной БД с кабинетом и возвращает расширению. Опциональный внутренний стрим к провайдеру на будущее — для раннего прерывания дорогого запроса при исчерпании баланса
- [/docs#providers](/docs#providers) — список поставщиков нейросетей и пометка LOCAL = «локальная модель на вашем контуре» с обработкой в РФ по 152-ФЗ

## Внедрение «под ключ»

- [/#implementation](/#implementation) — концентратор услуги внедрения: установка расширения, настройка агентов под процессы клиента, обучение операторов, поддержка; форма заявки с обязательным согласием на обработку персональных данных
- [/#contact](/#contact) — форма «сначала связаться»: минимальный сбор персональных данных, отправка в почту и Telegram, защита от спама скрытым полем-ловушкой
- [/offer](/offer) — публичная оферта на услугу внедрения и на платный доступ к нейросетям

## Открытый код и участие

- [/#open-source](/#open-source) — концентратор открытого кода: лицензия AGPL-3.0, репозиторий и выпуски на GitHub, способы помочь проекту (issues, PR, идеи агентов и инструментов)
- [https://github.com/agentrunner/AgentRunner](https://github.com/agentrunner/AgentRunner) — репозиторий проекта: исходный код ядра, трекер обращений, метки выпусков; используется как базовый адрес в файле версии (см. ниже)
- [/license](/license) — лицензия AGPL-3.0 на ядро расширения

## Новости и выпуски

- [/news](/news) — архив анонсов выпусков: что добавлено, исправлено, какие совместимости изменились; источник для построения release_notes в файле версии
- [https://github.com/agentrunner/AgentRunner/releases](https://github.com/agentrunner/AgentRunner/releases) — лента выпусков на GitHub с контрольными суммами .cfe и заметками к версии
- [/blog](/blog) — заметки и разборы кейсов (если ведётся): конкретные сценарии автоматизации 1С через агентов, не маркетинговые посты

## Личный кабинет

- [/account](/account) — обзор кабинета после входа: баланс, расход за период, прозрачная экономия («прямая стоимость vs наша»); доступ только после авторизации
- [/account/billing](/account/billing) — пополнение баланса через российский платёжный сервис (ЮKassa / CloudPayments): оплата картой РФ и по счёту для юрлиц, история платежей, закрывающие документы. БД кабинета и LLM-прокси общая — баланс единый источник истины
- [/account/usage](/account/usage) — детализация расхода токенов по дню, агенту, подразделению, модели; отдельно входные и выходные токены; сравнение поставщиков; выгрузка CSV для бухгалтерии
- [/account/access](/account/access) — ключ доступа к шлюзу для расширения 1С, рандомизация и отзыв ключа, лимиты на день и месяц для защиты от случайного перерасхода
- [/account/login](/account/login) — вход без пароля по одноразовому коду на email: паролей в системе нет, учетная запись привязана к email

## Юридическая и справочная информация

- [/privacy](/privacy) — политика обработки персональных данных в соответствии с 152-ФЗ
- [/offer](/offer) — публичная оферта на доступ к нейросетям и услугу внедрения
- [/license](/license) — лицензия AGPL-3.0 на ядро расширения
- [/sitemap.xml](/sitemap.xml) — классическая карта сайта для поисковиков (адреса без описания смысла)
- [/robots.txt](/robots.txt) — robots.txt не блокирует ИИ-агентов; политика по конкретным ботам определяется отдельно

## Прямой доступ к нейросетям (провайдеры и цены)

- [/api/proxy](/api/proxy) — эндпоинт LLM-шлюза: принимает запросы ОТ расширения 1С с заголовком `Authorization: Bearer <ключ доступа>`; стриминг наружу не отдаётся, ответ возвращается целиком после подсчёта токенов и списания с баланса
- [/api/billing/webhook](/api/billing/webhook) — эндпоинт приёма уведомлений от платёжного сервиса (ЮKassa / CloudPayments); пополнение баланса происходит после подтверждения оплаты сервисом
- [/llm-proxy#providers](/llm-proxy#providers) — список поставщиков: OpenAI, Anthropic, YandexGPT, ГигаЧат, OpenRouter и локальные модели (LOCAL = «локальная модель на вашем контуре», обработка в РФ по 152-ФЗ)
- [/llm-proxy#pricing](/llm-proxy#pricing) — тарифы и сравнение с прямой стоимостью у провайдера: рядом «сколько бы стоило напрямую» и «сколько у нас»; агенту даёт фактические цифры экономии

## Файл версии для авто-обновления

- [/api/version.json](/api/version.json) — машиночитаемый файл последней версии, читаемый расширением 1С для автообновления; HTTPS без авторизации, CORS разрешён, content-type `application/json`, короткий TTL кэша, адрес не меняется между выпусками. Поля по §7.3: `latest_version`, `min_supported_version`, `released_at`, `download_url`, `sha256`, `release_notes_url`, `mandatory`, `channel`
- [/latest.json](/latest.json) — зеркальный адрес того же файла `version.json` на случай, если расширение прописало его; состав и поведение идентичны
- [https://github.com/agentrunner/AgentRunner](https://github.com/agentrunner/AgentRunner) — базовый адрес GitHub, используемый в `download_url` и `release_notes_url` файла версии: `.../releases/download/vX.Y.Z/AgentRunner.cfe` и `.../releases/tag/vX.Y.Z`

## Про этот файл

Файл `/llms-full.txt` — полная версия «карты смысла» сайта AgentRunner для ИИ-агентов: каждый тематический кластер развёрнут до конкретных страниц и эндпоинтов с практической ценностью, написанной для агента, а не маркетинговой фразой. Лёгкая версия для быстрого просмотра — [/llms.txt](/llms.txt); версии ссылаются друг на друга. Оба файла (`llms.txt` и `llms-full.txt`) генерируются автоматически при сборке сайта из того же источника, что и страницы, чтобы не устаревать (требование §6.1, п.9 проекта DESIGN_REQUIREMENTS). Классический `/sitemap.xml` перечисляет адреса без описания смысла — здесь есть описания. На страницах сайта присутствует семантическая разметка Schema.org / JSON-LD для `SoftwareApplication`, `Organization` и `FAQPage`; `robots.txt` не блокирует ИИ-агентов.