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

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

Вам не нужно устанавливать CLI вручную.Agent 365 Skills проверяет наличие CLI, устанавливает или обновляет его автоматически и выполняет все необходимые команды от вашего имени. Эта статья служит справочником для разработчиков, которым необходимо напрямую установить или использовать CLI — например, при создании автоматизации CI/CD, устранении определённых этапов или работе без AI-агента кодирования.

Замечание

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

Необходимые условия

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

Установка интерфейса командной строки агента 365

Чтобы установить агент 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

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

Update

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

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

Замечание

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

Uninstall

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

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

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

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

OS Путь
Linux или macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

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

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

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

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

Tip

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

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

Troubleshooting

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

Tip

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

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

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

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

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

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

  • Last updated on