Compartilhar via

Referência de comando da CLI develop do Agent 365

Importante

Você precisa fazer parte do programa de prévia Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier conecta você diretamente às mais recentes inovações de IA da Microsoft. Prévias da Frontier estão sujeitas aos termos de pré-visualização existentes dos seus contratos com clientes. Como esses recursos ainda estão em desenvolvimento, sua disponibilidade e capacidades podem mudar ao longo do tempo.

Gerenciar servidores de ferramentas MCP para desenvolvimento de agente. O develop comando fornece opções para gerenciar servidores de ferramenta MCP (Protocolo de Contexto de Modelo) para desenvolvimento de agente. Você pode listar servidores disponíveis, exibir servidores configurados e adicionar ou remover servidores MCP da configuração do agente.

Função mínima necessária: Nenhuma (gerenciamento de manifesto local)

Sintaxe

a365 develop [command] [options]

Opções

Opção Description
-c, --config <config> Caminho do arquivo de configuração. Padrão: a365.config.json
-v, --verbose Habilitar o registro em log detalhado
-?, , -h--help Mostrar informações de ajuda e uso.

develop list-available

Liste todos os servidores MCP disponíveis no catálogo (o que você pode instalar).

a365 develop list-available [options]

Esse comando exibe todos os servidores MCP disponíveis no catálogo e você pode instalá-los para uso com o desenvolvimento do agente.

list-available opções

Opção Description
-c, --config <config> Caminho do arquivo de configuração. Padrão: a365.config.json
--dry-run Mostre o que o comando faria sem executá-lo.
--skip-auth Ignorar a autenticação. Somente para teste. O comando provavelmente falhará sem autenticação válida.
-?, , -h--help Mostrar informações de ajuda e uso.

develop list-configured

Listar servidores MCP configurados no momento de seu local ToolingManifest.json.

a365 develop list-configured [options]

Este comando mostra todos os servidores MCP configurados no momento no arquivo de ToolingManifest.json local.

list-configured opções

Opção Description
-c, --config <config> Caminho do arquivo de configuração. Padrão: a365.config.json
--dry-run Mostre o que o comando faria sem executá-lo.
-?, , -h--help Mostrar informações de ajuda e uso.

develop add-mcp-servers

Adicione servidores MCP à configuração atual do agente.

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

Esse comando adiciona os servidores MCP especificados à ToolingManifest.json pasta do projeto. Ele não concede permissões ao blueprint do agente.

Importante

Esse comando só é ToolingManifest.json atualizado– ele não concede permissões ao blueprint do agente. Como as permissões são aplicadas depende de onde você está no processo de instalação:

  • Antes da configuração inicial: prossiga com a365 setup all. As permissões MCP são aplicadas como parte da criação inicial do blueprint.
  • Depois que o blueprint já existir: um Administrador Global deve ser executado a365 setup permissions mcp separadamente. O administrador deve ser executado a365 config display primeiro para verificar se deploymentProjectPath , em seus a365.config.json pontos, a pasta do projeto que contém a atualização ToolingManifest.json.

Argumentos de add-mcp-servers

Especifique um ou mais nomes de servidor MCP a serem adicionados à configuração do agente. Você pode fornecer vários nomes de servidor separados por espaços.

Argument Description
<servers> Nomes dos servidores MCP a serem adicionados

add-mcp-servers opções

Use essas opções para personalizar o comportamento do add-mcp-servers comando, incluindo seleção de arquivo de configuração e teste de execução a seco.

Opção Description
-c, --config <config> Caminho do arquivo de configuração. Padrão: a365.config.json
--dry-run Mostre o que o comando faria sem executá-lo.
-?, , -h--help Mostrar informações de ajuda e uso.

develop remove-mcp-servers

Remova os servidores MCP da configuração atual do agente.

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

Esse comando remove os servidores MCP especificados da configuração do agente atual.

Argumentos de remove-mcp-servers

Argument Description
<servers> Nomes dos servidores MCP a serem removidos

remove-mcp-servers opções

