Del via

Agent 365 CLI-kommandoreference setup

Vigtig

Du skal være en del af prøveversionsprogrammet Frontier for at få tidlig adgang til Microsoft Agent 365. Frontier forbinder dig direkte med Microsofts seneste AI-innovationer. Fronteksempler er underlagt de eksisterende prøveversionsbetingelser i dine kundeaftaler. Da disse funktioner stadig er under udvikling, kan deres tilgængelighed og egenskaber ændre sig over tid.

Konfigurer dit Agent 365-miljø med detaljeret kontrol over hvert trin. Denne kommando administrerer den indledende konfigurationsarbejdsproces for Agent 365-kursusplaner.

Der kræves rollenMinimum: Azure Contributor + Global Administrator

Syntax

a365 setup [command] [options]

Indstillinger

Valgmulighed Beskrivelse
-?, , , -h--help Viser hjælp og anvendelsesoplysninger. 
# 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

Eller kør alle trin på én gang:

# Full setup (includes infrastructure)
a365 setup all

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

setup requirements

Valider forudsætninger for konfiguration af Agent 365. Kører modulopbyggede kravtjek og giver vejledning til eventuelle problemer, den finder.

a365 setup requirements [options]

Denne kommando kører følgende trin:

  • Kontrollerer alle nødvendige forudsætninger for konfigurationen af Agent 365.
  • Rapporterer eventuelle problemer med detaljeret løsningsvejledning.
  • Fortsætter med at kontrollere alle krav, selvom nogle kontroller mislykkes.
  • Indeholder en oversigt over alle kontroller i slutningen.

requirements indstillinger

Valgmulighed Beskrivelse
-c, --config <config> Sti til konfigurationsfil. Standarden er a365.config.json.
-v, --verbose Viser detaljeret output for alle kontroller.
--category <category> Kører kun kontrol af en bestemt kategori, f.eks. Azure, Authentication eller Configuration.
-?, , , -h--help Viser hjælp og anvendelsesoplysninger.

setup infrastructure

Opret Azure infrastruktur.

Minimum påkrævede tilladelser: Azure bidragyder til abonnement eller ejer

a365 setup infrastructure [options]

infrastructure indstillinger

Valgmulighed Beskrivelse
-c, --config <config> Sti til konfigurationsfil. Standarden er a365.config.json.
-v, --verbose Vis detaljeret output.
--dry-run Vis, hvad der ville blive gjort uden at udføre.
-?, , , -h--help Viser hjælp og anvendelsesoplysninger.

setup blueprint

Opret agent blueprint (Registrering af ettra-id-program).

Minimumkrav til tilladelser: Udviklerrollen Agent-id

a365 setup blueprint [options]

blueprint indstillinger

Valgmulighed Beskrivelse
-c, --config <config> Sti til konfigurationsfil. Standarden er a365.config.json.
-v, --verbose Vis detaljeret output.
--dry-run Vis, hvad der ville blive gjort uden at udføre.
--no-endpoint Registrer ikke meddelelsesslutpunkt (kun blueprint).
--endpoint-only Registrer kun meddelelsesslutpunkt. Kræver eksisterende kursusplan.
-?, , , -h--help Viser hjælp og anvendelsesoplysninger.

setup permissions

Konfigurer OAuth2-tilladelser og tilladelser, der kan nedarves.

Minimumkrav til tilladelser: Global administrator

a365 setup permissions [command] [options]

Indstillinger

Valgmulighed Beskrivelse
-?, , , -h--help Viser hjælp og anvendelsesoplysninger.

Underkommandoer

Underkommandoen Beskrivelse
mcp Konfigurer MCP-serveren OAuth2-tilladelser og tilladelser, der kan nedarves.
bot Konfigurer Messaging Bot API OAuth2-tilladelser og tilladelser, der kan nedarves.
custom Anvender brugerdefinerede API-tilladelser på din agent-kursusplan, der går ud over de standardtilladelser, der kræves til agenthandlingen.
copilotstudio Konfigurerer OAuth2-tilladelsestilladelser og tilladelser, der kan nedarves, for agentens kursusplan for at aktivere Copilot Studio-copiloter via Power Platform-API'en.

