Решение проблем с помощниками¶

Диагностируйте проблему по слоям. Не начинайте со смены модели, если неизвестно, на каком этапе возник сбой.

Помощник не отображается¶

Проверьте:

помощник сохранён;
он не удалён;
вам выдан Viewer или выше;
роль имеет право USE;
доступ через группу/роль применился;
обновите страницу после изменения ACL.

Нет кнопки «Создать»¶

Скорее всего вашей роли не выдано CREATE.

Это системное ограничение.

Нет кнопки «Поделиться»¶

Проверьте:

являетесь ли Owner/автором;
есть ли SHARE;
разрешено ли распространение политикой;
не является ли ресурс управляемым ресурсом только для чтения.

Нельзя дать доступ всем¶

SHARE_PUBLIC может быть запрещён отдельно от SHARE.

Это нормальная корпоративная политика.

Игнорирует инструкции¶

Сначала создайте новый чистый чат.

Если повторяется:

сократите противоречия;
вынесите справочный текст в знания;
проверьте конфликт навыков;
проверьте пользовательский запрос;
повторите acceptance tests.

«Забывает» правило в длинном чате¶

Возможные причины:

переполнен контекст;
слишком большой File Context;
много результатов операций;
модель хуже следует длинным инструкциям.

Новый разговор — первый контрольный тест.

Не видит постоянный файл¶

Сначала определите механизм.

File Context¶

Проверьте извлечение и сохранение текста.

File Search¶

Проверьте индекс и retrieval.

Не диагностируйте их одинаково.

Цитирует неверный документ¶

удалите устаревшие дубли;
проверьте версии;
уточните вопрос;
посмотрите найденные chunks;
не меняйте модель до проверки retrieval.

Не использует сервис¶

Проверьте:

сервис подключён?
пользователь имеет право?
endpoint доступен?
scope корректен?
инструкция требует фактической проверки?
модель стабильно выбирает инструмент?

Сервис возвращает 403¶

Это чаще учётные данные, права доступа или область доступа, а не модель.

Говорит, что действие выполнено, хотя операция не выполнялась¶

Добавьте правило:

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

И добавьте кейс в regression suite.

Постоянно просит подтверждение¶

Проверьте корпоративную policy.

Операции только для чтения администратор может разрешить заранее, а изменяющие — оставить под подтверждением.

Не отключайте подтверждения глобально ради одного плохо настроенного помощника.

Память не сохраняется¶

Проверьте:

разрешение памяти;
настройку помощника;
персонализацию;
общий или отдельный partition;
была ли явная просьба запомнить;
новый ли чат используется для теста.

Помнит устаревший факт¶

Обновите или удалите запись памяти.

Если это корпоративный факт — перенесите его в управляемую документацию.

Навык не выбирается¶

описание слишком общее;
навык не разрешён;
запрос не соответствует trigger;
модель плохо выбирает операцию;
проверьте ручной вызов.

Интерактивный материал не создаётся¶

Проверьте capability помощника и права роли.

Не путайте её с code execution: server-side arbitrary code в текущей поставке отключён.

Расписание отсутствует¶

Проверьте права SCHEDULES USE/CREATE и глобальное включение функции.

Расписание не запускается¶

Проверьте:

включено ли;
существует ли помощник;
сохранился ли доступ;
есть ли next occurrence;
timezone;
не идёт ли предыдущий запуск;
доступен ли модельный сервер;
не отключилось ли после пяти ошибок.

«Требуется подтверждение» в расписании¶

Один из инструментов остановился на подтверждением.

Откройте созданный разговор и примите или отклоните действие.

Если задача должна быть полностью автономной, пересмотрите инструменты и policy.

Результат не в том проекте¶

Проверьте project destination и административную policy. Проект может быть необязательным, обязательным или централизованно закреплённым.

Viewer видит сведения, которых не должен знать¶

Немедленно ограничьте доступ и проверьте:

File Context;
File Search;
сервисы;
системную инструкцию;
групповые права.

Viewer не видит editor, но помощник способен использовать эти сведения в ответе.

После изменения старый чат ведёт себя странно¶

Создайте новый чат. Старый содержит предыдущую историю и результаты операций.

После смены модели качество упало¶

Повторите сохранённый acceptance suite. Не меняйте одновременно инструкцию и знания.

Очень медленно¶

Определите слой задержки:

модель
File Search
Web Search
корпоративный сервис
подтверждением
очередь нагрузки

Слишком многословно¶

Задайте формат:

Сначала executive summary до 7 пунктов.
Подробности только после него.

Слишком часто отказывается¶

Проверьте, не слишком ли широки ограничения.

Плохо:

Никогда не предлагай команды.

Лучше:

Разрешены безопасные диагностические команды. Изменяющие — только после объяснения влияния и rollback.

Что передать администратору¶

версия Студии
имя помощника
роль пользователя
время ошибки
новый или старый чат
точный prompt
ожидаемый результат
фактический результат
файл/сервис
идентификатор ошибки
повторяется ли в новом чате

Так можно отделить проблему интерфейса, прав, retrieval, интеграции и модели.