Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
Agent 365 CLI-kommandoreference
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. |
Anbefalet udførelsesrækkefølge
# 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.jsonfra den , derdeploymentProjectPather angivet ia365.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 displayfor at kontrollere, atdeploymentProjectPathpeger på den projektmappe, der indeholder den opdateredeToolingManifest.json. Hvis udvikleren tilføjer MCP-servere på en anden computer, skal du først dele den opdateredeToolingManifest.jsonmed den globale administrator. Hvis du kører uden det korrekteToolingManifest.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.eksMcpServers.Mail.All. ogMcpServers.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.
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:
- 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.Invokeområ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:
- Fuldfører alle de trin, den kan udføre (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 admineller 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 adminaflevering, 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:
- Kræk validering – kontrollerer Azure roller og forudsætninger.
- Blueprint creation – opretter eller genbruger programmet Entra ID Agent Blueprint.
- Batch-tilladelser – konfigurerer delegerede tilladelsestildelinger i kursusplanen for Microsoft Graph, Agent 365 Tools, Messaging Bot API, Observability API, Power Platform og eventuelle brugerdefinerede ressourcer.
- Agent Identity creation – opretter en agentidentitet i Entra ID via agentens identitets-Graph API.
- Agentregistrering – registrerer agenten via AgentX V2 Agent Registration API.
-
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-idtil tilsidesættelse. -
ClientAppId løses ved at søge efter en Entra-app, der er navngivet
Agent 365 CLIi 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.
Administratorsamtykke under konfiguration
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
AllPrincipalsOAuth2-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
--yestil 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. |
Alternativt: URL-adresse til samtykke
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