Referência de comando da CLI setup do Agent 365

Configure seu ambiente do Agente 365 com controle granular sobre cada etapa. Esse comando gerencia o fluxo de trabalho de instalação inicial para blueprints do Agente 365.

função Minimum necessária: Azure Colaborador + Administradorglobal

Sintaxe

a365 setup [command] [options]

Opções

Ordem de execução recomendada

# 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 execute todas as etapas ao mesmo tempo:

# 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 instalação do Agente 365. Executa verificações de requisitos modulares e fornece diretrizes para todos os problemas encontrados.

a365 setup requirements [options]

Este comando executa as seguintes etapas:

• Verifica todos os pré-requisitos necessários para a instalação do Agente 365.
• Relata quaisquer problemas com diretrizes de resolução detalhadas.
• Continua verificando todos os requisitos mesmo se algumas verificações falharem.
• Fornece um resumo de todas as verificações no final.

requirements opções

setup infrastructure

Crie Azure infraestrutura.

permissões necessárias Minimum: Azure Colaborador ou Proprietário da Assinatura

a365 setup infrastructure [options]

infrastructure opções

setup blueprint

Criar blueprint do agente (registro de aplicativo do Entra ID).

Permissões mínimas necessárias: função desenvolvedor de ID do agente

a365 setup blueprint [options]

blueprint opções

setup permissions

Configure concessões de permissão OAuth2 e permissões herdáveis.

Permissões mínimas necessárias: Administrador Global

a365 setup permissions [command] [options]

Opções

Subcomandos

setup permissions mcp

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

Permissões mínimas necessárias: Administrador Global

a365 setup permissions mcp [options]

Esse comando:

• Leituras ToolingManifest.json do deploymentProjectPath especificado em a365.config.json.
• Concede concessões de permissão delegada OAuth2 para cada escopo de servidor MCP para o blueprint do agente.
• Configura permissões herdáveis para que as instâncias do agente possam acessar as ferramentas do MCP.
• É idempotente e seguro para ser executado várias vezes.

permissions mcp opções

setup permissions bot

Configurar concessões da API do Bot de Mensagens OAuth2 e permissões herdáveis.

Permissões mínimas necessárias: Administrador Global

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

A etapaNext: implante seu agente (execute a365 deploy se estiver hospedando no Azure)

a365 setup permissions bot [options]

permissions bot opções

setup permissions custom

Aplica permissões de API personalizadas ao blueprint do agente que vão além das permissões padrão necessárias para a operação do agente. Usando esse comando, você concede ao agente acesso a escopos de Microsoft Graph adicionais, como Presença, Arquivos e Chat, ou a APIs personalizadas registradas no locatário da ID do Entra da sua organização.

Permissões mínimas necessárias: Administrador Global

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

a365 setup permissions custom [options]

Esse comando:

• Configura as concessões de permissão delegada OAuth2 com consentimento do administrador para cada recurso configurado.
• Define permissões herdáveis para que os usuários do agente possam herdar o acesso do blueprint.
• Reconcilia Microsoft Entra com a configuração atual adicionando novas permissões e removendo as permissões que foram excluídas da configuração.
• É idempotente e seguro para ser executado várias vezes.

permissions custom opções

Configurar permissões personalizadas

Use a365 config permissions para adicionar permissões personalizadas à 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 de Azure durante a instalação. Você não precisa especificá-lo na configuração.

Remover permissões personalizadas

Para remover permissões personalizadas da configuração e 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 configuração inclui permissões personalizadas, a execução a365 setup all as configura automaticamente. A ordem de instalação completa é:

1. Infraestrutura
2. Projeto
3. Permissões mcp
4. Permissões da API do Bot
5. Permissões de blueprint personalizadas (se configuradas)
6. Ponto de extremidade de mensagens

setup permissions copilotstudio

Configura concessões de permissão OAuth2 e permissões herdáveis para que o blueprint do agente invoque Copilot co-pilotos do Studio por meio da API do Power Platform.

Permissões mínimas necessárias: Administrador Global

Pré-requisitos: executar a365 setup blueprint primeiro.

a365 setup permissions copilotstudio [options]

Esse comando:

• Garante que a entidade de serviço da API do Power Platform exista em seu locatário.
• Cria uma concessão de permissão OAuth2 do blueprint para a API do Power Platform com o CopilotStudio.Copilots.Invoke escopo.
• Define permissões herdáveis para que as instâncias do agente possam invocar Copilot co-pilotos do Studio.

permissions copilotstudio opções

Use esse comando quando o agente precisar invocar co-pilotos do Copilot Studio em runtime ou chamar APIs do Power Platform que exigem permissões copilotStudio.

setup all

Executar todas as etapas de instalação para configurar o ambiente do Agente 365

a365 setup all [options]

Executa a configuração completa do Agente 365, todas as etapas em sequência.

Inclui: Infraestrutura, Blueprint, Permissões e Ponto de Extremidade.

Permissões mínimas necessárias (o Administrador Global tem todas essas permissões):

• Azure Colaborador de Assinatura (para infraestrutura e ponto de extremidade)
• Função desenvolvedor de ID do agente (para criação de blueprint)
• Administrador global (para concessões de permissão e consentimento do administrador)

setup all opções