Partilhar via

Referência de comando CLI deploy 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.

Implante binários de aplicação Agent 365 para a Azure App Service configurada e atualize permissões da Ferramenta Agent 365 O comando deploy oferece opções para criar implantações Agent 365. Use este comando para implantar binários de aplicação na sua infraestrutura Azure e conceder permissões ao Agent 365 Tools.

Função mínima exigida: Azure Contribuidor + Administrador Global

Para informações sobre o uso deste comando, veja Deploy agent to Azure.

Sintaxe

a365 deploy [command] [options]

Opções

Opção Description
-c, --config <config> Caminho para o ficheiro de configuração (padrão: a365.config.json)
-v, --verbose Ativar registo verboso
--dry-run Mostra o que seria feito sem executar
--inspect Pausa antes da implementação para inspecionar o conteúdo da pasta de publicação e do ZIP
--restart Pular a compilação e começar a comprimir a pasta de publicação existente (para iteração rápida após alterações manuais)
-?, -h, --help Mostrar ajuda e informação de utilização

Observações

Executar a365 deploy sem subcomando executa uma implementação em duas fases:

  • Fase 1 — Binários da aplicação: Constrói e implementa a sua aplicação para Azure App Service.
  • Fase 2 — permissões MCP: Lê os escopos necessários e toolingManifest.json atualiza o blueprint do agente com as permissões necessárias.

Ambas as fases correm de forma equilibrada com --dry-run. A saída do ensaio a seco está dividida em duas secções rotuladas para que possas rever o que cada fase faria.

Verificações pré-voo

Antes de ser implementado, o CLI valida:

  • Azure autenticação e subscrição: A sua sessão Azure CLI e subscrição devem ser válidas. Se não, a implementação para com um erro. Corrigir com az login --tenant <TENANT_ID> e az account set --subscription <SUBSCRIPTION_ID>.
  • Azure App Service existência: A aplicação web alvo deve existir antes da implementação prosseguir. Se a aplicação não for encontrada, execute a365 setup ou corra webAppName e resourceGroup em a365.config.json.

Configuração

A CLI lê a partir de dois ficheiros de configuração:

  • a365.config.json — configuração do seu projeto (mantida pelo utilizador).
  • a365.generated.config.json — estado dinâmico gerado por comandos de configuração.

Os escopos das ferramentas MCP são lidos no toolingManifest.json diretório do seu projeto de implementação.

A CLI também armazena uma cópia global da configuração e do estado em:

  • Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli
  • Linux/macOS:~/.config/a365

Comportamento da bandeira

--restart: Salta a etapa de construção e começa diretamente a comprimir a pasta existente publish/ . Se publish/ não existir, a implementação falha. Executa uma implementação completa (sem --restart) primeiro para produzir a publish/ pasta.

--inspect: Pausa antes do passo de upload para que possas inspecionar a publish/ pasta e o ficheiro ZIP gerado. Disponível apenas na fase de aplicação.

--dry-run: Imprime tudo o que aconteceria sem fazer qualquer alteração. Quando está a funcionar a365 deploy (bifásico), a saída é dividida em:

  • Parte 1 — Implantar binários de aplicações
  • Parte 2 — Implementar/atualizar permissões da ferramenta Agent 365

deploy app

Implementa o código do seu agente na aplicação web do Azure criada durante a configuração.

a365 deploy app [options]

Implemente os binários da aplicação Microsoft Agent 365 para o Azure App Service configurado. Este comando implementa binários de aplicação para o seu serviço de aplicação Azure configurado no Azure.

app Opções

Opção Description
-c, --config <config> Caminho para o ficheiro de configuração (padrão: a365.config.json)
-v, --verbose Ativar registo verboso
--dry-run Mostra o que seria feito sem executar
--inspect Pausa antes da implementação para inspecionar o conteúdo da pasta de publicação e do ZIP
--restart Pular a compilação e começar a comprimir a pasta de publicação existente (para iteração rápida após alterações manuais)
-?, -h, --help Mostrar ajuda e informação de utilização

deploy mcp

Atualiza as permissões do servidor MCP no seu blueprint do agente.

a365 deploy mcp [options]

mcp Opções

Opção Description
-c, --config <config> Caminho do ficheiro de configuração (padrão: a365.config.json)
-v, --verbose Ativar registo verboso
--dry-run Mostra o que seria feito sem executar
-?, -h, --help Mostrar ajuda e informação de utilização

Notas de utilização

Atualize os escopos e permissões dos servidores MCP no blueprint do agente existente. Este comando adiciona permissões para as Ferramentas do Agente 365 ao blueprint do agente.

Se adicionar ou modificar servidores MCP no código do seu agente, use este comando para atualizar as permissões no blueprint do seu agente.

Este comando:

  • Lê a configuração do teu servidor MCP a partir do teu código.
  • Atualiza o blueprint do agente com as permissões necessárias.
  • Concede as permissões necessárias da API para os servidores MCP.

A atualização de permissão aplica-se pela seguinte ordem:

  1. Concessão de permissão OAuth2 (principal de serviço blueprint → plataforma MCP)
  2. Permissões herdadas (agente blueprint → recurso MCP)
  3. Consentimento do administrador (identidade do agente → plataforma MCP)

Quando usar deploy mcp:

  • Depois de adicionar novos servidores MCP ao seu agente.
  • Depois de mudar as configurações dos servidores MCP.
  • Quando as ferramentas MCP não estiverem acessíveis ao seu agente.

Não precisas de correr deploy mcp:

  • No destacamento inicial. Isto é tratado automaticamente durante a configuração.
  • Quando só mudar a lógica do agente sem alterações MCP.
  • Depois de atualizações rotineiras de código que não afetam as ferramentas.

Observação

a365 deploy mcp Só atualiza permissões – não implementa o teu código. Executa a365 deploy app primeiro se tiveres alterações no código.

Troubleshooting

Use as secções seguintes para resolver potenciais problemas com o deploy comando.

Não iniciado no Azure ou subscrição errada

Execute az login --tenant <TENANT_ID> e az account set --subscription <SUBSCRIPTION_ID>.

Aplicação Web não encontrada

Certifique-se a365 setup de que foi executado, ou verifique que webAppName está correto resourceGroup em a365.config.json.

Falha na atualização de permissões

  • Confirme AgentBlueprintId, AgenticAppId, e ambiente estão definidos em a365.config.json.
  • Garanta que a sua conta tem direitos para gerir os principais de serviços e subsídios.
  • Verifica se existe no diretório do teu projeto de implementação e contém toolingManifest.json escopos válidos.

--restart falha

Executa uma implementação completa sem --restart produzir a publish/ pasta e depois usa --restart para as iterações seguintes.

Registos

Os ficheiros de registo CLI são armazenados em:

  • Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli\logs\
  • Linux/macOS:~/.config/a365/logs/

Para visualizar as últimas 80 linhas do último ficheiro de registo de deploy, use Get-Content no Windows ou tail no Linux/macOS:

# Windows
Get-Content $env:LOCALAPPDATA\Microsoft.Agents.A365.DevTools.Cli\logs\a365.deploy.log -Tail 80

# Linux/macOS
tail -80 ~/.config/a365/logs/a365.deploy.log

Para registos de aplicações em tempo de execução, use Log Stream no portal Azure para stdout/stderr do seu Serviço de Aplicações.

  • Last updated on