Opção Description
-c, --config <config> Caminho do arquivo de configuração. Padrão: a365.config.json
--dry-run Mostre o que o comando faria sem executá-lo.
-?, , -h--help Mostrar informações de ajuda e uso.

develop add-permissions

Adicione permissões de API do servidor MCP para Microsoft Entra aplicativos para cenários de desenvolvimento em que você precisa configurar aplicativos personalizados para acessar servidores MCP.

a365 develop add-permissions [options]

add-permissions opções

Use essas opções para adicionar permissões e escopos de API necessários ao registro do aplicativo, aproveitando valores do manifesto de ferramentas.

Opção Description
-c, --config <config> Caminho do arquivo de configuração (padrão: a365.config.json)
-m, --manifest <manifest> Caminho para ToolingManifest.json (padrão: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id> ID do aplicativo (cliente) para adicionar permissões (padrão: clientAppId da configuração)
--scopes <scopes> Escopos específicos a serem adicionados (separados por espaço) (padrão: todos os escopos de ToolingManifest.json)
--dry-run Mostrar o que o comando faria sem fazer alterações
-v, --verbose Mostrar saída detalhada
-?, , -h--help Mostrar informações de ajuda e uso.

Importante

O aplicativo especificado por --app-id ou clientAppId deve ter a permissão Application.ReadWrite.All no Microsoft Entra. Esse comando é para aplicativos cliente personalizados. Para configurar permissões para blueprints de agente, use a365 setup permissions mcp em vez disso.

develop get-token

Recupere tokens de portador para testar servidores MCP durante o desenvolvimento usando a autenticação interativa do navegador.

a365 develop get-token [options]

get-token opções

Use essas opções para solicitar um token de acesso, controlar escopos, atualizar o comportamento e escolher o formato de saída.

Opção Description
-c, --config <config> Caminho do arquivo de configuração (padrão: a365.config.json)
--app-id <app-id> ID do aplicativo (cliente) para autenticação (padrão: clientAppId da configuração)
-m, --manifest <manifest> Caminho para ToolingManifest.json (padrão: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes> Escopos específicos para solicitação (separados por espaço) (padrão: Leitura de ToolingManifest.json)
-o, --output <output> Formato de saída: table, jsonou raw (padrão: table)
--force-refresh Forçar a atualização de token ignorando o cache
--resource <resource> Palavra-chave de recurso para obter token para: mcp (padrão) ou powerplatform
--resource-id <resource-id> GUID (ID do aplicativo de recurso personalizado) para recursos não cobertos por --resource palavras-chave
-v, --verbose Mostrar saída detalhada, incluindo token completo
-?, , -h--help Mostrar informações de ajuda e uso.

get-token opções de recurso

Use as opções --resource e --resource-id para obter tokens para diferentes recursos de Azure:

  • --resource: use uma palavra-chave para selecionar um recurso predefinido:
    • mcp (padrão): Ferramentas do Agente 365 para servidores MCP
    • powerplatform: API do Power Platform
  • --resource-id: insira um GUID (ID de aplicativo de recurso) personalizado para recursos não cobertos por palavras-chave

Importante

--resource e --resource-id não podem ser usados juntos. Ao usar qualquer uma das opções, inclua --scopes. Somente o fluxo MCP padrão dá suporte à resolução de escopo baseada em manifesto.

develop start-mock-tooling-server

Inicie um servidor de ferramentas fictício para fins de teste e desenvolvimento.

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

Esse comando inicia um servidor de ferramentas fictício para fins de teste e desenvolvimento. Usando esse servidor, você pode simular interações de servidor MCP sem exigir implementações reais do servidor.

start-mock-tooling-server opções

Use essas opções para personalizar o comportamento do start-mock-tooling-server comando.

Opção Description Padrão
-p, --port <port> Número da porta para o servidor fictício 5309
-v, --verbose Habilitar o registro em log detalhado false
-?, -h, --help Mostrar informações de ajuda e uso -
-bg Executar o servidor em um novo terminal -
  • Last updated on