Kommandoreferens för Agent 365 CLI `setup`

Viktigt!

Du måste vara en del av förhandsversionen av Frontier för att få early åtkomst till Microsoft Agent 365. Frontier ansluter dig direkt till Microsoft senaste AI-innovationer. Förhandsversioner av Gräns omfattas av de befintliga förhandsversionsvillkoren för dina kundavtal. Eftersom dessa funktioner fortfarande är under utveckling kan deras tillgänglighet och funktioner ändras över tid.

Konfigurera agent 365-miljön med detaljerad kontroll över varje steg. Det här kommandot hanterar det första installationsarbetsflödet för Agent 365-skisser.

Minimum-rollen krävs: Azure Deltagare + Agent ID Developer

Anmärkning

Den roll som du har avgör hur mycket av installationen som slutförs i en enda körning. Global administratör kan utföra alla steg samtidigt. Agent-ID-administratör och agent-ID Utvecklare kan utföra alla steg utom OAuth2-behörighetsbidrag (administratörsmedgivande), vilket kräver ett separat steg av en global administratör. Mer information om arbetsflödet för överlämning finns i setup admin.

Syntax

a365 setup [command] [options]

Options

Option	Description
`-?`, , `-h--help`	Visa hjälp- och användningsinformation.

Rekommenderad körningsordning

# 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 alla steg samtidigt:

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

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

Om du kör som agent-ID-administratör eller agent-ID-utvecklare (inte global administratör) a365 setup all slutför du alla steg utom OAuth2-behörighetsbidrag. När den är klar måste en global administratör slutföra bidragen:

# 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`

Verifiera förutsättningarna för agent 365-konfigurationen. Kör modulära kravkontroller och ger vägledning för eventuella problem som hittas.

a365 setup requirements [options]

Det här kommandot kör följande steg:

Kontrollerar alla krav som krävs för agent 365-konfigurationen.
Rapporterar eventuella problem med detaljerad lösningsvägledning.
Fortsätter att kontrollera alla krav även om vissa kontroller misslyckas.
Innehåller en sammanfattning av alla kontroller i slutet.

`requirements` Alternativ

Option	Description
`-c`, `--config <config>`	Sökväg till konfigurationsfilen. Standardvärdet är `a365.config.json`.
`-v`, `--verbose`	Visar detaljerade utdata för alla kontroller.
`--category <category>`	Kör endast kontroller för en specifik kategori, till exempel `Azure`, `Authentication` eller `Configuration`.
`-?`, , `-h--help`	Visa hjälp- och användningsinformation.

`setup blueprint`

Skapa agentritning (Entra ID programregistrering).

Minsta behörigheter som krävs: Rollen Agent-ID-utvecklare

a365 setup blueprint [options]

`blueprint` Alternativ

Option	Description
`-c`, `--config <config>`	Sökväg till konfigurationsfilen. Standardvärdet är `a365.config.json`.
`-v`, `--verbose`	Visa detaljerade utdata.
`--dry-run`	Visa vad kommandot skulle göra utan att köra det.
`--no-endpoint`	Registrera inte slutpunkten för meddelanden (endast skiss).
`--endpoint-only`	Registrera endast slutpunkten för meddelanden. Kräver en befintlig skiss.
`-?`, , `-h--help`	Visa hjälp- och användningsinformation.

`setup permissions`

Konfigurera OAuth2-behörighetsbidrag och ärvbara behörigheter.

Minsta behörigheter som krävs: Global administratör

a365 setup permissions [command] [options]

Options

Option	Description
`-?`, , `-h--help`	Visa hjälp- och användningsinformation.

Subcommands

Subcommand	Description
`mcp`	Konfigurera MCP-server OAuth2-beviljanden och ärvbara behörigheter.
`bot`	Konfigurera api för meddelanderobot OAuth2-beviljanden och ärvbara behörigheter.
`custom`	Tillämpar anpassade API-behörigheter på din agentritning som går utöver de standardbehörigheter som krävs för agentåtgärd.
`copilotstudio`	Konfigurerar OAuth2-behörighetsbidrag och ärvbara behörigheter för agentritningen för att anropa Copilot Studio andrepiloter via Power Platform-API:et.

`setup permissions mcp`

Konfigurera MCP-server OAuth2-beviljanden och ärvbara behörigheter.

Minsta behörigheter som krävs: Global administratör

a365 setup permissions mcp [options]

Det här kommandot:

