Kommandoreferens för Agent 365 CLI setup

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

Syntax

a365 setup [command] [options]

Options

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 det är klart innehåller utdata nästa steg för en Global Administrator att slutföra bidragen – inklusive en direktlänk eller samtyckes-URL som de kan öppna.

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

setup blueprint

Skapa agentritning (Entra ID programregistrering).

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

a365 setup blueprint [options]

blueprint Alternativ

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

Subcommands

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]

This command:

• 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.

permissions mcp Alternativ

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

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.

a365 setup permissions custom [options]

This command:

• 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

Konfigurera anpassade behörigheter inline

Använd --resource-app-id och --scopes för att tillämpa anpassade behörigheter direkt utan att redigera a365.config.json:

# Add Microsoft Graph extended permissions
a365 setup permissions custom `
  --resource-app-id 00000003-0000-0000-c000-000000000000 `
  --scopes Presence.ReadWrite,Files.Read.All,Chat.Read

# Add custom API permissions
a365 setup permissions custom `
  --resource-app-id <your-api-app-id> `
  --scopes CustomScope.Read,CustomScope.Write

Resursnamnet löses automatiskt från Microsoft Entra. Du behöver inte specificera det.

Konfigurera anpassade behörigheter via konfigurationsfil

Alternativt, lägg till customBlueprintPermissionsa365.config.json och kör kommandot utan inline-flaggor:

a365 setup permissions custom

Detta kommando stämmer av Microsoft Entra med de konfigurerade behörigheterna – det lägger till nya behörigheter och tar bort alla behörigheter du tagit bort från konfigurationen.

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

1. Blueprint
2. 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]

This command:

• 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

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:

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

1. Slutför alla steg som kan utföras (skissskapande och ärvbara behörigheter).
2. Genererar URL:er för administratörsmedgivande per resurs och sparar dem till a365.generated.config.json.
3. Visar nästa steg i utdata för en global administratör för att slutföra OAuth2-bidragen, inklusive en direktlänk eller samtyckes-URL.

Nödvändiga minimibehörigheter:

• Utvecklarroll för agent-ID (för att skapa skisser)
• Global Administrator (för OAuth2-behörighetsbeviljande – om det inte finns tillgängligt skriver CLI:n ut nästa steg i utdatat)
• Agent ID Administrator, Application Administrator eller Global Administrator (för S2S (Server-to-Server) agentidentitet beviljas – --authmode s2s eller both; om det inte är tillgängligt, skriver CLI:n ut en PowerShell-reservplan i installationssammanfattningen)

setup all Alternativ

Agent setup

Som standard körs a365 setup all blueprint agent-flö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.

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

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

För att köra AI-lagkamratens agentflöde istället, passa --aiteammate.

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

1. Requirements-validering – kontrollerar Azure roller och förutsättningar.
2. Blueprint creation – skapar eller återanvänder Entra ID Agent Blueprint-programmet.
3. 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.
4. Agent Identity creation – skapar en agentidentitet i Entra ID via agentidentiteten Graph API.
5. Agentregistrering – registrerar agenten via AgentX V2-agentregistrerings-API:et.
6. Konfigurationssynkronisering – skriver inställningar för körningsanslutning och observabilitetskonfiguration till dina projektfiler (appsettings.json, .env).

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.

Administratörsmedgivande under installationen

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 Administrator, tacka nej — CLI skriver ut nästa steg för en Global Administrator i setup-sammanfattningen.

Agentidentitet ger (--authmode)

Som standard a365 setup all skapar principal-scoped delegerade grants på agentidentitetstjänstens principal (obo mode). Dessa bidrag kräver ingen administrativ roll.

Användning --authmode för att kontrollera bidragstypen:

# Default — OBO delegated grants (no admin role needed)
a365 setup all

# S2S app role assignments
a365 setup all --authmode s2s

# Both OBO and S2S
a365 setup all --authmode both

När den inloggade användaren saknar den roll som krävs för S2S-beviljaningar, skriver CLI:n ut en PowerShell-reservblock i setup-sammanfattningen. En administratör kan köra den för att slutföra uppgifterna.

Inställt authMode så a365.config.json att det gäller vid varje genomspelning utan flaggan:

{
  "authMode": "s2s"
}

Config sync

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

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-registration-only försöka utföra det steget igen utan att upprepa tidigare arbete:

a365 setup all --agent-registration-only