Partilhar via

Referência de comando CLI setup 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.

Configura o teu ambiente Agent 365 com controlo granular em cada etapa. Este comando gere o fluxo de trabalho inicial de configuração dos blueprints do Agente 365.

Função mínima exigida: Azure Contribuidor + Administrador Global

Sintaxe

a365 setup [command] [options]

Opções

Opção Description
-?, -h, --help Mostra informação de ajuda e utilização. 
# 0. Check prerequisites (optional)
a365 setup requirements

# 1. Create infrastructure (or skip if infrastructure exists)
a365 setup infrastructure

# 2. Create blueprint
a365 setup blueprint

# 3. Configure MCP permissions
a365 setup permissions mcp

# 4. Configure bot permissions
a365 setup permissions bot

# 5. Configure CopilotStudio permissions (if needed)
a365 setup permissions copilotstudio

# 6. Configure custom permissions (if needed)
a365 setup permissions custom

Ou executar todos os passos de uma vez:

# Full setup (includes infrastructure)
a365 setup all

# Skip infrastructure if it already exists
a365 setup all --skip-infrastructure

setup requirements

Valide os pré-requisitos para a configuração do Agent 365. Executa verificações modulares de requisitos e fornece orientações para quaisquer problemas que encontre.

a365 setup requirements [options]

Este comando executa os seguintes passos:

  • Verifica todos os pré-requisitos necessários para a configuração do Agente 365.
  • Reporta quaisquer problemas com orientações detalhadas de resolução.
  • Continua a verificar todos os requisitos mesmo que algumas verificações falhem.
  • Fornece um resumo de todas as verificações no final.

requirements Opções

Opção Description
-c, --config <config> Caminho do ficheiro de configuração. A predefinição é a365.config.json.
-v, --verbose Mostra resultados detalhados para todas as verificações.
--category <category> Faz verificações apenas para uma categoria específica, como Azure, Authentication ou Configuration.
-?, -h, --help Mostra informação de ajuda e utilização.

setup infrastructure

Criar infraestrutura Azure.

Permissões mínimas necessárias: Contribuidor ou Proprietário de Subscrição Azure

a365 setup infrastructure [options]

infrastructure Opções

Opção Description
-c, --config <config> Caminho do ficheiro de configuração. A predefinição é a365.config.json.
-v, --verbose Mostrar resultados detalhados.
--dry-run Mostra o que seria feito sem executar.
-?, -h, --help Mostra informação de ajuda e utilização.

setup blueprint

Crie o blueprint do agente (registo da candidatura Entra ID).

Permissões mínimas obrigatórias: ID de agente Função de programador

a365 setup blueprint [options]

blueprint Opções

Opção Description
-c, --config <config> Caminho do ficheiro de configuração. A predefinição é a365.config.json.
-v, --verbose Mostrar resultados detalhados.
--dry-run Mostra o que seria feito sem executar.
--no-endpoint Não registe o endpoint de mensagens (apenas blueprint).
--endpoint-only Registar apenas o endpoint de mensagens. Requer um plano já existente.
-?, -h, --help Mostra informação de ajuda e utilização.

setup permissions

Configure concessões de permissões e permissões hereditárias do OAuth2.

Permissões mínimas obrigatórias: Administrador Global

a365 setup permissions [command] [options]

Opções

Opção Description
-?, -h, --help Mostra informação de ajuda e utilização.

Subcommands

Subcomando Description
mcp Configure concessões OAuth2 do servidor MCP e permissões herdáveis.
bot Configurar concessões e permissões herdantes da API do bot de mensagens.
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.
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 mcp

Configure concessões OAuth2 do servidor MCP e permissões herdáveis.

Permissões mínimas obrigatórias: Administrador Global

a365 setup permissions mcp [options]

Este comando:

  • Lê ToolingManifest.json a partir do deploymentProjectPath especificado em a365.config.json.
  • Concede concessões de permissões delegadas ao OAuth2 para cada âmbito de servidor MCP ao blueprint do agente.
  • Configura permissões herdadas para que as instâncias do agente possam aceder às ferramentas MCP.
  • É idempotente e seguro para usar várias vezes.

Importante

  • Antes de executar este comando, execute a365 config display para verificar se deploymentProjectPath aponta para a pasta do projeto que contém o .ToolingManifest.json Se o programador adicionar servidores MCP numa máquina diferente, partilhe primeiro a atualização ToolingManifest.json com o Administrador Global. Correr sem o correto ToolingManifest.json não adiciona as novas permissões do servidor MCP ao blueprint.
  • Execute este comando depois de o programador executar a365 develop add-mcp-servers. Adicionar servidores MCP ao manifesto e conceder permissões ao blueprint são dois passos separados. Após a conclusão deste comando, as permissões do servidor MCP são visíveis no blueprint do agente.

permissions mcp Opções

Opção Description
-c, --config <config> Caminho do ficheiro de configuração. A predefinição é a365.config.json.
-v, --verbose Mostrar resultados detalhados.
--dry-run Mostra o que seria feito sem executar.
-?, -h, --help Mostra informação de ajuda e utilização.

setup permissions bot

Configurar concessões e permissões herdantes da API do bot de mensagens.

Permissões mínimas obrigatórias: Administrador Global

