Устранение неполадок с интерфейсом командной строки оценок Microsoft 365 Copilot

В этой статье содержатся сведения об устранении неполадок интерфейса командной строки оценок 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), чтобы упростить рассмотрение проблемы.