Интерфейс командной строки Agent 365

Agent 365 CLI — это кроссплатформенный инструмент с командной строкой для развертывания и управления приложениями Agent 365 на Azure.

Устанавливать CLI вручную не нужно. Настройка с помощью ИИ проверяет наличие CLI, автоматически устанавливает или обновляет его и выполняет все необходимые команды от вашего имени. Эта страница является справочником для разработчиков, которым нужно установить или использовать CLI напрямую — например, при построении CI/CD-автоматизации, устранении неполадок на определенном этапе или при работе без агента кодирования на базе ИИ.

Примечание

Полный рабочий процесс для разработчиков — включая настройку с помощью ИИ, рекомендации по ролям и шаги после развертывания — описан в разделе Начало разработки с Agent 365. Данная страница представляет собой справочник по CLI: установка, обновление, удаление, доступные команды и устранение неполадок.

Предварительные условия

Для CLI требуется .NET 8.0 или выше. Все остальные требования — подписка Azure, необходимые роли Entra и регистрация клиентского приложения — описаны в разделе Настройка с помощью ИИ.

Установка Agent 365 CLI

выполните следующие действия, чтобы глобально установить Agent 365 CLI в вашей операционной системе.

Предварительные условия

У вас должен быть установлен .NET. (Рекомендуется .NET 8.0.)

Использование dotnet tool install

Установите Agent 365 CLI с помощью следующей команды:

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli

Для получения последних инструкций и доступных версий посетите официальную страницу NuGet: Microsoft.Agents.A365.DevTools.Cli на NuGet.org

Проверка установки

После установки Agent 365 CLI проверьте правильность установки, выполнив команду --help.

a365 -h

Эта команда отображает справочную информацию и подтверждает, что CLI готов к использованию.

Обновить

Обновите Agent 365 CLI с помощью команды dotnet tool update:

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli

Примечание

Для обновления Agent 365 CLI вам потребуется подключение к Интернету для доступа к самой новой версии NuGet-пакета: Microsoft.Agents.A365.DevTools.Cli.

Удалить

Удалите Agent 365 CLI с помощью команды dotnet tool uninstall:

dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli

Расположение файла

Расположение исполняемого файла инструмента по умолчанию зависит от операционной системы:

ОС Path
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

SDK добавляет этот путь в системную переменную PATH при первом запуске. Таким образом, вы можете запускать глобальные инструменты из любого каталога, не указывая путь к инструменту.

Доступ к инструменту является пользовательским, а не системным. Глобальный инструмент доступен только пользователю, установившему его.

Доступные команды

Для получения полного списка доступных команд используйте команду --help или см. Справочник по Agent 365 CLI.

Совет

Нет необходимости вручную выполнять команды CLI. Настройка с помощью ИИ ИИ, автоматизирует весь рабочий процесс — установку, конфигурирование CLI, создание схем, развертывание и публикацию — с помощью агента кодирования на базе ИИ. Используйте справочник по CLI здесь, если вы создаете автоматизацию CI/CD, устраняете неполадки на определенном этапе или работаете без агента кодирования на базе ИИ.

Полные инструкции по настройке агента Agent 365 с помощью CLI см. в разделе Начало разработки с Agent 365.

Устранение неполадок

В этом разделе представлена информация о том, как устранять ошибки, связанные с Agent 365 CLI.

Совет

Руководство по устранению неполадок Agent 365 содержит общие рекомендации по устранению неполадок, лучшие практики и ссылки на материалы по устранению неполадок для каждого этапа жизненного цикла разработки Agent 365.

Связанные с CLI проблемы, рассматриваемые в этом разделе:

Агент не отображается в Teams

Устранение неполадок при создании экземпляра агента: агент не отображается в Teams

Не удается создать экземпляр агента в Teams

Устранение неполадок при создании экземпляров агента: не удается создать экземпляр агента в Teams

  • Last updated on