Läser ToolingManifest.json från angivet deploymentProjectPath i a365.config.json.
Ger OAuth2 delegerade behörighetsbidrag för varje MCP-serveromfång till agentritningen.
Konfigurerar ärvbara behörigheter så att agentinstanser kan komma åt MCP-verktyg.
Är idempotent och säkert att köra flera gånger.

Viktigt!

Innan du kör det här kommandot kör du a365 config display för att kontrollera att deploymentProjectPath pekar på projektmappen som innehåller den uppdaterade ToolingManifest.json. Om utvecklaren lägger till MCP-servrar på en annan dator delar du först den uppdaterade ToolingManifest.json med den globala administratören. Om du kör utan rätt ToolingManifest.json läggs inte de nya MCP-serverbehörigheterna till i skissen.
Kör det här kommandot när utvecklaren har kört a365 develop add-mcp-servers. Att lägga till MCP-servrar i manifestet och bevilja behörigheter till skissen är två separata steg. När det här kommandot har slutförts visas MCP-serverbehörigheterna i agentritningen.

`permissions mcp` Alternativ

Option	Description
`-c`, `--config <config>`	Sökväg till konfigurationsfilen. Standardvärdet är `a365.config.json`.
`-v`, `--verbose`	Visa detaljerade utdata.
`--dry-run`	Visa vad kommandot skulle göra utan att köra det.
`--remove-legacy-scopes`	Tar bort äldre delade omfång (`McpServers.*.All` format) från skissen efter migrering till behörigheter per server (`Tools.ListInvoke.All`).
`-?`, , `-h--help`	Visa hjälp- och användningsinformation.

Migrera till MCP-behörigheter per server

Använd --remove-legacy-scopes när du migrerar från den äldre modellen med delade behörigheter till behörigheter per server:

Äldre delad modell: Ett enda resursapp-ID (ea9ffc3e-8a23-4a7d-836d-234d7c7565c1) med delade omfång som McpServers.Mail.All och McpServers.Teams.All.
Modell per server: Varje MCP-server har ett eget app-ID med omfånget Tools.ListInvoke.All.

I följande exempel visas hur behörigheter per server visas i Microsoft Entra administrationscenter när skissen har tillämpats. Varje MCP-server, till exempel Work IQ Calendar MCP och Work IQ Mail MCP, har sitt eget delegerade Tools.ListInvoke.All omfång. Ett delat McpServersMetadata.Read.All omfång ger åtkomst till MCP-servermetadata.

`setup permissions bot`

Konfigurera api för meddelanderobot OAuth2-beviljanden och ärvbara behörigheter.

Minsta behörigheter som krävs: Global administratör

Förutsättningar: Skiss- och MCP-behörigheter (kör a365 setup permissions mcp först)

a365 setup permissions bot [options]

`permissions bot` Alternativ

Option	Description
`-c`, `--config <config>`	Sökväg till konfigurationsfilen. Standardvärdet är `a365.config.json`.
`-v`, `--verbose`	Visa detaljerade utdata.
`--dry-run`	Visa vad kommandot skulle göra utan att köra det.
`-?`, , `-h--help`	Visa hjälp- och användningsinformation.

`setup permissions custom`

Tillämpar anpassade API-behörigheter på din agentritning som går utöver de standardbehörigheter som krävs för agentåtgärd. Med det här kommandot ger du din agent åtkomst till ytterligare Microsoft Graph omfång, till exempel Närvaro, Filer och Chatt, eller till anpassade API:er som är registrerade i organisationens Microsoft Entra ID klientorganisation.

Minsta behörigheter som krävs: Global administratör

Förutsättningar: Kör a365 setup blueprint först. Lägg till anpassade behörigheter till a365.config.json med hjälp a365 config permissions av innan du kör det här kommandot.

a365 setup permissions custom [options]

Det här kommandot:

Konfigurerar OAuth2-delegerade behörighetsbidrag med administratörsmedgivande för varje konfigurerad resurs.
Anger ärvbara behörigheter så att agentanvändare kan ärva åtkomst från skissen.
Stäm av Microsoft Entra med den aktuella konfigurationen genom att lägga till nya behörigheter och ta bort eventuella behörigheter som du har tagit bort från konfigurationen.
Är idempotent och säkert att köra flera gånger.

`permissions custom` Alternativ

Option	Description
`-c`, `--config <config>`	Sökväg till konfigurationsfilen. Standardvärdet är `a365.config.json`.
`-v`, `--verbose`	Visa detaljerade utdata.
`--dry-run`	Visa vad kommandot skulle göra utan att köra det.
`-?`, , `-h--help`	Visa hjälp- och användningsinformation.

