Referência CLI do Agente 365

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

Global options

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.

Tip

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 + Agent ID Developer no mínimo. Administrador Global é necessário apenas para concessões de autorização OAuth2; quando um Administrador Global é uma pessoa diferente, a365 setup all imprime os passos seguintes que precisa de completar. Para concessões de identidade de agente S2S (Server-to-Server) (--authmode s2s ou both), é necessário Administrador de ID de Agente ou superior.

Command	Description
cleanup	Limpa os recursos ALL (blueprint, instance e Azure). Usa subcomandos para limpeza detalhada.
cleanup azure	Remover recursos do Azure (App Service, App Service Plan).
cleanup blueprint	Remover a aplicação do blueprint da Entra ID e o principal de serviço.
cleanup instance	Remover a identidade da instância do agente e o utilizador do Entra ID.
develop	Gerir servidores de ferramentas MCP para desenvolvimento de agentes.
develop add-mcp-servers	Adicionar servidores MCP à 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 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 remove-mcp-servers	Remover os servidores MCP da configuração atual do agente.
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 approve	Aprove um servidor MCP.
develop-mcp block	Bloqueia um servidor MCP.
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 package-mcp-server	Gerar o pacote do servidor MCP para submissão no Microsoft Admin Center.
develop-mcp publish	Publique um servidor MCP num ambiente Dataverse.
develop-mcp register-external-mcp-server	Registe um servidor MCP externo com Entra, OAuth externo, chave API ou sem autenticação.
develop-mcp unpublish	Despublicar um servidor MCP de um ambiente Dataverse.
publish	Atualize os valores de ID em manifest.json e crie um pacote manifest.zip 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 all	Execute todos os passos de configuração para configurar o seu ambiente Agent 365
setup blueprint	Criar um plano de agente (registo de candidatura Entra ID).
setup permissions	Configure concessões de permissões e permissões hereditárias do OAuth2.
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 herdadas para o blueprint do agente invocar copilots do Copilot Studio através da API do 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 permissions mcp	Configure concessões OAuth2 do servidor MCP e permissões herdáveis.
setup requirements	Valide os pré-requisitos para a configuração do Agent 365.