Agent 365 CLI-kommandoreference setup

Vigtig

Du skal være en del af prøveversionsprogrammet Frontier for at få early adgang til Microsoft Agent 365. Frontier forbinder dig direkte med Microsoft 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.

Minimum-rolle kræves: Azure Contributor + Agent ID Developer

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.
# 0. Check prerequisites (optional)
a365 setup requirements

# 1. Create blueprint
a365 setup blueprint

# 2. Configure MCP permissions
a365 setup permissions mcp

# 3. Configure bot permissions
a365 setup permissions bot

# 4. Configure CopilotStudio permissions (if needed)
a365 setup permissions copilotstudio

# 5. Configure custom permissions (if needed)
a365 setup permissions custom

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

# Full setup using config file (a365.config.json)
a365 setup all

# Config-free: no a365.config.json needed
a365 setup all --agent-name "MyAgent"

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 blueprint

Opret agent blueprint (Entra ID programregistrering).

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.
--remove-legacy-scopes Fjerner ældre delte områder (McpServers.*.All format) fra kursusplanen efter overførsel til tilladelser pr. server (Tools.ListInvoke.All).
-?, , , -h--help Vis oplysninger om hjælp og brug.

Overfør til MCP-tilladelser pr. server

Bruges --remove-legacy-scopes ved overførsel fra den ældre model for delte tilladelser til tilladelser pr. server:

  • Ældre delt model: Et id for en enkelt ressourceapp (ea9ffc3e-8a23-4a7d-836d-234d7c7565c1) med delte områder, f.eks McpServers.Mail.All . og McpServers.Teams.All.
  • Model pr. server: Hver MCP-server har sit eget app-id med området Tools.ListInvoke.All.

I følgende eksempel kan du se, hvordan tilladelser pr. server vises i Microsoft Entra-administrationscenter, når kursusplanen er anvendt. Hver MCP-server, f.eks. Work IQ Calendar MCP og Work IQ Mail MCP, har sit eget delegerede Tools.ListInvoke.All omfang. Et delt McpServersMetadata.Read.All område giver adgang til MCP-servermetadata.

Screenshot af Microsoft Entra-administrationscenter, der viser API-tilladelser pr. server. Work IQ Calendar MCP og Work IQ Mail MCP har hver især et delegeret tools.ListInvoke.All-område. Work IQ Tools har en delegeret McpServersMetadata.Read.All scope.

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)

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 organisationens 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:

  1. Køreplan
  2. 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 medpiloter.

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 medpiloter 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: 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
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:

  1. Fuldfører alle de trin, den kan udføre (oprettelse af kursusplaner og tilladelser, der kan nedarves).
  2. Genererer URL-adresser til administratorsamtykke pr. ressource og gemmer dem i a365.generated.config.json.
  3. 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:

  • Udviklerrolle som agent-id (til oprettelse af kursusplan)
  • Global administrator (til OAuth2-tilladelsestilskud – brug setup admin aflevering, hvis den ikke er tilgængelig)

setup all indstillinger

Valgmulighed Beskrivelse
-c, --config <config> Sti til konfigurationsfil. Standarden er a365.config.json. Ignoreres, når --agent-name er angivet.
-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. Vær forsigtig: Installationen kan mislykkes, hvis forudsætningerne ikke er opfyldt.
--aiteammate <true\|false> Angiv som til true at køre konfigurationsflowet for AI-teammedlemmer. Standard er false (agent). Tilsidesætter feltet aiTeammate i a365.config.json.
--agent-instance-only Kun agent. Spring kursusplan og tilladelser over, og registrer kun agentforekomsten. Bruges til at prøve et mislykket registreringstrin igen.
-n, --agent-name <name> Agentens basisnavn (f.eks. "MyAgent"). Når den er angivet, kræves der ingen konfigurationsfil. Afleder visningsnavne som "<name> Agent" og "<name> Blueprint". TenantId registreres automatisk fra az account show (tilsidesæt med --tenant-id). ClientAppId løses ved at slå op Agent 365 CLI i din lejer.
--tenant-id <tenantId> Azure AD-lejer-id. Tilsidesætter automatisk registrering fra az account show. Bruges sammen med --agent-name , når du kører i et ikke-interaktivt miljø eller til at målrette en bestemt lejer.
-?, , , -h--help Vis oplysninger om hjælp og brug.

Agentkonfiguration

Kører som standard a365 setup all agentflowet. Dette flow opretter en agent uden afhængighed af dataverse eller AI-teammedlemmer. Det fungerer for agenter, der kommunikerer direkte med Agent 365-platformen uden at kræve en AI-teamkammeratlicens.

