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.

Minimumrolle kræves: Udvikler af Azure Contributor + Agent-id

Bemærkning

Den rolle, du har, bestemmer, hvor meget af konfigurationen der fuldføres i en enkelt kørsel. Global administrator kan fuldføre alle trin på én gang. Agent-id-administrator og agent-id Udvikler kan udføre alle trin undtagen OAuth2-tilladelsestilladelser (administratorsamtykke), som kræver et separat trin af en global administrator. Hvis du vil vide mere om arbejdsprocessen for aflevering, skal du se setup admin.

Syntax

a365 setup [command] [options]

Indstillinger

Valgmulighed	Beskrivelse
`-?`, , , `-h--help`	Vis oplysninger om hjælp og brug.

Anbefalet udførelsesrækkefølge

# 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

Hvis du kører som agent-id-administrator eller agent-id-udvikler (ikke global administrator), a365 setup all fuldføres alle trin undtagen OAuth2-tilladelsestilladelser. Når den er afsluttet, skal en global administrator fuldføre stipendierne:

# Non-admin path: run setup, then hand off to Global Administrator
a365 setup all

# Global Administrator completes OAuth2 grants
a365 setup admin --config-dir "<path-to-config-folder>"

`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`	Vis oplysninger om hjælp og brug.

`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 kommandoen ville gøre uden at udføre den.
`-?`, , , `-h--help`	Vis oplysninger om hjælp og brug.

`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 kommandoen ville gøre uden at udføre den.
`--no-endpoint`	Registrer ikke meddelelsesslutpunkt (kun blueprint).
`--endpoint-only`	Registrer kun meddelelsesslutpunkt. Kræver eksisterende kursusplan.
`-?`, , , `-h--help`	Vis oplysninger om hjælp og brug.

`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`	Vis oplysninger om hjælp og brug.

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 kommandoen ville gøre uden at udføre den.
`-?`, , , `-h--help`	Vis oplysninger om hjælp og brug.

`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 kommandoen ville gøre uden at udføre den.
`-?`, , , `-h--help`	Vis oplysninger om hjælp og brug.

`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 Microsoft 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, du har 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 kommandoen ville gøre uden at udføre den.
`-?`, , , `-h--help`	Vis oplysninger om hjælp og brug.

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

Under konfigurationen fortolkes ressourcenavnet automatisk fra Azure. 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 som en del af en enkelt batchtilladelsesfase. Den fulde konfigurationsrækkefølge er:

Infrastruktur
Køreplan
Tilladelser batch (MCP, Bot API, Brugerdefineret blueprint tilladelser – alle konfigureret sammen)

`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 kommandoen ville gøre uden at udføre den.
`-?`, , , `-h--help`	Vis oplysninger om hjælp og brug.

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 og Tilladelser.

De trin, der fuldføres, afhænger af din rolle:

Trin	Global Administrator	Agent-id-administrator	Agent-ID-udvikler
Kontrol af forudsætninger	Ja	Ja	Ja
Azure-infrastruktur	Ja	Ja	Ja
Oprettelse af agentplan	Ja	Ja	Ja
Tilladelser, der kan nedarves	Ja	Ja	Ja
OAuth2-tilladelsestilskud (administratorsamtykke)	Ja	Kræver trin for generel vejledning	Kræver trin for generel vejledning

Når du kører a365 setup all uden global administrator, kan kommandolinjegrænsefladen:

Fuldfører alle de trin, den kan udføre (infrastruktur, oprettelse af kursusplaner og tilladelser, der kan nedarves).
Genererer URL-adresser til administratorsamtykke pr. ressource og gemmer dem i a365.generated.config.json.
Viser de næste trin, der viser, hvordan en global administrator kan fuldføre OAuth2-tilskud ved hjælp af enten a365 setup admin eller de genererede URL-adresser for samtykke.

Tips

Hvis du er global administrator, a365 setup all fuldføres alt i en enkelt kørsel uden brug af aflevering.

Minimumkrav til tilladelser:

Bidragyder til Azure-abonnement eller ejer (til infrastruktur)
Udviklerrolle som agent-id (til oprettelse af kursusplan)
Global administrator (til OAuth2-tilladelsestilskud – hvis den ikke er tilgængelig, skal du bruge setup admin aflevering)

`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 kommandoen ville gøre uden at udføre den.
`--skip-infrastructure`	Spring Azure infrastrukturoprettelse over (bruges, hvis infrastrukturen allerede findes). Denne indstilling opretter stadig: Blueprint og Tilladelser.
`--skip-requirements`	Spring kontrol af kravvalidering over. Vær forsigtig: Installationen kan mislykkes, hvis forudsætningerne ikke er opfyldt.
`-?`, , , `-h--help`	Vis oplysninger om hjælp og brug.

`setup admin`

