Partilhar via

Agente 365 CLI

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.

O Agent 365 CLI é uma ferramenta de linha de comandos multiplataforma para implementar e gerir aplicações Agent 365 no Azure.

Instale a CLI do Agent 365

Use os passos seguintes para instalar a CLI do Agent 365 globalmente no seu sistema operativo.

Pré-requisitos

Deve ter o .NET instalado. É recomendado o TLS 1.2.

Use a instalação da ferramenta dotnet

Instale o Agente Convidado com o seguinte comando:

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli

Se receber um microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json erro, use o --prerelease parâmetro, pois este pacote pode ainda estar marcado como pré-lançamento.

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease

Para 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 o Agent 365 CLI, verifique se está corretamente instalado executando:

a365 -h

Este comando mostra a informação de ajuda e confirma que o CLI está pronto a ser usado.

Atualizar

Atualize a CLI do Agente 365 usando o comando de atualização da ferramenta dotnet:

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli

Nota

Todas as atualizações para o Agent 365 CLI requerem ligação à internet para aceder ao pacote Nuget mais recente: Microsoft.Agents.A365.DevTools.Cli

Desinstalar

Desinstale a CLI do Agente 365 usando o comando de desinstalação da ferramenta dotnet:

dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli

Localização do ficheiro

A localização padrão do ficheiro executável de uma ferramenta depende do sistema operativo:

SO Caminho
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Esta localização é adicionada ao caminho do utilizador quando o SDK é executado pela primeira vez. Assim, ferramentas globais podem ser invocadas a partir de qualquer diretório sem especificar a localização da ferramenta.

O acesso à ferramenta é específico do utilizador, não global da máquina. Uma ferramenta global está disponível apenas para o utilizador que instalou a ferramenta.

Comandos disponíveis

Para a lista completa de comandos disponíveis, utilize o --help comando ou consulte a Referência CLI do Agente 365

Resolução de problemas

Esta secção contém informações sobre como resolver erros com a CLI do Agente 365.

Instalação, atualização ou desinstalação da CLI falha com Not found in NuGet feeds

Se receber um microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json erro, por favor use o --prerelease parâmetro, pois este pacote pode ainda estar marcado como pré-lançamento.

Para 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

A configuração falha com Authorization_RequestDenied erro

Se receber um Authorization_RequestDenied erro ao executar setup um comando, isso indica um problema de permissões no seu ambiente Microsoft Entra.

Causas comuns

Este problema ocorre normalmente quando:

  • A sua conta não tem as permissões necessárias
  • A aplicação Microsoft Graph Command Line Tools requer consentimento do administrador
  • Permissões conflitantes ou com privilégios excessivos estão presentes no seu ambiente

Passos de resolução

  1. Verifique se a sua conta tem a função Leitor

    Certifique-se de que está iniciado com uma conta que tenha uma destas funções:

    • Agent ID Developer
    • Administrador de ID de Agente
    • Administrador Global

  2. Rever e conceder consentimento de administrador para as Ferramentas de Linha de Comando Microsoft Graph

    O comando de configuração a365 utiliza a aplicação Microsoft Graph Command Line Tools, que pode ter permissões conflitantes.

    Para rever e corrigir:

    1. Inicie sessão no portal do Azure

    2. Procure por Microsoft Graph Command Line Tools ou pesquise por ID de Aplicação: 14d82eec-204b-4c2f-b7e8-296a70dab67e

    3. Selecione permissões de segurança>na área de navegação.

    4. Procura a Directory.AccessAsUser.All permissão

      • Esta permissão altamente privilegiada interfere na criação do blueprint
      • Se existir, considere removê-lo ou substituí-lo por alternativas de privilégio mínimo, tais como Directory.Read.All

      Aviso

      Só remova esta permissão se tiver a certeza de que não é exigida por outras ferramentas ou scripts no seu ambiente

    5. Se o consentimento do administrador ainda não for concedido, selecione Conceder consentimento do administrador para [o seu inquilino].

  3. Depois de fazer alterações, volta a correr a365 setup

Recursos adicionais

Para mais informações sobre este problema conhecido, consulte Microsoft Entra Agent ID Known issues - Directory.AccessAsUser.All faz com que outras permissões sejam ignoradas.

  • Last updated on