setup permissions mcp

Konfigurer MCP-serveren OAuth2-tilladelser og tilladelser, der kan nedarves.

Minimumkrav til tilladelser: Global administrator

a365 setup permissions mcp [options]

Denne kommando:

  • Læser ToolingManifest.json fra den , der deploymentProjectPath er angivet i a365.config.json.
  • Tildeler OAuth2 delegerede tilladelsestilskud for hvert MCP-serverområde til agentens kursusplan.
  • Konfigurerer tilladelser, der kan nedarves, så agentforekomster kan få adgang til MCP-værktøjer.
  • Er idempotent og sikker at køre flere gange.

Vigtig

  • Før du kører denne kommando, skal du køre a365 config display for at kontrollere, at deploymentProjectPath peger på den projektmappe, der indeholder den opdaterede ToolingManifest.json. Hvis udvikleren tilføjer MCP-servere på en anden computer, skal du først dele den opdaterede ToolingManifest.json med den globale administrator. Hvis du kører uden det korrekte ToolingManifest.json , føjes de nye MCP-servertilladelser ikke til kursusplanen.
  • Kør denne kommando, når udvikleren har kørt a365 develop add-mcp-servers. Tilføjelse af MCP-servere til manifestet og tildeling af tilladelser til kursusplanen er to separate trin. Når denne kommando er fuldført, er MCP-servertilladelserne synlige i agentens kursusplan.

permissions mcp indstillinger

Valgmulighed Beskrivelse
-c, --config <config> Sti til konfigurationsfil. Standarden er a365.config.json.
-v, --verbose Vis detaljeret output.
--dry-run Vis, hvad der ville blive gjort uden at udføre.
-?, , , -h--help Viser hjælp og anvendelsesoplysninger.

setup permissions bot

Konfigurer Messaging Bot API OAuth2-tilladelser og tilladelser, der kan nedarves.

Minimumkrav til tilladelser: Global administrator

Forudsætninger: Tilladelserne Blueprint og MCP (kør a365 setup permissions mcp først)

Næste trin: Installér din agent (kør a365 deploy, hvis du er vært på Azure)

a365 setup permissions bot [options]

permissions bot indstillinger

Valgmulighed Beskrivelse
-c, --config <config> Sti til konfigurationsfil. Standarden er a365.config.json.
-v, --verbose Vis detaljeret output.
--dry-run Vis, hvad der ville blive gjort uden at udføre.
-?, , , -h--help Viser hjælp og anvendelsesoplysninger.

setup permissions custom

Anvender brugerdefinerede API-tilladelser på din agent-kursusplan, der går ud over de standardtilladelser, der kræves til agenthandlingen. Ved hjælp af denne kommando giver du din agent adgang til yderligere Microsoft Graph områder, f.eks. Tilstedeværelse, Filer og Chat, eller til brugerdefinerede API'er, der er registreret i din organisations Entra ID-lejer.

Minimumkrav til tilladelser: Global administrator

Forudsætninger: Kør a365 setup blueprint først. Føj brugerdefinerede tilladelser til a365.config.json ved hjælp a365 config permissions af , før du kører denne kommando.

a365 setup permissions custom [options]

Denne kommando:

  • Konfigurerer OAuth2-delegerede tilladelser med administratorsamtykke for hver konfigureret ressource.
  • Angiver tilladelser, der kan nedarves, så agentbrugere kan nedarve adgang fra kursusplanen.
  • Afstemmer Microsoft Entra med den aktuelle konfiguration ved at tilføje nye tilladelser og fjerne de tilladelser, der er blevet slettet fra konfigurationen.
  • Er idempotent og sikker at køre flere gange.