Fuldfører tilladelsen OAuth2 (administratorsamtykke), der kræver global administrator. Kør denne kommando, når en agent-id-administrator eller agent-id udvikler kører a365 setup all.

Minimumkrav til tilladelser: Global administrator

a365 setup admin [options]

Hvornår skal du bruge `setup admin`

Brug denne kommando, når:

Når en agent-id-administrator eller agent-id-udvikler kører a365 setup all.
Konfigurationsoversigten viser, at OAuth2-tilskud afventer, og giver den globale administrator besked om at køre denne kommando.
Du vil køre samtykke igen, når du har ændret tilladelserne i konfigurationen.

Typisk arbejdsproces for aflevering

# Step 1: Agent ID Admin or Developer runs setup
a365 setup all

# The CLI displays next steps, for example:
# "ACTION REQUIRED — Global Administrator must complete OAuth2 grants"
# "Option 1: a365 setup admin --config-dir '<path-to-config-folder>'"
# "Option 2: Share the consent URL displayed above with your Global Administrator"

# Step 2: Agent ID Admin shares config folder with Global Administrator
# (contains a365.config.json and a365.generated.config.json)

# Step 3: Global Administrator completes the grants
a365 setup admin --config-dir "<path-to-config-folder>"

Denne kommando:

Indlæser agentkonfigurationen fra den angivne mappe eller den aktuelle mappe som standard.
Læser agentens blueprint-id og konfigurerede ressourcetilladelser fra den genererede konfiguration.
Opretter AllPrincipals OAuth2-tilladelsestilskud for alle konfigurerede ressourcer, herunder:
- Microsoft Graph (delegerede områder)
- Agent 365 Tools (MCP-serverområder)
- Messaging Bot-API
- Observability API
- Power Platform-API
- Alle brugerdefinerede tilladelser, der er defineret i din konfiguration
Viser en bekræftelsesprompt, før du foretager ændringer. Bruges --yes til at tilsidesætte prompten.

Advarsel!

OAuth2-tildelinger, der oprettes af denne kommando, er lejerbaserede (consentType=AllPrincipals). Denne konfiguration betyder, at alle brugere i lejeren kan bruge agentens delegerede tilladelser. Gennemse de angivne områder omhyggeligt, før du bekræfter.

`setup admin` indstillinger

Valgmulighed	Beskrivelse
`-d`, `--config-dir <dir>`	Mappe, der indeholder `a365.config.json` og `a365.generated.config.json`. Som standard den aktuelle mappe.
`-v`, `--verbose`	Vis detaljeret output.
`--dry-run`	Vis, hvad kommandoen ville gøre uden at udføre den.
`--skip-requirements`	Spring kontrol af kravvalidering over. Brug med forsigtighed.
`-y`, `--yes`	Spring bekræftelsesprompten over, og fortsæt automatisk.
`-?`, , , `-h--help`	Vis oplysninger om hjælp og brug.

I stedet for at køre a365 setup adminkan den globale administrator åbne den kombinerede URL-adresse til samtykke, der a365 setup all gemmes i a365.generated.config.json. Denne URL-adresse dækker alle nødvendige ressourcer i et enkelt browserbesøg.

# Display the generated config to find the consent URL
a365 config display -g
# Look for: combinedAdminConsentUrl

Feedback

Var denne side nyttig?

Last updated on 2026-03-25

Del via

Agent 365 CLI-kommandoreference setup

Syntax

Indstillinger

Anbefalet udførelsesrækkefølge

setup requirements

requirements indstillinger

setup infrastructure

infrastructure indstillinger

setup blueprint

blueprint indstillinger

setup permissions

Indstillinger

Underkommandoer

setup permissions mcp

permissions mcp indstillinger

setup permissions bot

permissions bot indstillinger

setup permissions custom

permissions custom indstillinger

Konfigurer brugerdefinerede tilladelser

Fjern brugerdefinerede tilladelser

Integration med setup all

setup permissions copilotstudio

permissions copilotstudio indstillinger

setup all

setup all indstillinger

setup admin

Hvornår skal du bruge setup admin

Typisk arbejdsproces for aflevering

setup admin indstillinger

Alternativt: URL-adresse til samtykke

Feedback

Yderligere ressourcer

Agent 365 CLI-kommandoreference `setup`

`setup requirements`

`requirements` indstillinger

`setup infrastructure`

`infrastructure` indstillinger

`setup blueprint`

`blueprint` indstillinger

`setup permissions`

`setup permissions mcp`

`permissions mcp` indstillinger

`setup permissions bot`

`permissions bot` indstillinger

`setup permissions custom`

`permissions custom` indstillinger

Integration med `setup all`

`setup permissions copilotstudio`

`permissions copilotstudio` indstillinger

`setup all`

`setup all` indstillinger

`setup admin`

Hvornår skal du bruge `setup admin`

`setup admin` indstillinger