AI Сайт Мастер: документация

Выпуск и требования

Инструкция относится к полному пакету bbcoding.agentgateway 1.0.11, SHA-256 76cdddb9434986dc2070a3aa6dca868711f31c99a371d9d2993fcbf95d182c15. Используйте именно этот архив: исходники более нового кандидата могут содержать другие настройки.

Документация внутри пакета требует PHP 8.2 с json, sodium, mbstring, iconv, curl и fileinfo; Битрикс main >= 24.0.0, модули iblock, catalog, currency, а для корзины и передачи в checkout — sale. Нужны HTTPS, поддерживаемая MySQL/InnoDB схема и приватное хранилище вне всех document roots.

Зафиксированная native-связка — PHP 8.2.33, MySQL8/Percona8 и main 26.750.0. Требование установщика к минимальной версии не доказывает проверку каждой промежуточной версии; локальные проверки PHP8.3/8.4 не являются заявлением native-совместимости. Таблица на странице ограничена проверенной связкой.

Основному API и обычному поиску не нужны Composer, Node, Rust, разговорная модель, SaaS или отдельный runtime sidecar. Закреплённые зависимости входят в поставку; не запускайте обновление зависимостей на рабочем магазине.

Подготовка и установка

Сверьте SHA-256. Сохраните резервную копию базы, файлов сайта и закрытого хранилища; при обновлении сохраните также текущий пакет. Сначала выполните процедуру на тестовой копии.

Разместите корневой каталог bbcoding.agentgateway из архива в local/modules/ основного сайта. Файлы ядра и сторонних модулей не заменяйте. Проверьте существование и однозначность document root каждого сайта Битрикса.

Проверьте, что адреса /.well-known/ucp, /ucp и /agent-gateway не заняты чужим обработчиком. При конфликте остановитесь и устраните его явно: установщик не должен перезаписывать чужие маршруты.

В штатном разделе установки модулей выберите AI Agent Gateway и подтвердите установку из действующей административной сессии. После установки доступ агентов к каталогу остаётся выключенным.

Приватное хранилище и фоновые задачи

Настройте закрытое хранилище и безопасное журналирование по install/README.md и install/server/README.md, которые входят в этот пакет. Ключи и служебные файлы не размещайте в доступном через HTTP каталоге. Настройки nginx, Apache и PHP-FPM выполняет администратор сервера.

Настройте запуск install/catalog-index-worker.php CLI PHP сайта каждые 30 секунд. Для обычного Cron используются два задания: в начале минуты и с задержкой 30 секунд. Путь начинается с фактического document root и продолжается local/modules/bbcoding.agentgateway/install/catalog-index-worker.php.

Задание install/housekeeping-worker.php запускается каждые 5 минут тем же CLI PHP. Убедитесь, что задания выполняются под правильным пользователем, и проверьте результат в настройках модуля. Запросы к публичному API не заменяют фоновые задания.

Изолированная браузерная диагностика требует отдельных серверных правил, описанных в установочной инструкции пакета. До их настройки оставляйте её BLOCKED. Не включайте её только потому, что основной API отвечает.

Профиль и публикация

Откройте «Настройки → Настройки продукта → Настройки модулей → AI Agent Gateway». Прямой адрес настроек: /bitrix/admin/settings.php?lang=ru&mid=bbcoding.agentgateway.

Создайте профиль активного сайта с валютой и правильным HTTPS-адресом. Выберите каталоги, публичные поля, правила наличия и цену для посетителя без авторизации. Персональные цены, cookies покупателя/администратора и B2B-контекст публичным API не передаются.

Выберите способы доступа отдельно для каталога и временных корзин. Ключ API показывается один раз: сохраните его в защищённом хранилище клиента. Диагностические операции не являются публичными tools.

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

Проверка результата

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

Проверьте временную корзину и перенос в обычную корзину через предварительный просмотр и явное подтверждение покупателя. Заказ и оплата выполняются штатным checkout Битрикса; публичный API не создаёт заказ и не списывает деньги. Сценарий замены корзины отдельно проверьте на тестовом сайте.

Для конкретного MCP-клиента или другой платформы проверяйте фактическое подключение отдельно. Ответ API не подтверждает, что внешняя площадка сможет автоматически обнаружить магазин. Необязательные semantic/LLM-режимы требуют собственных настроек и ресурсов; базовая установка не включает их автоматически.

Обращение в поддержку

Укажите выпуск 1.0.11, версии PHP/Битрикс/СУБД, состояние профиля и индекса, конкретный шаг и обезличенный текст ошибки. Не прикладывайте bearer-токены, ключи API, cookies или персональные данные покупателей.