Konfigurera anpassade behörigheter

Använd a365 config permissions för att lägga till anpassade behörigheter i konfigurationen innan du kör det här kommandot:

# 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 installationen löses resursnamnet automatiskt från Azure. Du behöver inte ange det i konfigurationen.

Ta bort anpassade behörigheter

Så här tar du bort anpassade behörigheter från både konfigurationen och Microsoft Entra:

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

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

Integrering med `setup all`

När konfigurationen innehåller anpassade behörigheter konfigurerar körning a365 setup all automatiskt dem som en del av en enda batchbehörighetsfas. Den fullständiga installationsordningen är:

Ritning
Behörighetsbatch (MCP, Bot API, Anpassade skissbehörigheter – alla konfigurerade tillsammans)

`setup permissions copilotstudio`

Konfigurerar OAuth2-behörighetsbidrag och ärvbara behörigheter för agentritningen för att anropa Copilot Studio andrepiloter via Power Platform-API:et.

Minsta behörigheter som krävs: Global administratör

Förutsättningar: Kör a365 setup blueprint först.

a365 setup permissions copilotstudio [options]

Det här kommandot:

Säkerställer att tjänstens huvudnamn för Power Platform-API:et finns i din klientorganisation.
Skapar ett OAuth2-behörighetsbeviljande från skissen till Power Platform-API:et med omfånget CopilotStudio.Copilots.Invoke .
Anger ärvbara behörigheter så att agentinstanser kan anropa Copilot Studio andrepiloter.

`permissions copilotstudio` Alternativ

Option	Description
`-c`, `--config <config>`	Sökväg till konfigurationsfilen. Standardvärdet är `a365.config.json`.
`-v`, `--verbose`	Visa detaljerade utdata.
`--dry-run`	Visa vad kommandot skulle göra utan att köra det.
`-?`, , `-h--help`	Visa hjälp- och användningsinformation.

Använd det här kommandot när din agent behöver anropa Copilot Studio andrepiloter vid körning eller anropa Power Platform-API:er som kräver CopilotStudio-behörigheter.

`setup all`

Utför alla installationssteg för att konfigurera agent 365-miljön

a365 setup all [options]

Kör den fullständiga agent 365-installationen, alla steg i följd.

Innehåller: Skiss och behörigheter.

Vilka steg som slutförs beror på din roll:

Steg	Global administratör	Agent-ID-administratör	Agent-ID-utvecklare
Kravkontroll	Ja	Ja	Ja
Skapande av agentritning	Ja	Ja	Ja
Ärvbara behörigheter	Ja	Ja	Ja
OAuth2-behörighetsbidrag (administratörsmedgivande)	Ja	Kräver GA-steg	Kräver GA-steg

När du kör a365 setup all utan global administratör kan CLI:

Slutför alla steg som kan utföras (skissskapande och ärvbara behörigheter).
Genererar URL:er för administratörsmedgivande per resurs och sparar dem till a365.generated.config.json.
Visar nästa steg som visar hur en global administratör kan slutföra OAuth2-beviljandet med antingen a365 setup admin eller de genererade url:erna för medgivande.

Tips/Råd

Om du är global administratör a365 setup all slutför du allt i en enda körning utan att det behövs någon överlämning.

Nödvändiga minimibehörigheter:

Utvecklarroll för agent-ID (för att skapa skisser)
Global administratör (för OAuth2-behörighetsbidrag – om det inte är tillgängligt använder du setup admin överlämning)

`setup all` Alternativ

Option	Description
`-c`, `--config <config>`	Sökväg till konfigurationsfilen. Standardvärdet är `a365.config.json`. Ignoreras när `--agent-name` anges.
`-v`, `--verbose`	Visa detaljerade utdata.
`--dry-run`	Visa vad kommandot skulle göra utan att köra det.
`--skip-requirements`	Hoppa över verifieringskontrollen för krav. Använd med försiktighet: installationen kan misslyckas om kraven inte uppfylls.
`--aiteammate <true\\|false>`	Ställ in på för att `true` köra installationsflödet för AI-teamkamraten. Standardvärdet är `false` (agent). Åsidosätter fältet `aiTeammate` i `a365.config.json`.
`--agent-instance-only`	Endast agent. Hoppa över skiss och behörigheter och registrera bara agentinstansen. Använd för att försöka utföra ett felregistreringssteg igen.
`-n`, `--agent-name <name>`	Agentbasnamn (till exempel `"MyAgent"`). När det anges krävs ingen konfigurationsfil. Härleder visningsnamn som `"<name> Agent"` och `"<name> Blueprint"`. TenantId identifieras automatiskt från `az account show` (åsidosättning med `--tenant-id`). ClientAppId löses genom att leta upp `Agent 365 CLI` i klientorganisationen.
`--tenant-id <tenantId>`	Azure AD-klientorganisations-ID. Åsidosätter automatisk identifiering från `az account show`. Använd med `--agent-name` när du kör i en icke-interaktiv miljö eller för att rikta in dig på en specifik klientorganisation.
`-?`, , `-h--help`	Visa hjälp- och användningsinformation.

