Compartilhar via

Agente 365 CLI

Importante

Você precisa fazer parte do programa de visualização Frontier para obter acesso antecipado ao Microsoft 365 Agent. A Frontier conecta você diretamente com as inovações de IA mais recentes da Microsoft. As versões preliminares da Frontier estão sujeitas aos termos de versão preliminar existentes dos contratos de cliente. Como esses recursos ainda estão em desenvolvimento, sua disponibilidade e capacidades podem mudar ao longo do tempo.

A CLI do Agent 365 é uma ferramenta de linha de comando multiplataforma para implantar e gerenciar aplicativos do Agente 365 em Azure.

Pré-requisitos

Antes de começar, verifique se você tem os seguintes pré-requisitos:

Observação

Durante a a365 config init etapa (após a instalação), a CLI valida automaticamente o registro do seu aplicativo personalizado verificando se o app existe, possui as permissões necessárias e o consentimento do administrador.

Dica

Comandos CLI diferentes exigem papéis ou permissões diferentes. Cada página de referência de comando especifica o papel mínimo exigido. Por exemplo, consulte a referência do comandosetup para saber seus requisitos específicos.

Instale a CLI do Agent 365

Use os passos a seguir para instalar a CLI do Agent 365 globalmente no seu sistema operacional.

Pré-requisitos

Você deve ter .NET instalado. (é recomendável .NET 8.0.)

dotnet tool install

Instale a CLI do Agente 365 usando o seguinte comando com o --prerelease parâmetro:

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

Importante

O CLI do Agent 365 ainda está em versão de prévia. Até que a CLI do Agente 365 esteja geralmente disponível, sempre use o --prerelease parâmetro para obter a versão mais recente com as correções e recursos mais recentes. Quando o CLI do Agente 365 ficar disponível de forma geral, o --prerelease parâmetro não será necessário.

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

Verifique a instalação

Após instalar a CLI do Agente 365, verifique se ela está corretamente instalada executando o --help comando:

a365 -h

Esse comando exibe as informações de ajuda e confirma que o CLI está pronto para uso.

Atualizar

Atualize a CLI do Agente 365 usando o comando dotnet tool update com o parâmetro --prerelease.

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

Observação

Para atualizar a CLI do Agente 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 Agente 365 usando o comando de desinstalação da ferramenta dotnet:

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

Locais de arquivos

O local padrão para um 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 essa localização ao seu caminho quando você o executa pela primeira vez. Assim, você pode invocar ferramentas globais de qualquer diretório sem especificar a localização da ferramenta.

O acesso à ferramenta é específico do usuário, não do computador global. Uma ferramenta global está disponível apenas para o usuário que a instalar.

Comandos disponíveis

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

Solução de problemas

Esta seção fornece informações sobre como solucionar erros com a CLI do Agente 365.

Dica

O Guia de Solução de Problemas do Agente 365 contém recomendações de resoluçã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 desenvolvimento do Agente 365.

Questões específicas de CLI abordadas nesta seção:

Not found in NuGet feeds erro ao instalar, atualizar ou desinstalar

Sintoma:microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json erro ao instalar, atualizar ou desinstalar a CLI do Agent 365.

Solução: Use o --prerelease parâmetro.

Todas as versões atuais da CLI são versões pré-lançamento.

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

# For updates
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli --prerelease

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

agente não aparece no Microsoft Teams

Criação de instâncias de agente - Solução de problemas: agente não aparece no Teams

Não é possível criar instância de agente no Teams

Solução de problemas para criar instâncias de agente: Não é possível criar instância de agente no Teams

  • Last updated on