Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
A CLI do Agent 365 é uma ferramenta de linha de comandos entre plataformas para implementar e gerir aplicações do Agent 365 no Azure.
Não precisa de instalar a CLI manualmente. A configuração orientada por IA verifica a CLI, instala-a ou atualiza-a automaticamente e executa todos os comandos necessários em seu nome. Esta página é uma referência para programadores que precisam instalar ou utilizar a CLI diretamente - por exemplo, ao criar a automatização de CI/CD, resolver problemas num passo específico ou trabalhar sem um agente de codificação de IA.
Nota
O fluxo de trabalho completo do programador – incluindo a configuração orientada por IA, a orientação de funções e os passos pós-implementação – encontra-se em Introdução ao desenvolvimento do Agent 365. Esta página é a referência da CLI: instalação, atualização, desinstalação, comandos disponíveis e resolução de problemas.
Pré-requisitos
A CLI requer .NET 8.0 ou posterior. Para todos os outros pré-requisitos – subscrição do Azure, funções necessárias no Entra e registo de aplicações cliente personalizadas – consulte configuração orientada por IA.
Instalar a CLI do Agent 365
Utilize os passos seguintes para instalar a CLI do Agent 365 globalmente no seu sistema operativo.
Pré-requisitos
É necessário ter o .NET instalado. (Recomenda-se a utilização do .NET 8.0.)
Utilizar dotnet tool install
Instale a CLI do Agent 365 utilizando o seguinte comando:
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli
Para obter as instruções mais recentes e as versões disponíveis, visite a página oficial do NuGet: Microsoft.Agents.A365.DevTools.Cli no NuGet.org
Verificar instalação
Depois de instalar a CLI do Agent 365, verifique se está corretamente instalada executando o comando --help:
a365 -h
Este comando apresenta a ajuda e confirma que a CLI está pronta a ser utilizada.
Atualizar
Atualize A CLI do Agent 365 utilizando o comando dotnet tool update:
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli
Nota
Para atualizar a CLI do Agent 365, precisa de uma ligação à internet para aceder ao pacote do NuGet mais recente: Microsoft.Agents.A365.DevTools.Cli.
Desinstalar
Desinstale a CLI do Agent 365 utilizando o comando dotnet tool uninstall:
dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli
Localizações dos ficheiros
A localização predefinida do ficheiro executável de uma ferramenta depende do sistema operativo:
| SO | Caminho |
|---|---|
| Linux/macOS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
O SDK adiciona esta localização ao caminho quando é executado pela primeira vez. É possível invocar ferramentas globais a partir de qualquer diretório sem especificar a localização da ferramenta.
O acesso às ferramentas é específico do utilizador, não global da máquina. Uma ferramenta global está disponível apenas para o utilizador que a instala.
Comandos disponíveis
Para obter a lista completa de comandos disponíveis, utilize o comando --help ou consulte a Referência da CLI do Agent 365.
Sugestão
Não é necessário executar comandos da CLI manualmente. A configuração orientada por IA automatiza todo o fluxo de trabalho – instalação da CLI, configuração, definição do esquema, implementação e publicação – utilizando um agente de codificação de IA. Utilize aqui a referência da CLI se estiver a criar automatização de CI/CD, a solucionar problemas numa etapa específica ou a trabalhar sem um agente de codificação de IA.
Para obter instruções completas sobre como configurar um agente do Agent 365 utilizando a CLI, consulte Introdução ao desenvolvimento do Agent 365.
Resolução de Problemas
Esta secção fornece informações sobre como resolver erros com a CLI do Agent 365.
Sugestão
O Guia de Resolução de Problemas do Agent 365 inclui recomendações de resolução de problemas de alto nível, melhores práticas e ligações para conteúdo de resolução de problemas para cada parte do ciclo de vida de desenvolvimento do Agent 365.
Problemas específicos da CLI abordados nesta secção:
O agente não aparece no Teams
Resolução de problemas na criação de instâncias de agentes: o agente não aparece no Teams