Pré-requisitos: Blueprint e permissões MCP (executar a365 setup permissions mcp primeiro)

Próximo passo: Implemente o seu agente (execute a365 deploy se estiver hospedado no Azure)

a365 setup permissions bot [options]

permissions bot Opções

Opção Description
-c, --config <config> Caminho do ficheiro de configuração. A predefinição é a365.config.json.
-v, --verbose Mostrar resultados detalhados.
--dry-run Mostra o que seria feito sem executar.
-?, -h, --help Mostra informação de ajuda e utilização.

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. Ao usar este comando, concede ao seu agente acesso a escopos adicionais do Microsoft Graph, como Presença, Ficheiros e Chat, ou a APIs personalizadas registadas no tenant Entra ID da sua organização.

Permissões mínimas obrigatórias: Administrador Global

Pré-requisitos: Corre a365 setup blueprint primeiro. Adicione permissões personalizadas antes a365.config.jsona365 config permissions de executar este comando.

a365 setup permissions custom [options]

Este comando:

  • Configura concessões de permissões delegadas OAuth2 com consentimento do administrador para cada recurso configurado.
  • Define permissões herdáveis para que os utilizadores agentes possam herdar o acesso do blueprint.
  • Reconcilia o Microsoft Entra com a configuração atual adicionando novas permissões e removendo quaisquer permissões que tenham sido eliminadas da configuração.
  • É idempotente e seguro para usar várias vezes.

permissions custom Opções

Opção Description
-c, --config <config> Caminho do ficheiro de configuração. A predefinição é a365.config.json.
-v, --verbose Mostrar resultados detalhados.
--dry-run Mostra o que seria feito sem executar.
-?, -h, --help Mostra informação de ajuda e utilização.

Configurar permissões personalizadas

Use a365 config permissions para adicionar permissões personalizadas à sua configuração antes de executar este comando:

# Add Microsoft Graph extended permissions
a365 config permissions `
  --resource-app-id 00000003-0000-0000-c000-000000000000 `
  --scopes Presence.ReadWrite,Files.Read.All,Chat.Read

# Add custom API permissions
a365 config permissions `
  --resource-app-id <your-api-app-id> `
  --scopes CustomScope.Read,CustomScope.Write

# Apply all configured custom permissions
a365 setup permissions custom

O nome do recurso é resolvido automaticamente a partir do Azure durante a configuração. Não precisas de especificar isso na configuração.

Remover permissões personalizadas

Para remover permissões personalizadas tanto da configuração como do Microsoft Entra:

# Step 1: Remove from config
a365 config permissions --reset

# Step 2: Reconcile Microsoft Entra with updated config
a365 setup permissions custom

Integração com setup all

Quando a tua configuração inclui permissões personalizadas, a execução a365 setup all configura-as automaticamente. A ordem completa de configuração é:

  1. Infraestrutura
  2. Modelo
  3. Permissões MCP
  4. Permissões da API dos bots
  5. Permissões de blueprint personalizadas (se configuradas)
  6. Endpoint 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.

Permissões mínimas obrigatórias: Administrador Global

Pré-requisitos: Corre a365 setup blueprint primeiro.

a365 setup permissions copilotstudio [options]

Este comando:

  • Garante que o principal do serviço API da Power Platform existe no seu tenant.
  • Cria uma concessão de permissões OAuth2 a partir do blueprint para a API do Power Platform com o CopilotStudio.Copilots.Invoke escopo.
  • Define permissões herdáveis para que as instâncias dos agentes possam invocar copilotos do Copilot Studio.

permissions copilotstudio Opções

Opção Description
-c, --config <config> Caminho do ficheiro de configuração. A predefinição é a365.config.json.
-v, --verbose Mostrar resultados detalhados.
--dry-run Mostra o que seria feito sem executar.
-?, -h, --help Mostra informação de ajuda e utilização.

Use este comando quando o seu agente precisar de invocar copilots do Copilot Studio em tempo de execução ou chamar APIs do Power Platform que exijam permissões do CopilotStudio.

setup all

Execute todos os passos de configuração para configurar o seu ambiente Agent 365

a365 setup all [options]

Executa toda a configuração do Agent 365, todos os passos em sequência.

Inclui: Infraestrutura, Blueprint, Permissões e Endpoint.

Permissões mínimas exigidas (o Global Administrator tem todas estas permissões):

  • Azure Subscription Contributor (para infraestrutura e endpoint)
  • Função de Desenvolvedor de ID de Agente (para criação de blueprint)
  • Administrador Global (para concessões de permissões e consentimento do administrador)

setup all Opções

Opção Description
-c, --config <config> Caminho do ficheiro de configuração. A predefinição é a365.config.json.
-v, --verbose Mostrar resultados detalhados.
--dry-run Mostra o que seria feito sem executar.
--skip-infrastructure Ignora a criação de infraestrutura no Azure (usa se a infraestrutura já existir). Esta opção continua a criar: Blueprint, Permissions e Endpoint.
--skip-requirements Ignorar a verificação de validação dos requisitos. Use com cautela: a configuração pode falhar se os pré-requisitos não forem cumpridos.
-?, -h, --help Mostra informação de ajuda e utilização.
  • Last updated on