Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
A CLI do Agent 365 é uma ferramenta multiplataforma de linha de comando para implantar e gerenciar aplicativos do Agent 365 no Azure.
Não é preciso instalar a CLI manualmente. A configuração orientada por IA verifica a CLI, instala ou atualiza-a automaticamente e executa todos os comandos necessários em seu nome. Esta página é uma referência para desenvolvedores que precisam instalar ou usar a CLI diretamente – por exemplo, ao criar automação de CI/CD, solucionar problemas em uma etapa específica ou trabalhar sem um agente de codificação de IA.
Observação
O fluxo de trabalho completo do desenvolvedor, incluindo configuração guiada por IA, orientações sobre funções e etapas pós-implantação, está em Introdução ao desenvolvimento com o Agent 365. Esta página serve como a referência da CLI: instalação, atualização, desinstalação, comandos disponíveis e solução de problemas.
Pré-requisitos
A CLI requer .NET 8.0 ou posterior. Para todos os outros pré-requisitos — assinatura do Azure, funções obrigatórias no Entra e registro personalizado de aplicativo cliente — consulte Configuração guiada por IA.
Instalar a CLI do Agent 365
Use as etapas a seguir para instalar a CLI do Agent 365 globalmente em seu sistema operacional.
Pré-requisitos
Você precisa ter o .NET instalado. (Recomenda-se o .NET 8.0.)
Usar o comando dotnet tool install
Instale a CLI do Agent 365 usando o comando a seguir:
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli
Para obter as instruções mais recentes e versões disponíveis, acesse a página oficial do NuGet: Microsoft.Agents.A365.DevTools.Cli em NuGet.org
Verificar a instalação
Depois de instalar a CLI do Agent 365, verifique se ele está corretamente instalado executando o comando --help:
a365 -h
Este comando exibe as informações de ajuda e confirma que a CLI está pronta para uso.
Atualizar
Atualize a CLI do Agent 365 usando o comando dotnet tool update:
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli
Observação
Para atualizar a CLI do Agent 365, você precisa de uma conexão com a Internet para acessar o pacote NuGet mais recente: Microsoft.Agents.A365.DevTools.Cli.
Desinstalar
Desinstale a CLI do Agent 365 usando o comando dotnet tool uninstall:
dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli
Locais de arquivos
O local padrão para o arquivo executável de uma ferramenta depende do sistema operacional:
| Sistema operacional | Caminho |
|---|---|
| Linux/macOS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
O SDK adiciona esse local ao seu caminho quando você o executa pela primeira vez. Assim, você poderá invocar ferramentas globais de qualquer diretório sem especificar o local da ferramenta.
O acesso à ferramenta é específico do usuário, não do computador global. A ferramenta global está disponível somente para o usuário que a instalou.
Comandos disponíveis
Para obter a lista completa de comandos disponíveis, use o comando --help ou consulte a Referência da CLI do Agent 365.
Dica
Você não precisa executar comandos da CLI manualmente. A configuração guiada por IA automatiza todo o fluxo de trabalho — instalação, configuração da CLI, configuração do blueprint, implantação e publicação — usando um agente de codificação de IA. Use a referência da CLI aqui se você estiver criando automação de CI/CD, solucionando problemas em uma etapa específica ou trabalhando sem um agente de codificação de IA.
Para obter instruções completas sobre como configurar um agente do Agent 365 usando a CLI, consulte Introdução ao desenvolvimento do Agent 365.
Solução de Problemas
Esta seção fornece informações sobre como solucionar problemas de erros com a CLI do Agent 365.
Dica
O Guia de Solução de Problemas do Agent 365 contém recomendações de solução de problemas de alto nível, melhores práticas e links para conteúdo de solução de problemas para cada parte do ciclo de vida de desenvolvimento do Agent 365.
Problemas específicos da CLI abordados nesta seção:
O agente não aparece no Teams
Solução de problemas para instâncias de agente: o agente não aparece no Teams