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

Интерфейс командной строки агента 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