Partilhar via


Referência CLI do Agente 365

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.

A referência Agent 365 CLI é uma interface abrangente de linha de comandos para construir, implementar e gerir agentes de IA para Microsoft 365. Saiba como começar com a CLI do Agente 365.

Opções globais

Todos os comandos suportam estas opções globais:

  • --version: Mostrar informação da versão.
  • -?, -h, --help: Mostrar informação de ajuda e utilização.

Commands

A tabela seguinte lista os comandos disponíveis.

Sugestão

Cada comando tem requisitos específicos de função. Consulte as páginas de referência de comandos individuais para o papel mínimo necessário para executar cada comando. Por exemplo, o comando setup requer Azure Contributor + Global Administrator.

Command Description
cleanup Limpa os recursos ALL (blueprint, instance e Azure). Usa subcomandos para limpeza detalhada.
cleanup blueprint Remover a aplicação do blueprint do Entra ID e o principal de serviço.
cleanup azure Remover recursos do Azure (App Service, App Service Plan).
cleanup instance Remover a identidade da instância do agente e o utilizador do Entra ID.
config Gerir a configuração da CLI do Agente 365. Fornece opções para gerir as definições de configuração da CLI do Agente 365.
config init Configure interativamente a CLI do Agente 365 ou importe a partir de um ficheiro.
config display Mostrar a configuração atual do CLI do Agente 365.
create-instance Removido temporariamente - Este comando é removido temporariamente. Usa a365 publish e cria uma instância de agente através do Teams em vez disso.
deploy Implante binários de aplicação Agent 365 para o Azure App Service configurado e atualize as permissões da Agent 365 Tool
deploy app Implementa o código do seu agente na aplicação web do Azure criada durante a configuração.
deploy mcp Atualiza as permissões do servidor MCP no seu blueprint do agente.
develop Gerir servidores de ferramentas MCP para desenvolvimento de agentes.
develop list-available Lista todos os servidores MCP disponíveis no catálogo (o que podes instalar).
develop list-configured Liste os servidores MCP atualmente configurados do seu local ToolingManifest.json.
develop add-mcp-servers Adicionar servidores MCP à configuração atual do agente.
develop remove-mcp-servers Remover os servidores MCP da configuração atual do agente.
develop add-permissions Adicione permissões da API do servidor MCP às aplicações Microsoft Entra para cenários de desenvolvimento onde precisa de configurar aplicações personalizadas para aceder a servidores MCP.
develop get-token Recuperar tokens portadores para testar servidores MCP durante o desenvolvimento usando autenticação interativa do navegador.
develop start-mock-tooling-server Inicie um servidor de ferramentas simuladas para fins de teste e desenvolvimento.
develop-mcp Gerir servidores MCP em ambientes Dataverse.
develop-mcp list-environments Liste todos os ambientes Dataverse disponíveis para gestão de servidores MCP.
develop-mcp list-servers Liste servidores MCP num ambiente Dataverse específico.
develop-mcp publish Publique um servidor MCP num ambiente Dataverse.
develop-mcp unpublish Despublicar um servidor MCP de um ambiente Dataverse.
develop-mcp approve Aprove um servidor MCP.
develop-mcp block Bloqueia um servidor MCP.
develop-mcp package-mcp-server Gerar o pacote do servidor MCP para submissão no Microsoft Admin Center.
publish Atualize os valores do ID e manifest.json crie um manifest.zip pacote para carregar no centro de administração do Microsoft 365.
query-entra Oferece opções para consultar o Microsoft Entra ID para obter informações do agente, incluindo alcances, permissões e estado de consentimento.
query-entra blueprint-scopes Liste os escopos configurados e o estado do consentimento para o blueprint do agente.
query-entra instance-scopes Liste os escopos configurados e o estado de consentimento para a instância do agente.
setup Configura o teu ambiente Agent 365 com controlo granular em cada etapa.
setup requirements Valide os pré-requisitos para a configuração do Agent 365.
setup infrastructure Criar infraestrutura Azure.
setup blueprint Crie o blueprint do agente (registo da candidatura Entra ID).
setup permissions Configure concessões de permissões e permissões hereditárias do OAuth2.
setup permissions mcp Configure concessões OAuth2 do servidor MCP e permissões herdáveis.
setup permissions bot Configurar concessões e permissões herdantes da API do bot de mensagens.
setup permissions copilotstudio Configura concessões de permissões OAuth2 e permissões hereditárias para o agente blueprint para invocar copilots do Copilot Studio através da API Power Platform.
setup permissions custom Aplica permissões de API personalizadas ao blueprint do seu agente que vão além das permissões padrão exigidas para a operação do agente.
setup all Execute todos os passos de configuração para configurar o seu ambiente Agent 365