Compartilhar via

Referência de comando da CLI config do Agent 365

Importante

Você precisa fazer parte do programa de prévia Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier conecta você diretamente às mais recentes inovações de IA da Microsoft. Prévias da Frontier estão sujeitas aos termos de pré-visualização existentes dos seus contratos com clientes. Como esses recursos ainda estão em desenvolvimento, sua disponibilidade e capacidades podem mudar ao longo do tempo.

Gerenciar a configuração da CLI do Agente 365. Fornece opções para gerenciar as configurações da CLI do Agente 365. Você pode inicializar novas configurações interativamente ou exibir as configurações atuais.

Função mínima necessária: Nenhuma (configuração local)

Sintaxe

a365 config [command] [options]

Opções

Opção Description
-?, , -h--help Mostrar informações de ajuda e uso

config init

Configure interativamente a CLI do Agent 365 ou importe de um arquivo.

a365 config init [options]

Use este comando para configurar a configuração da CLI do Agent 365 por meio de um processo interativo ou importando configurações de um arquivo de configuração existente.

init opções

Opção Description
-c, --configfile <configfile> Caminho para um arquivo 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 informações de ajuda e uso

Observações

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

  • Azure CLI integração: detecta automaticamente sua assinatura, locatário, grupos de recursos, planos de serviço de aplicativo e regiões.
  • Padrões inteligentes: gera nomes de recursos do nome do agente e um carimbo de data/hora (por exemplo, myagent-webapp-11140916). Você pode personalizar esses nomes antes de salvar.
  • Platform detection: detecta o tipo de projeto (.NET, Node.js, Python) no caminho do projeto de implantação e avisa se nenhum tipo com suporte é encontrado.
  • Validação do aplicativo cliente: valida a ID do aplicativo cliente em relação ao locatário do Entra, verificando se as permissões necessárias estão configuradas e o consentimento do administrador é concedido. Você tem até três tentativas antes que o assistente saia.

Permissões de blueprint doCustom (opcional): o assistente inclui uma etapa opcional para configurar permissões para recursos externos adicionais, como a presença do Teams ou arquivos OneDrive. A maioria dos agentes não exige isso. Você também pode configurar permissões após a configuração inicial usando a365 config permissions.

Atualizando a configuração existente: executar novamente a365 config init carrega o atual a365.config.json como padrão. Pressione Enter em cada prompt para manter o valor atual ou digite um novo valor para atualizá-lo.

config display

Mostrar a configuração atual da CLI do Agent 365.

a365 config display [options]

Esse comando exibe as configurações atuais da CLI do Agent 365 para que você possa examinar sua configuração atual.

display opções

Opção Description
-g, --generated Exibir configuração gerada (a365.generated.config.json)
-a, --all Exibir configuração estática e gerada
-?, , -h--help Mostrar informações de ajuda e uso

Estrutura de arquivo de configuração

A CLI usa um arquivo de configuração JSON (a365.config.json) com as seguintes propriedades de 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"
}
  • Last updated on