Решение проблем

Начните с воспроизводимого случая#

Перед изменением настроек зафиксируйте:

• Рабочее пространство/сайт, публичный маршрут или конечную точку API и точное время с часовым поясом.
• Ожидаемый результат и фактический результат.
• Браузер/устройство или канал внешнего провайдера.
• Затрагивает ли сбой предпросмотр владельца, оставшуюся размещённую демо-страницу, встраивание, коннектор и/или API.
• Безопасный текст статуса/ошибки, x-request-id ответа, последнюю ошибку коннектора или ID события доставки провайдера.
• Последнее известное рабочее время и наименьшее недавнее изменение.

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

Изменения сайта не появляются#

1. Убедитесь, что URL панели принадлежит нужному сайту и рабочему пространству.
2. Убедитесь, что действие сохранения сообщило об успехе.
3. Для текста страницы, знаний или характера опубликуйте текущее состояние снова из Проверка и публикация.
4. Для Внешнего вида (и значка брендинга) успешное сохранение уже обновляет живое встраивание — пропустите повторную публикацию и откройте приватное окно.
5. Откройте реальное встраивание (или оставшийся размещённый slug, если он у вас есть) в приватном окне.
6. Если устарел только социальный предпросмотр, используйте кэш/отладчик этой платформы.

Отмена публикации и редактирование — разные вещи. Подключённый коннектор сообщений может продолжать отвечать даже при выключенном встраивании.

Ответ агента слабый или неверный#

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

Когда в источнике нет ответа, улучшите поведение запасного ответа/эскалации вместо инструктирования агента угадывать. Используйте Источники знаний для создания приёмочного набора прямой/перефразировка/граница.

Загрузчик встраивания отсутствует или заблокирован#

Убедитесь, что сайт опубликован, встраивание включено, скрипт имеет точный slug сайта и финальный родительский origin браузера — включая схему, имя хоста и порт — в разрешённом списке. В DevTools изучите запрос embed.js, ошибки CSP, состояние менеджера согласия, запрос iframe и наличие одного корня data-maf-embed.

Если текст работает, а микрофон нет, проверьте HTTPS, разрешение браузера, разрешение iframe allow и Permissions Policy сайта. Следуйте полному Обзору встраивания и Безопасности и CSP.

Голос не работает#

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

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

Коннектор не получает сообщений#

Используйте гайд канала и сравните обе стороны. Убедитесь, что коннектор включён, учётные данные всё ещё проходят проверку, URL вебхука/взаимодействия/скилла провайдера актуален, требуемое событие/Страница/номер/блок подписаны, режим приложения включает тестового пользователя и публичная HTTPS доставка успешна.

Успех проверки вебхука не доказывает подписку на события во время работы или исходящие разрешения. Сравнивайте логи доставки провайдера с Последним сообщением и сохранённой ошибкой коннектора. Тестируйте текст перед голосом.

Собственные домены не предлагаются#

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

Запрос API не работает#

Запишите метод, версионный путь, статус, стабильный код ошибки, x-request-id ответа и релевантные заголовки лимита частоты. Затем классифицируйте:

Используйте Учётные данные и токены, Области и ошибки и Лимиты частоты. Никогда не решайте ошибку API перемещением серверных учётных данных в браузерный код.

Оплата или использование выглядит неправильно#

Различайте доступ платформы, ежемесячные кредиты, купленные кредиты, число сайтов, живые минуты, слоты клонов, частоту API, каналы сообщений (Operate+) и BYOK/команду (Scale). Пополнение меняет только кредиты. Списания провайдера BYOK отделены от оплаты Make Agent Fast.

При неожиданном использовании изолируйте вероятный источник перед исследованием: отключите коннектор, отзовите ключ, удалите непредназначенный origin встраивания или остановите цикл повторов API. Сохраняйте диапазон времени и ID запросов/провайдеров без раскрытия секретов.

Соберите безопасные детали для поддержки#

Если всё ещё заблокированы, используйте элемент обратной связи на наиболее релевантном гайде или обратитесь в поддержку из панели с:

• Идентификатором сайта/рабочего пространства и затронутой функцией.
• Точной временной меткой/часовым поясом и воспроизводимыми шагами.
• Ожидаемым и фактическим результатом.
• Публичным несекретным URL, когда релевантно.
• HTTP статусом, стабильным кодом ошибки, x-request-id или ID события провайдера.
• Отредактированным скриншотом или минимальной полезной нагрузкой с удалёнными секретами и персональными данными.

Укажите, что вы уже проверили. Это предотвращает повторные советы по настройке и проясняет границу сбоя.