Справочник по команде agent 365 CLI develop

Управление серверами инструментов MCP для разработки агентов. Команда предоставляет опции управления серверами инструментов MCP (Model Context Protocol) для разработки develop агентов. Вы можете перечислять доступные серверы, просматривать настроенные серверы и добавлять или убирать MCP-серверы из конфигурации агента.

Минимальная необходимая роль: нет (местное управление манифестами)

Syntax

a365 develop [command] [options]

Options

Option Description
-v, --verbose Включение ведения подробного журнала
-?, , -h--help Показать справку и информацию об использовании.

develop list-available

Список всех серверов MCP, доступных в каталоге (то, что можно установить).

a365 develop list-available [options]

Эта команда отображает все MCP-серверы, доступные в каталоге, и вы можете установить их для использования в разработке агента.

list-available варианты

Option Description
--dry-run Показать, что будет делать команда, не выполняя ее.
--skip-auth Skip authentication. Только для тестирования. Команда, скорее всего, не работает без действительной аутентификации.
-?, , -h--help Показать справку и информацию об использовании.

Note

develop list-available не требует a365.config.json. Он считывает окружающую среду из A365_ENVIRONMENT переменной среды (по умолчанию ).prod

develop list-configured

Список настроенных в настоящее время серверов MCP из локального сервера ToolingManifest.json.

a365 develop list-configured [options]

Эта команда показывает все MCP-серверы, которые вы сейчас настроили, в вашем локальном ToolingManifest.json файле.

list-configured варианты

Option Description
--project-path <path> Путь к каталогу проектов агентов, содержащего ToolingManifest.json. Отмены DeploymentProjectPath из a365.config.json.
--dry-run Показать, что будет делать команда, не выполняя ее.
-?, , -h--help Показать справку и информацию об использовании.

develop add-mcp-servers

Добавьте серверы MCP в текущую конфигурацию агента.

a365 develop add-mcp-servers [<servers>...] [options]

Эта команда добавляет указанные MCP-серверы ToolingManifest.json в вашу папку проекта. Он не даёт разрешений на чертеж агента.

Important

Эта команда только обновляется ToolingManifest.json — она не даёт разрешения на чертеж агента. То, как вы применяете разрешения, зависит от того, на каком этапе вы находитесь в процессе настройки:

  • Перед начальной установкой: Приступайте к a365 setup all. Разрешения MCP применяются как часть первоначального создания чертежа.
  • После того как чертёж уже существует: Глобальный администратор должен работать a365 setup permissions mcp отдельно. Администратор должен проверить, что это deploymentProjectPath указывает на папку проекта, содержащую обновлённый ToolingManifest.json.

Аргументы add-mcp-servers

Укажите одно или несколько имён серверов MCP для добавления в конфигурацию вашего агента. Вы можете предоставить несколько имён серверов, разделённых пробелами.

Argument Description
<servers> Названия серверов MCP для добавления

add-mcp-servers варианты

Используйте эти параметры для настройки поведения add-mcp-servers команды.

Option Description
--project-path <path> Путь к каталогу проектов агентов, содержащего ToolingManifest.json. Отмены DeploymentProjectPath из a365.config.json.
--dry-run Показать, что будет делать команда, не выполняя ее.
-?, , -h--help Показать справку и информацию об использовании.

develop remove-mcp-servers

Удалите серверы MCP из текущей конфигурации агента.

a365 develop remove-mcp-servers [<servers>...] [options]

Эта команда удаляет определённые MCP-серверы из текущей конфигурации агента.

Аргументы remove-mcp-servers

Argument Description
<servers> Названия серверов MCP для удаления

remove-mcp-servers варианты

Option Description
--project-path <path> Путь к каталогу проектов агентов, содержащего ToolingManifest.json. Отмены DeploymentProjectPath из a365.config.json.
--dry-run Показать, что будет делать команда, не выполняя ее.
-?, , -h--help Показать справку и информацию об использовании.

develop add-permissions

Добавьте разрешения API сервера MCP в приложения Microsoft Entra для сценариев разработки, где необходимо настроить пользовательские приложения для доступа к серверам MCP.

a365 develop add-permissions [options]

add-permissions варианты

Используйте эти опции, чтобы добавить необходимые разрешения и область применения API в регистрацию приложения, используя значения из манифеста инструментов.

Option Description
-m, --manifest <manifest> Путь к ToolingManifest.json (по умолчанию: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id> ID приложения (клиента) для добавления разрешений (по умолчанию: clientAppId из конфигурации)
--scopes <scopes> Конкретные области для добавления (промежуточно) (по умолчанию: Все области от ToolingManifest.json)
--dry-run Покажите, что команда будет делать без изменений
-v, --verbose Отображение подробных выходных данных
-?, , -h--help Показать справку и информацию об использовании.

Important

Приложение, указанное --app-id или clientAppId, должно иметь разрешение Application.ReadWrite.All в Microsoft Entra. Эта команда предназначена для пользовательских клиентских приложений. Для настройки разрешений для чертежей агентов используйте a365 setup permissions mcp вместо этого.

develop get-token

Получение маркеров носителя для тестирования серверов MCP во время разработки с помощью интерактивной проверки подлинности браузера.

a365 develop get-token [options]

get-token варианты

Используйте эти параметры для запроса токена доступа, управления областью применения, обновления поведения и выбора формата вывода.

Option Description
--app-id <app-id> ID приложения (клиента) для аутентификации (по умолчанию: clientAppId из конфигурации)
-m, --manifest <manifest> Путь к ToolingManifest.json (по умолчанию: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes> Конкретные области для запроса (промежуточно) (по умолчанию: чтение из ToolingManifest.json)
-o, --output <output> Формат вывода: table, , или json (по умолчанию: rawtable)
--force-refresh Принудительное обновление токена, обходящее кэш
--resource <resource> Ключевое слово ресурса для получения токена: mcp (по умолчанию) или powerplatform
--resource-id <resource-id> Пользовательский идентификатор приложения ресурса (GUID) для ресурсов, не охваченных --resource ключевыми словами
-v, --verbose Покажите подробный результат, включая полный токен
-?, , -h--help Показать справку и информацию об использовании.

get-token Варианты ресурсов

Используйте опции --resource и --resource-id, чтобы получить жетоны для разных Azure ресурсов:

  • --resource: Используйте ключевое слово для выбора заранее определённого ресурса:
    • mcp (по умолчанию): Agent 365 Tools для MCP-серверов
    • powerplatform: Power Platform API
  • --resource-id: Введите пользовательский идентификатор приложения ресурса (GUID) для ресурсов, не охваченных ключевыми словами

Important

Нельзя использовать --resource и --resource-id вместе. Когда вы используете любой из вариантов, включите --scopes. Только стандартный поток MCP поддерживает разрешение области на основе манифеста.

develop start-mock-tooling-server

Запустите макет сервера инструментов для тестирования и разработки.

a365 develop start-mock-tooling-server [options]

Эта команда запускает сервер имитации инструментов для тестирования и разработки. Используя этот сервер, вы можете моделировать взаимодействия между MCP серверами без необходимости реализовать серверные реализации.

start-mock-tooling-server варианты

Используйте эти параметры для настройки поведения start-mock-tooling-server команды.

Option Description Default
-p, --port <port> Номер порта макет-сервера 5309
-v, --verbose Включение ведения подробного журнала false
-?, -h, --help Показывать справочную и пользовательскую информацию -
-bg Запустите сервер на новом терминале -