Partilhar via

Referência de comando CLI develop do Agente 365

Importante

É necessário fazer parte do programa de pré-visualização Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier liga-o diretamente às mais recentes inovações de IA da Microsoft. As pré-visualizações da Frontier estão sujeitas aos termos de pré-visualização existentes dos seus contratos com clientes. Como estas funcionalidades ainda estão em desenvolvimento, a sua disponibilidade e capacidades podem mudar ao longo do tempo.

Gerir servidores de ferramentas MCP para desenvolvimento de agentes. O develop comando fornece opções para gerir servidores de ferramentas MCP (Model Context Protocol) para desenvolvimento de agentes. Pode listar servidores disponíveis, visualizar servidores configurados e adicionar ou remover servidores MCP da configuração do seu agente.

Função mínima exigida: Nenhuma (gestão local de manifestos)

Sintaxe

a365 develop [command] [options]

Opções

Opção Description
-c, --config <config> Caminho do ficheiro de configuração. Padrão: a365.config.json
-v, --verbose Ativar registo verboso
-?, -h, --help Mostrar informações de ajuda e utilização.

develop list-available

Lista todos os servidores MCP disponíveis no catálogo (o que podes instalar).

a365 develop list-available [options]

Este comando mostra todos os servidores MCP disponíveis no catálogo e pode instalá-los para uso no desenvolvimento do seu agente.

list-available Opções

Opção Description
-c, --config <config> Caminho do ficheiro de configuração. Padrão: a365.config.json
--dry-run Mostra o que o comando faria sem o executar.
--skip-auth Ignora a autenticação. Apenas para testes. O comando provavelmente falha sem autenticação válida.
-?, -h, --help Mostrar informações de ajuda e utilização.

develop list-configured

Liste os servidores MCP atualmente configurados do seu local ToolingManifest.json.

a365 develop list-configured [options]

Este comando mostra todos os servidores MCP que configuraste atualmente no teu ficheiro ToolingManifest.json local.

list-configured Opções

Opção Description
-c, --config <config> Caminho do ficheiro de configuração. Padrão: a365.config.json
--dry-run Mostra o que o comando faria sem o executar.
-?, -h, --help Mostrar informações de ajuda e utilização.

develop add-mcp-servers

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

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

Este comando adiciona os servidores MCP especificados na ToolingManifest.json pasta do seu projeto. Não concede permissões ao blueprint do agente.

Importante

Este comando apenas atualiza ToolingManifest.json — não concede permissões ao blueprint do agente. A forma como as permissões são aplicadas depende de onde se encontra no processo de configuraçã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 de o blueprint já existir: Um Administrador Global deve ser executado a365 setup permissions mcp separadamente. O administrador deve primeiro correr a365 config display para verificar que deploymentProjectPath no seu a365.config.json ponto aponta para a pasta do projeto que contém o arquivo atualizado ToolingManifest.json.

add-mcp-servers Argumentos

Especifique um ou mais nomes de servidores MCP para adicionar à configuração do seu agente. Pode fornecer vários nomes de servidores separados por espaços.

Argument Description
<servers> Nomes dos servidores MCP a adicionar

add-mcp-servers Opções

Use estas opções para personalizar o comportamento do add-mcp-servers comando, incluindo seleção de ficheiros de configuração e testes de execução.

Opção Description
-c, --config <config> Caminho do ficheiro de configuração. Padrão: a365.config.json
--dry-run Mostra o que o comando faria sem o executar.
-?, -h, --help Mostrar informações de ajuda e utilização.

develop remove-mcp-servers

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

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

Este comando remove servidores MCP especificados da sua configuração atual de agentes.

remove-mcp-servers Argumentos

Argument Description
<servers> Nomes dos servidores MCP a remover

remove-mcp-servers Opções

Opção Description
-c, --config <config> Caminho do ficheiro de configuração. Padrão: a365.config.json
--dry-run Mostra o que o comando faria sem o executar.
-?, -h, --help Mostrar informações de ajuda e utilização.

develop add-permissions

Adicione permissões da API do servidor MCP às aplicações Microsoft Entra para cenários de desenvolvimento onde precisa de configurar aplicações personalizadas para aceder a servidores MCP.

a365 develop add-permissions [options]

add-permissions Opções

Use estas opções para adicionar permissões e âmbitos necessários da API ao registo da sua aplicação, aproveitando valores do manifesto de ferramentas.

Opção Description
-c, --config <config> Caminho do ficheiro de configuração (predefinido: a365.config.json)
-m, --manifest <manifest> Caminho para ToolingManifest.json (padrão: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id> ID da aplicação (cliente) para adicionar permissões a (por defeito: clientAppId from config)
--scopes <scopes> Escopos específicos a adicionar (separados por espaço) (padrão: Todos os escopos de ToolingManifest.json)
--dry-run Mostra o que o comando faria sem fazer alterações
-v, --verbose Mostrar resultados detalhados
-?, -h, --help Mostrar informações de ajuda e utilização.

Importante

A aplicação especificada por --app-id ou clientAppId deve ter a permissão Application.ReadWrite.All em Microsoft Entra. Este comando é para aplicações cliente personalizadas. Para configurar permissões para os blueprints dos agentes, use a365 setup permissions mcp em vez disso.

develop get-token

Recuperar tokens portadores para testar servidores MCP durante o desenvolvimento usando autenticação interativa do navegador.

a365 develop get-token [options]

get-token Opções

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

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

get-token Opções de recursos

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

  • --resource: Usar uma palavra-chave para selecionar um recurso pré-definido:
    • mcp (por defeito): Agent 365 Tools para servidores MCP
    • powerplatform: API Power Platform
  • --resource-id: Introduza um ID de aplicação de recurso personalizado (GUID) para recursos não cobertos por palavras-chave

Importante

--resource e --resource-id não podem ser usados em conjunto. Quando usar qualquer uma das opções, inclua --scopes. Apenas o fluxo MCP por defeito suporta resolução de âmbito baseada em manifestos.

develop start-mock-tooling-server

Inicie um servidor de ferramentas simuladas para fins de teste e desenvolvimento.

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

Este comando inicia um servidor de ferramentas simuladas para fins de teste e desenvolvimento. Ao usar este servidor, pode simular interações com servidores MCP sem exigir implementações reais do servidor.

start-mock-tooling-server Opções

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

Opção Description Predefinido
-p, --port <port> Número de porta para o servidor simulado 5309
-v, --verbose Ativar registo verboso false
-?, -h, --help Mostrar ajuda e informação de utilização -
-bg Executa o servidor num novo terminal -
  • Last updated on