Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Интерфейс командной строки агента 365 — это кроссплатформенное средство командной строки для развертывания приложений агента 365 и управления ими в Azure.
Вам не нужно устанавливать CLI вручную. Настройка под руководством ИИ проверяет наличие CLI, автоматически устанавливает или обновляет её и выполняет все необходимые команды от вашего имени. Эта страница служит справочником для разработчиков, которым нужно установить или использовать CLI напрямую — например, при создании автоматизации CI/CD, устранении определённых этапов или работе без AI-агента кодирования.
Замечание
Полный рабочий процесс для разработчиков — включая настройку с помощью ИИ, рекомендации по ролям и этапы после развертывания — представлен в Get Start with Agent 365 разработки. Эта страница — справочник CLI: установка, обновление, удаление, доступные команды и устранение неполадок.
Предпосылки
CLI требует .NET 8.0 или выше. Для всех остальных требований — подписка Azure, обязательные роли Entra и регистрация кастомных приложений клиента — см. AI-guided setup.
Установка интерфейса командной строки агента 365
Чтобы установить агент 365 CLI глобально в операционной системе, выполните следующие действия.
Предпосылки
Необходимо установить .NET. (Рекомендуется использовать .NET 8.0.)
Используйте dotnet tool install
Установите CLI Agent 365, используя следующую команду:
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli
Для получения последних инструкций и доступных версий посетите официальную страницу NuGet: Microsoft. Agents.A365.DevTools.Cli на NuGet.org
Проверка установки
После установки Agent 365 CLI убедитесь, что он правильно установлен, выполнив команду --help :
a365 -h
Эта команда отображает сведения справки и подтверждает, что интерфейс командной строки готов к использованию.
Обновить
Обновите 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
Расположения файлов
Расположение по умолчанию для исполняемого файла средства зависит от операционной системы:
| OS | Путь |
|---|---|
| Linux или macOS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
SDK добавляет эту точку к вашему пути при первом запуске. То есть вы можете вызывать глобальные инструменты из любой папки, не указывая местоположение инструмента.
Доступ к инструменту является определенным пользователем, а не глобальным компьютером. Глобальный инструмент доступен только пользователю, который устанавливает инструмент.
Доступные команды
Для полного списка доступных команд используйте --help эту команду или см. Agent 365 CLI Reference.
Подсказка
Не нужно вручную запускать команды CLI. Настройка , управляемая ИИ , автоматизирует весь рабочий процесс — установку, конфигурацию CLI, создание чертежей, развертывание и публикацию — с помощью агента кодирования ИИ. Используйте ссылку CLI, если вы строите автоматизацию CI/CD, решаете конкретный этап или работаете без AI-агента кодирования.
Полные инструкции по настройке агента Agent 365 с помощью CLI см. раздел «Начать с разработки Agent 365».
Устранение неполадок
В этом разделе представлена информация о том, как устранить ошибки с помощью Agent 365 CLI.
Подсказка
Руководство по устранению неполадок Agent 365 содержит рекомендации по решению неполадок на высоком уровне, лучшие практики и ссылки на контент по устранению неполадок для каждой части жизненного цикла разработки Agent 365.
Вопросы, специфичные для CLI, рассматриваемые в этом разделе:
Агент не появляется в Teams
Создание экземпляров агентов и устранение неполадок: Агент не появляется в Teams
Нельзя создать экземпляр агента в Teams
Устранение неполадок для создания экземпляров агентов: Нельзя создать экземпляр агента в Teams