Referência de comando da CLI deploy do Agent 365

Implantar binários de aplicativo do Agente 365 nas permissões configuradas da ferramenta de Azure App Service e atualização do Agente 365 O comando deploy fornece opções para criar implantações do Agent 365. Use este comando para implantar binários de aplicativos em sua infraestrutura de Azure e conceder permissões às Ferramentas do Agente 365.

função Minimum necessária: Azure Colaborador + Administradorglobal

Para obter informações sobre como usar esse comando, consulte Deploy agent to Azure.

Sintaxe

a365 deploy [command] [options]

Opções

Observações

Executar a365 deploy sem um subcomando executa uma implantação de duas fases:

• Fase 1 — Binários de aplicativo: compila e implanta seu aplicativo para Azure App Service.
• Fase 2 – permissões MCP: lê os escopos necessários e atualiza o blueprint do toolingManifest.json agente com as permissões necessárias.

Ambas as fases são executadas mesmo com --dry-run. A saída de execução seca é dividida em duas seções rotuladas para que você possa examinar o que cada fase faria.

Verificações de pré-vôo

Antes de implantar, a CLI valida:

• Azure autenticação e assinatura: sua sessão e assinatura Azure CLI devem ser válidas. Caso contrário, a implantação será interrompida com um erro. Correção com az login --tenant <TENANT_ID> e az account set --subscription <SUBSCRIPTION_ID>.
• Azure App Service existência: o aplicativo Web de destino deve existir antes que a implantação continue. Se o aplicativo não for encontrado, executado a365 setup ou correto webAppName e resourceGroup em a365.config.json.

Configuração

A CLI lê de dois arquivos de configuração:

• a365.config.json — a configuração do projeto (mantida pelo usuário).
• a365.generated.config.json — estado dinâmico gerado por comandos de instalação.

Os escopos da ferramenta MCP são lidos no diretório do projeto de toolingManifest.json implantaçã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 do sinalizador

--restart: ignora a etapa de build e começa diretamente da compactação da pasta existente publish/ . Se publish/ não existir, a implantação falhará. Execute uma implantação completa (sem --restart) primeiro para produzir a publish/ pasta.

--inspect: pausa antes da etapa de carregamento para que você possa inspecionar a publish/ pasta e o arquivo ZIP gerado. Disponível apenas para a fase do aplicativo.

--dry-run: imprime tudo o que aconteceria sem fazer nenhuma alteração. Ao executar a365 deploy (duas fases), a saída é dividida em:

• Parte 1 – Implantar binários de aplicativo
• Parte 2 – Implantar/atualizar permissões da Ferramenta do Agente 365

deploy app

Implanta o código do agente no Azure Aplicativo Web criado durante a instalação.

a365 deploy app [options]

Implante binários de aplicativos do Microsoft Agent 365 no Azure App Service configurado. Esse comando implanta binários de aplicativo no serviço de aplicativo Azure configurado no Azure.

app opções

deploy mcp

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

a365 deploy mcp [options]

mcp opções

Notas de utilização

Atualize escopos e permissões de servidores MCP no blueprint do agente existente. Esse comando adiciona permissões para o Agent 365 Tools ao blueprint do agente.

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

Esse comando:

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

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

1. Concessão de permissão OAuth2 (entidade de serviço de blueprint → plataforma MCP)
2. Permissões herdáveis (blueprint do agente → 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 alterar as configurações do servidor MCP.
• Quando as ferramentas MCP não estão acessíveis ao seu agente.

Você não precisa executar deploy mcp:

• Na implantação inicial. Isso é tratado automaticamente durante a instalação.
• Ao alterar apenas a lógica do agente sem alterações de MCP.
• Após atualizações de código de rotina que não afetam as ferramentas.

Solução de problemas

Use as seções a seguir para resolver possíveis problemas com o deploy comando.

• Não conectado à assinatura Azure ou incorreta
• Aplicativo Web não encontrado
• Falha na atualização de permissões
• --restart Falhar

Não conectado à assinatura Azure ou incorreta

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

Aplicativo Web não encontrado

Verifique se a365 setup foi executado ou verifique se webAppNameresourceGroup ele está correto.a365.config.json

Falha na atualização de permissões

• Confirme AgentBlueprintId, AgenticAppIde o ambiente está definido em a365.config.json.
• Verifique se sua conta tem direitos para gerenciar entidades de serviço e concessões.
• Verifique se existe toolingManifest.json no diretório do projeto de implantação e se ele contém escopos válidos.

--restart falha

Execute uma implantação completa sem --restart produzir a publish/ pasta e use --restart para iterações subsequentes.

Logs

Os arquivos de log da CLI são armazenados em:

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

Para exibir as últimas 80 linhas do arquivo de log de implantação mais recente, use Get-Content em 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 logs de aplicativos de runtime, use Log Stream no portal Azure para stdout/stderr do serviço de aplicativo.