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

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. Podes inicializar novas configurações de forma interativa ou mostrar as definições atuais.

Papel mínimo exigido: Nenhum (configuração local)

Sintaxe

a365 config [command] [options]

Opções

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

config init

Configure interativamente a CLI do Agente 365 ou importe a partir de um ficheiro.

a365 config init [options]

Use este comando para configurar a configuração da sua CLI Agent 365 através de um processo interativo ou importando definições a partir de um ficheiro de configuração existente.

init Opções

Opção	Description
-c, --configfile <configfile>	Caminho para um ficheiro de configuração existente para importar
-g, --global	Criar configuração no diretório global (AppData) em vez do diretório atual
-?, -h, --help	Mostrar ajuda e informação de utilização

Observações

O config init comando lança um assistente interativo que minimiza a entrada manual:

• Azure CLI: Deteta automaticamente a sua subscrição, inquilino, grupos de recursos, planos de serviços de aplicação e regiões.
• Padrões inteligentes: Gera nomes de recursos a partir do nome do seu agente e de um carimbo temporal (por exemplo, myagent-webapp-11140916). Podes personalizar estes nomes antes de guardar.
• Deteção de Plataforma: Deteta o seu tipo de projeto (.NET, Node.js, Python) a partir do caminho de implementação do projeto e avisa se não for encontrado nenhum tipo suportado.
• Validação da aplicação cliente: Valida o ID da aplicação do cliente contra o seu inquilino Entra, verificando que as permissões necessárias estão configuradas e que o consentimento do administrador é concedido. Tens até três tentativas antes do mago sair.

Permissões de blueprint personalizadas (opcionais): O assistente inclui um passo opcional para configurar permissões para recursos externos adicionais, como presença no Teams ou ficheiros de OneDrive. A maioria dos agentes não exige isto. Também pode configurar permissões após a configuração inicial usando a365 config permissionso arquivo .

Atualizar a configuração existente: A reexecução a365 config init carrega o seu atual a365.config.json como predefinido. Pressiona Enter em cada indicação para manter o valor atual, ou escreve um novo valor para o atualizar.

config display

Mostrar a configuração atual do CLI do Agente 365.

a365 config display [options]

Este comando mostra as definições atuais da CLI do Agente 365, para que possa rever a sua configuração atual.

display Opções

Opção	Description
-g, --generated	Configuração gerada por ecrã (a365.generated.config.json)
-a, --all	Exibir tanto a configuração estática como a gerada
-?, -h, --help	Mostrar ajuda e informação de utilização

Estrutura do ficheiro de configuração

A CLI utiliza um ficheiro de configuração JSON (a365.config.json) com as seguintes propriedades chave:

{
  "$schema": "./a365.config.schema.json",
  "tenantId": "your-tenant-id",
  "subscriptionId": "your-subscription-id",
  "resourceGroup": "rg-Agent 365-example",
  "location": "westus",
  "appServicePlanName": "asp-Agent 365-example",
  "appServicePlanSku": "B1",
  "webAppName": "webapp-Agent 365-example",
  "agentBlueprintDisplayName": "My Agent 365 Blueprint",
  "agentIdentityDisplayName": "My Agent 365 Agent",
  "agentUserPrincipalName": "agent@contoso.onmicrosoft.com",
  "agentUserDisplayName": "My Agent 365 User",
  "managerEmail": "manager@contoso.onmicrosoft.com",
  "agentUserUsageLocation": "US",
  "agentIdentityScopes": [
    "User.Read",
    "Mail.Send",
    "Calendars.ReadWrite",
    "Files.ReadWrite"
  ],
  "agentApplicationScopes": [
    "Mail.ReadWrite",
    "Chat.ReadWrite",
    "Sites.Read.All"
  ],
  "deploymentProjectPath": ".",
  "deploymentProjectFile": "YourProject.csproj",
  "botName": "my-Agent 365-bot",
  "botDescription": "My AI-powered agent for Microsoft 365 tasks"
}