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

Агент отвечает, но не видит заказы или клиентов. Почему?

Проверьте наличие соответствующего MCP-плагина и роль в MCP → Агенты → Права. Без роли агент не получает инструменты приложений. Права сотрудника в Магазине сами по себе не заменяют роль агента. Попросите перечислить доступные инструменты.

Где взять ключ и почему нет моделей в чате?

Ключ выдаёт ваш провайдер API. В MCP → Модели заполните адрес и ключ, нажмите «Загрузить список», отметьте «Разрешённые модели» и сохраните подключение. В чате показываются только разрешённые модели. Ошибка загрузки списка требует проверки адреса, ключа и доступности API с сервера сайта.

Почему сотрудник не видит нужного агента?

Проверьте доступ к MCP и плагину, признак «Общий агент» и назначения в MCP → Настройки → Доступ → Агенты. Личный агент другого пользователя не показывается. Если общего агента уже выдали отдельным сотрудникам, обычному сотруднику без назначения он недоступен.

Почему в режиме «без вопросов» всё равно нужно подтверждение?

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

Почему агент не прочитал PDF, XLSX или длинный файл?

Обработчик вложений читает поддерживаемые текстовые форматы и изображения, но не извлекает текст из PDF, DOCX и XLSX. Преобразуйте таблицу в CSV/TSV, документ — в текст или Markdown. Размер загружаемого файла ограничен 5 МиБ, текст для модели — 40 000 символами.

Почему агент не видит картинку из CRM?

Для изображения нужна разговорная модель со зрением или отдельная модель в «Зрение» у текущего подключения. Если картинку прислал клиент CRM, агенту может потребоваться agent_view_crm_attachments: некоторые каналы хранят изображения отдельно от обычного списка вложений. Инструмент появляется при доступном роли srm_get_file; чтение файлов и изображений проверяется через инструменты CRM этой роли. Для общего черновика дополнительно важны права сотрудника исполнения на переписку. agent_view_image не открывает произвольные внешние изображения.

Можно ли запретить любые изменения только промптом?

Используйте права роли и «Режим работы», а промпт — для правил общения и задачи. Для чтения данных выберите роль с правами чтения и режим «Только чтение — менять данные приложений не может». Внутренние возможности вроде рисования имеют отдельные условия и могут расходовать услуги провайдера.

Почему достигнут месячный лимит или остановился длинный разбор?

Проверьте «Лимит токенов в месяц» и «Шагов за ход» в карточке агента. Нулевой месячный лимит означает отсутствие ограничения; расход считается с первого числа. Счёт общий для работы с этим агентом. Число шагов ограничивает отдельное обращение. Ошибки API и ограничения провайдера проверяются отдельно; для диагностики включите «Вести журнал» в разделе «Модели».

Почему нет кнопки чата в CRM или Магазине?

Проверьте премиум-редакцию, наличие приложения, включение и сохранение соответствующего пункта в MCP → Встраивание. У сотрудника должны быть права на MCP, плагин и нужного агента. Работа чата внутри MCP доступна и в базовой редакции.

Общий черновик CRM не готовится автоматически. Что проверить?

Проверьте включение встраивания CRM и общих черновиков, общего агента с конкретным набором справочников, исполнителя с правами, переключатель автоматической подготовки и cron agentPluginDrafts раз в минуту. В блоке «Серверная подготовка» видны последний запуск и ошибки. Старые переписки при первом включении не обрабатываются; новое входящее переносит паузу, ответ сотрудника снимает ожидание. Готовый текст отправляет менеджер.

Почему внешняя ссылка не создаётся или не показывает новые сообщения?

Для неё нужно публичное поселение MCP. Ссылка показывает снимок переписки на момент публикации; для новых сообщений нажмите «Опубликовать новую версию». Проверьте также, не отключена ли ссылка и не истёк ли срок по правилу «Автоматически закрывать доступ через». Для исполнения этого правила нужен ежедневный cron agentPluginCleanup.

Как сократить объём истории и сохранить нужные разговоры?

В MCP → Хранилище выберите «Сжать» для удаления старых ответов инструментов и размышлений с сохранением текста переписки. «Удалить разговоры» удаляет неактивные разговоры и файлы насовсем. Закреплённые разговоры обычная очистка по давности не трогает. При необходимости отключите «Записывать размышления модели» для будущей истории.