permissions custom indstillinger

Valgmulighed Beskrivelse
-c, --config <config> Sti til konfigurationsfil. Standarden er a365.config.json.
-v, --verbose Vis detaljeret output.
--dry-run Vis, hvad der ville blive gjort uden at udføre.
-?, , , -h--help Viser hjælp og anvendelsesoplysninger.

Konfigurer brugerdefinerede tilladelser

Bruges a365 config permissions til at føje brugerdefinerede tilladelser til din konfiguration, før du kører denne kommando:

# 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

Ressourcenavnet fortolkes automatisk fra Azure under installationen. Du behøver ikke at angive den i konfigurationen.

Fjern brugerdefinerede tilladelser

Sådan fjerner du brugerdefinerede tilladelser fra både konfigurationen og Microsoft Entra:

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

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

Integration med setup all

Når din konfiguration indeholder brugerdefinerede tilladelser, konfigurerer kørsel a365 setup all automatisk dem. Den fulde konfigurationsrækkefølge er:

  1. Infrastruktur
  2. Køreplan
  3. MCP-tilladelser
  4. Bot API-tilladelser
  5. Tilladelser til brugerdefineret kursusplan (hvis de er konfigureret)
  6. Meddelelsesslutpunkt

setup permissions copilotstudio

Konfigurerer OAuth2-tilladelsestilladelser og tilladelser, der kan nedarves, for agentens kursusplan for at aktivere Copilot Studio-copiloter via Power Platform-API'en.

Minimumkrav til tilladelser: Global administrator

Forudsætninger: Kør a365 setup blueprint først.

a365 setup permissions copilotstudio [options]

Denne kommando:

  • Sikrer, at Power Platform API-tjenesteprincipalen findes i din lejer.
  • Opretter et OAuth2-tilladelsestilskud fra kursusplanen til Power Platform-API'en med CopilotStudio.Copilots.Invoke området.
  • Angiver tilladelser, der kan nedarves, så agentforekomster kan aktivere Copilot Studio-copiloter.

permissions copilotstudio indstillinger

Valgmulighed Beskrivelse
-c, --config <config> Sti til konfigurationsfil. Standarden er a365.config.json.
-v, --verbose Vis detaljeret output.
--dry-run Vis, hvad der ville blive gjort uden at udføre.
-?, , , -h--help Viser hjælp og anvendelsesoplysninger.

Brug denne kommando, når din agent skal aktivere Copilot Studio-copiloter på kørselstidspunktet eller kalde Power Platform-API'er, der kræver CopilotStudio-tilladelser.

setup all

Udfør alle konfigurationstrin for at konfigurere dit Agent 365-miljø

a365 setup all [options]

Kører hele konfigurationen af Agent 365– alle trin i rækkefølge.

Omfatter: Infrastruktur, Kursusplan, Tilladelser og Slutpunkt.

Minimumkrav til tilladelser (global administrator har alle disse tilladelser):

  • Azure abonnementsyder (for infrastruktur og slutpunkt)
  • Udviklerrolle som agent-id (til oprettelse af kursusplan)
  • Global administrator (for tilladelsestilladelser og administratorsamtykke)

setup all indstillinger

Valgmulighed Beskrivelse
-c, --config <config> Sti til konfigurationsfil. Standarden er a365.config.json.
-v, --verbose Vis detaljeret output.
--dry-run Vis, hvad der ville blive gjort uden at udføre.
--skip-infrastructure Spring Azure infrastrukturoprettelse over (bruges, hvis infrastrukturen allerede findes). Denne indstilling opretter stadig: Blueprint, Tilladelser og Slutpunkt.
--skip-requirements Spring kontrol af kravvalidering over. Vær forsigtig: Installationen kan mislykkes, hvis forudsætningerne ikke er opfyldt.
-?, , , -h--help Viser hjælp og anvendelsesoplysninger.
  • Last updated on