Agentkonfiguration

Som standard a365 setup all kör agentflödet. Det här flödet skapar en agent utan ett dataversum- eller AI-teamkamratberoende. Det fungerar för agenter som kommunicerar direkt med Agent 365-plattformen utan att kräva en LICENS för AI-teamkamrat.

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

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

Om du vill köra AI-teamkamratflödet i stället skickar du --aiteammate true.

Det här flödet utför följande steg i följd:

Requirements-validering – kontrollerar Azure roller och förutsättningar.
Blueprint creation – skapar eller återanvänder Entra ID Agent Blueprint-programmet.
Batch-behörigheter – konfigurerar delegerade behörighetsbidrag i skissen för Microsoft Graph, Agent 365 Tools, Messaging Bot API, Observability API, Power Platform och eventuella anpassade resurser.
Agent Identity creation – skapar en agentidentitet i Entra ID via agentidentiteten Graph API.
Agentregistrering – registrerar agenten via AgentX V2-agentregistrerings-API:et.
Konfigurationssynkronisering – skriver inställningar för körningsanslutning och observabilitetskonfiguration till dina projektfiler (appsettings.json, .env).

Anmärkning

Agentkonfigurationen kräver ytterligare sex beta-API-behörigheter för din anpassade klientapp: AgentIdentityBlueprint.AddRemoveCreds.All, , AgentIdentityBlueprint.DeleteRestore.AllAgentInstance.ReadWrite.All, AgentIdentity.ReadWrite.All, AgentIdentity.Create.Alloch AgentIdentity.DeleteRestore.All. Se Anpassad klientappregistrering för den fullständiga listan.

Konfigurationsfri installation med `--agent-name`

Om du inte har en a365.config.json fil kan du använda --agent-name för att köra installationsprogrammet utan en. CLI identifierar din klientorganisation automatiskt och löser klientappen genom att leta upp den välkända Agent 365 CLI appregistreringen i din klientorganisation.

# 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 använder --agent-name:

TenantId identifieras automatiskt från az account show. Skicka --tenant-id till åsidosättning.
ClientAppId löses genom att söka efter en Entra-app med namnet Agent 365 CLI i din klientorganisation. Om det inte hittas avslutas CLI med ett fel. Mer information om hur du registrerar den här appen finns i Anpassad klientappsregistrering .
Visningsnamn härleds som "<name> Agent" (identitet) och "<name> Blueprint" (skiss).
Infrastrukturen hoppas alltid över (extern värd förutsätts).
Konfigurationssynkronisering (skriver appsettings.json) hoppas över eftersom det inte finns någon konfigurerad projektsökväg.

Om klientappen inte har AllPrincipals administratörsmedgivande för de behörigheter som krävs identifierar CLI detta och uppmanar dig att bevilja medgivande interaktivt:

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

Ange y för att bevilja medgivande på rad. Om du inte är global administratör avböjer du och använder setup admin arbetsflödet för överlämning i stället.

Konfigurationssynkronisering

Efter en lyckad körning skriver CLI automatiskt körningsinställningar till dina projektfiler:

Inställning	Skrivet till	Description
`Connections.ServiceConnection`	`appsettings.json` / `.env`	Skissklient-ID, klienthemlighet, klient-ID och tokenslutpunkt
`Agent365Observability`	`appsettings.json` / `.env`	Agent-ID (agentidentitet), skiss-ID, klient-ID, klient-ID och klienthemlighet för telemetriexport
`TokenValidation`	`appsettings.json`	Valideringsinställningar för token (inaktiverade som standard för icke-DW)
`ConnectionsMap`	`appsettings.json` / `.env`	Standardtjänst-URL till anslutningsmappning

CLI skapar filen om den inte finns och uppdaterar enskilda fält utan att skriva över resten av konfigurationen.

Försök igen med en misslyckad registrering