# Default: uses a365.config.json
a365 setup all

# Or explicitly (same result)
a365 setup all --aiteammate false

Hvis du vil køre AI-teammedlemflowet i stedet, skal du overføre --aiteammate true.

Dette flow udfører følgende trin i rækkefølge:

  1. Kræk validering – kontrollerer Azure roller og forudsætninger.
  2. Blueprint creation – opretter eller genbruger programmet Entra ID Agent Blueprint.
  3. Batch-tilladelser – konfigurerer delegerede tilladelsestildelinger i kursusplanen for Microsoft Graph, Agent 365 Tools, Messaging Bot API, Observability API, Power Platform og eventuelle brugerdefinerede ressourcer.
  4. Agent Identity creation – opretter en agentidentitet i Entra ID via agentens identitets-Graph API.
  5. Agentregistrering – registrerer agenten via AgentX V2 Agent Registration API.
  6. Konfigurationssynkronisering – skriver indstillingerne for kørselsforbindelsen og konfigurationen af observabilitet til dine projektfiler (appsettings.json, .env).

Bemærkning

Agentkonfigurationen kræver yderligere seks beta-API-tilladelser til din brugerdefinerede klientapp: AgentIdentityBlueprint.AddRemoveCreds.All, AgentIdentityBlueprint.DeleteRestore.All, AgentInstance.ReadWrite.All, AgentIdentity.ReadWrite.All, AgentIdentity.Create.Allog AgentIdentity.DeleteRestore.All. Se Registrering af brugerdefineret klientapp for at få en komplet liste.

Konfiguration uden konfiguration med --agent-name

Hvis du ikke har en a365.config.json fil, kan du bruge --agent-name til at køre installationsprogrammet uden en. Kommandolinjegrænsefladen registrerer automatisk din lejer og løser klientappen ved at slå den velkendte Agent 365 CLI appregistrering op i din lejer.

# Preview what would happen (no changes made)
a365 setup all --agent-name "MyAgent" --dry-run

# Run the full setup
a365 setup all --agent-name "MyAgent"

Når du bruger --agent-name:

  • TenantId registreres automatisk fra az account show. Send --tenant-id til tilsidesættelse.
  • ClientAppId løses ved at søge efter en Entra-app, der er navngivet Agent 365 CLI i din lejer. Hvis den ikke findes, afsluttes kommandolinjegrænsefladen med en fejl. Se Registrering af brugerdefineret klientapp for at få oplysninger om, hvordan du registrerer denne app.
  • Visningsnavne afledes som "<name> Agent" (identitet) og "<name> Blueprint" (blueprint).
  • Infrastruktur springes altid over (ekstern hosting antages).
  • Konfigurationssynkronisering (skrivning appsettings.json) springes over, da der ikke er konfigureret nogen projektsti.

Hvis din klientapp ikke har AllPrincipals administratorsamtykke for de påkrævede tilladelser, registrerer kommandolinjegrænsefladen dette og beder dig om at give samtykke interaktivt:

The following permissions require admin consent:
  AgentIdentity.ReadWrite.All
  AgentIdentity.Create.All
  ...
Grant admin consent for these permissions now? [y/N]:

Angiv y for at give samtykke online. Hvis du ikke er global administrator, skal du afvise og bruge arbejdsprocessen for setup admin aflevering i stedet.

Konfigurationssynkronisering

Når kørslen er fuldført, skriver kommandolinjegrænsefladen automatisk kørselsindstillinger til dine projektfiler:

Indstillinger Skrevet til Beskrivelse
Connections.ServiceConnection appsettings.json / .env Blueprint-klient-id, klienthemmelighed, lejer-id og tokenslutpunkt
Agent365Observability appsettings.json / .env Agent-id (agentidentitet), kursusplans-id, lejer-id, klient-id og klienthemmelighed for telemetrieksport
TokenValidation appsettings.json Indstillinger for tokenvalidering (deaktiveret som standard for ikke-DW)
ConnectionsMap appsettings.json / .env Standardtjeneste-URL-adresse til forbindelsestilknytning

Kommandolinjegrænsefladen opretter filen, hvis den ikke findes, og opdaterer individuelle felter uden at overskrive resten af konfigurationen.

Prøv en mislykket registrering igen

Hvis konfigurationen fuldfører kursusplanen og tilladelserne, men mislykkes under agentregistrering, skal du bruge --agent-instance-only til kun at prøve dette trin igen uden at gentage tidligere arbejde:

a365 setup all --agent-instance-only

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