Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
В этой статье содержатся сведения об устранении неполадок интерфейса командной строки оценок Microsoft 365 Copilot. В следующих разделах проблемы группируются по этапам рабочего процесса, на которые они влияют: настройка, проверка подлинности, среда выполнения и среда.
Проблемы с настройкой
Проблемы, возникшие во время установки или при первом запуске CLI.
Сбои установки
В случае npm install -g @microsoft/m365-copilot-eval неудачи:
- Убедитесь, что вы используете Node.js 24.12.0 или более поздней версии:
node --version. - Убедитесь, что у вас есть разрешение на установку глобальных пакетов npm. В Unix/macOS вам может потребоваться
sudoустановка Node, управляемого nvm. - Если вы используете корпоративный прокси-сервер, см. раздел "Проблемы с сетью или прокси-сервером".
runevals Команда не найдена
Если команда не распознается после установки, выполните следующие действия.runevals
# Verify the package is installed globally
npm list -g @microsoft/m365-copilot-eval
# Reinstall if missing
npm install -g @microsoft/m365-copilot-eval
Если пакет есть в списке, но команда по-прежнему не найдена, проверка, что глобальный bin каталог npm находится в следующемPATH:
npm bin -g
Добавьте каталог вывода в свой PATH каталог, если он отсутствует.
Предварительно кэшируйте среду Python
Инструмент загружает среду выполнения Python и зависимости при первом запуске. Чтобы заранее настроить среду без выполнения оценок, выполните следующие действия.
runevals --init-only
Это полезно в следующих случаях:
- Предварительный подогрев кэша в конвейерах CI/CD.
- Проверка настройки без выполнения оценок.
- Изоляция проблем установки от проблем оценки.
Для устранения неполадок самой установки сочетайте с ведением журнала отладки:
runevals --init-only --log-level debug
Проблемы с проверкой подлинности
Проблемы с доступом клиента, агента или Microsoft Foundry.
Ошибки проверки подлинности
Если аутентификация не пройдена:
- Проверка
TENANT_IDсоответствия клиенту, в котором развернут агент. - Убедитесь, что вы используете Windows. Поддержка других операционных систем ожидается в ближайшее время.
- Убедитесь, что вы вошли в правильную учетную запись Microsoft 365.
- Если вы используете несколько клиентов, перед запуском
runevalsвыйдите из других учетных записей.
Несоответствие клиента
Если средство подключается, но не возвращает агент, возможно, ваше TENANT_ID устройство не совпадает с клиентом, в котором развернут агент. Проверьте идентификатор клиента, выполнив:
az account show --query tenantId
Вы также можете следовать инструкциям в разделе "Обязательные переменные среды".
Ошибки оценки Foundry
Если оценка не пройдена с ошибкой 401 или 403:
- Убедитесь, что вы вошли в систему с помощью интерфейса командной строки Azure (
az login) в клиенте, в котором размещен проект Microsoft Foundry. - Подтвердите, что у вашей учетной записи есть роль разработчика ИИ Azure в проекте Foundry.
- Подтвердите
AZURE_AI_PROJECT_ENDPOINTбаллы в правильном проекте Microsoft Foundry. - Убедитесь, что
gpt-5-mini(или заданная модельAZURE_AI_MODEL_NAME) развернута в вашем проекте Microsoft Foundry.
Проблемы среды выполнения
Проблемы, возникающие при выполнении оценок после успешной настройки.
Агент не найден
Если средству не удается найти агента, выполните следующие действия.
- Проверка
M365_AGENT_IDправильности. Для проектов Agents Toolkit интерфейс командной строки автоматически определяет его изM365_TITLE_ID.env.local, поэтому вместо этого проведите проверку это значение — см. раздел Получение идентификатора агента. - Убедитесь, что агент развернут в клиенте, указанном в
TENANT_ID. - Убедитесь, что у вас есть разрешение на доступ к агенту.
- Попробуйте явно указать идентификатор агента:
runevals --m365-agent-id "<your-agent-id>".
Сбои оценки
Если вычисления начнутся, но потерпят неудачу в середине выполнения:
- Запустите с подробным ведением журнала, чтобы увидеть подробные ошибки:
runevals --log-level debug. - Проверьте коды выхода для общей категории сбоя. См. Коды выхода в справочнике CLI.
Предупреждение
Параметр --log-level debug может включать необработанные полезные данные API и данные ответов в выходных данных консоли. Редактирование основано на шаблонах и может не перехватывать все личные данные или пользовательские учетные данные. Не публикуйте результаты отладки публично без ручной проверки.
Проблемы с оценкой вызова средства (ознакомительная версия 2)
Для ToolCallSelection и ToolCallExecution требуется @microsoft/m365-copilot-eval@preview схема версии 2. Они недоступны в версии 1 (latest).
| Проблема | Действие |
|---|---|
toolCallNotAllowed |
Просмотрите идентификаторы запрошенного согласия и утвердите предполагаемые операции с помощью default_allowed_tools или allowed_tools. Ожидания оценщика не дают согласия. |
toolCallEvidenceIndeterminate |
Проверяйте diagnostics.tool_calls недоступные доказательства или результаты HTTP, которые невозможно проанализировать. Ошибка — это не пропуск и не обязательно дефект агента. |
| Ожидаемый вызов не соответствует | Проверьте параметры , чувствительные plugin_idк регистру, toolset_idи function_name.
plugin_id — это идентификатор продукта пакета, а не plugin.id. |
| Сохраненные результаты вызова инструментов не могут быть повторно оценены | Подтвердите, что сохраненные элементы или повороты включают и response сохраняют диагностику. Улики, скрытые с помощью EVALS_SUPPRESS_DIAGNOSTICS=true , недоступны для воспроизведения. |
| Оценка подключаемого модуля нацелена на агент | Удалите M365_AGENT_ID legacy AGENT_ID из оболочки и загруженных файлов окружения, а затем опустите --m365-agent-id. |
Команды обнаружения, примеры и различия между сбоями и ошибками см. в статье Анализаторы вызова инструментов.
Проблемы окружающей среды
Проблемы с кэшированной средой выполнения Python, каталогом кэша или сетевым подключением.
Проблемы с кэшем
Средство оценки использует локальный кэш для среды выполнения и зависимостей Python.
# View cache info
runevals cache-info
# Clear and rebuild the cache
runevals cache-clear
runevals --init-only --log-level debug
Проблемы с разрешениями
Если операции кэша завершаются сбоем с ошибками разрешений:
# View the cache directory path
runevals cache-dir
# Fix permissions (Unix/macOS)
chmod -R u+w $(runevals cache-dir)
# Fix permissions (Windows PowerShell)
icacls "$(runevals cache-dir)" /grant ${env:USERNAME}:F /T
Проблемы с сетью или прокси-сервером
Если инициализация за корпоративным прокси-сервером завершается сбоем, выполните следующие действия.
# Set proxy (Unix/macOS)
export HTTPS_PROXY=http://proxy:8080
export HTTP_PROXY=http://proxy:8080
# Set proxy (Windows PowerShell)
$env:HTTPS_PROXY="http://proxy:8080"
$env:HTTP_PROXY="http://proxy:8080"
# Retry initialization with verbose output
runevals --init-only --log-level debug
Поддержка
Если действия по устранению неполадок, описанные выше в этой статье, не решили проблему, зарегистрируйте ее в репозитории GitHub Microsoft 365 Copilot Evaluations.
Прежде чем сообщить о проблеме, соберите:
- Версия CLI:
runevals --version. - Точная команда, которую вы выполнили.
- Вывод ошибок (отредактируйте все персональные данные, ключи или идентификаторы, относящиеся к клиенту).
- Ваша операционная система и Node.js версия:
node --version.
Чтобы сообщить о проблеме:
- Откройте новую проблему в разделе Оценки Microsoft 365 Copilot.
- Примените соответствующую метку (например,
setup,authentication,runtime,environment), чтобы упростить рассмотрение проблемы.