Om installationen slutför skissen och behörigheterna men misslyckas under agentregistreringen kan du bara --agent-instance-only försöka utföra det steget igen utan att upprepa tidigare arbete:

a365 setup all --agent-instance-only

`setup admin`

Slutför OAuth2-behörigheten beviljar (administratörsmedgivande) som kräver global administratör. Kör det här kommandot när en agent-ID-administratör eller agent-ID-utvecklare kör a365 setup all.

Minsta behörigheter som krävs: Global administratör

a365 setup admin [options]

När du ska använda `setup admin`

Använd det här kommandot när:

När en agent-ID-administratör eller agent-ID-utvecklare har kört a365 setup all.
Installationssammanfattningen visar att OAuth2-bidrag väntar och instruerar den globala administratören att köra det här kommandot.
Du vill köra medgivandebidrag igen när du har ändrat behörigheterna i konfigurationen.

Typiskt arbetsflöde för överlämning

# 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>"

Det här kommandot:

Läser in agentkonfigurationen från den angivna katalogen eller den aktuella katalogen som standard.
Läser agentens skiss-ID och konfigurerade resursbehörigheter från den genererade konfigurationen.
Skapar AllPrincipals OAuth2-behörighetsbidrag för alla konfigurerade resurser, inklusive:
- Microsoft Graph (delegerade omfång)
- Agent 365-verktyg (MCP-serveromfattningar)
- Api för meddelanderobot
- Observabilitets-API
- Power Platform-API
- Alla anpassade behörigheter som definierats i konfigurationen
Visar en bekräftelseprompt innan du gör ändringar. Använd --yes för att kringgå kommandotolken.

Varning

OAuth2-bidrag som skapas av det här kommandot är klientomfattande (consentType=AllPrincipals). Den här konfigurationen innebär att alla användare i klientorganisationen kan använda agentens delegerade behörigheter. Granska de angivna omfången noggrant innan du bekräftar.

`setup admin` Alternativ

Option	Description
`-d`, `--config-dir <dir>`	Katalog som innehåller `a365.config.json` och `a365.generated.config.json`. Standardvärdet är aktuell katalog.
`-v`, `--verbose`	Visa detaljerade utdata.
`--dry-run`	Visa vad kommandot skulle göra utan att köra det.
`--skip-requirements`	Hoppa över verifieringskontrollen för krav. Använd med försiktighet.
`-y`, `--yes`	Hoppa över bekräftelseprompten och fortsätt automatiskt.
`-?`, , `-h--help`	Visa hjälp- och användningsinformation.

I stället för att köra a365 setup adminkan den globala administratören öppna den kombinerade medgivande-URL:en som a365 setup all sparar till a365.generated.config.json. Den här URL:en omfattar alla nödvändiga resurser i ett enda webbläsarbesök.

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

Feedback

Var den här sidan till hjälp?

Last updated on 2026-04-27

Kommandoreferens för Agent 365 CLI setup

Syntax

Options

Rekommenderad körningsordning

setup requirements

requirements Alternativ

setup blueprint

blueprint Alternativ

setup permissions

Options

Subcommands

setup permissions mcp

permissions mcp Alternativ

Migrera till MCP-behörigheter per server

setup permissions bot

permissions bot Alternativ

setup permissions custom

permissions custom Alternativ

Konfigurera anpassade behörigheter

Ta bort anpassade behörigheter

Integrering med setup all

setup permissions copilotstudio

permissions copilotstudio Alternativ

setup all

setup all Alternativ

Agentkonfiguration

Konfigurationsfri installation med --agent-name

Administratörsmedgivande under installationen

Konfigurationssynkronisering

Försök igen med en misslyckad registrering

setup admin

När du ska använda setup admin

Typiskt arbetsflöde för överlämning

setup admin Alternativ

Alternativ: medgivande-URL

Feedback

Ytterligare resurser

Kommandoreferens för Agent 365 CLI `setup`

`setup requirements`

`requirements` Alternativ

`setup blueprint`

`blueprint` Alternativ

`setup permissions`

`setup permissions mcp`

`permissions mcp` Alternativ

`setup permissions bot`

`permissions bot` Alternativ

`setup permissions custom`

`permissions custom` Alternativ

Integrering med `setup all`

`setup permissions copilotstudio`

`permissions copilotstudio` Alternativ

`setup all`

`setup all` Alternativ

Konfigurationsfri installation med `--agent-name`

`setup admin`

När du ska använda `setup admin`

`setup admin` Alternativ