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 + Global administratör

Syntax

a365 setup [command] [options]

Options

Rekommenderad körningsordning

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

# Full setup (includes infrastructure)
a365 setup all

# Skip infrastructure if it already exists
a365 setup all --skip-infrastructure

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 infrastructure

Skapa Azure infrastruktur.

Minimum nödvändiga behörigheter: Azure prenumerationsdeltagare eller ägare

a365 setup infrastructure [options]

infrastructure Alternativ

setup blueprint

Skapa agentskiss (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]

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.

permissions mcp Alternativ

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)

Nästa steg: Distribuera din agent (kör a365 deploy om du är värd på Azure)

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. Genom att använda 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 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 har tagits bort från konfigurationen.
• Är idempotent och säkert att köra flera gånger.

permissions custom Alternativ

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

Resursnamnet löses automatiskt från Azure under installationen. 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örningen a365 setup all dem automatiskt. Den fullständiga installationsordningen är:

1. Infrastruktur
2. Ritning
3. MCP-behörigheter
4. Bot API-behörigheter
5. Anpassade skissbehörigheter (om de har konfigurerats)
6. Slutpunkt för meddelanden

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

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.

Omfattar: Infrastruktur, skiss, behörigheter och slutpunkt.

Lägsta nödvändiga behörigheter (Global administratör har alla dessa behörigheter):

• Azure prenumerationsdeltagare (för infrastruktur och slutpunkt)
• Utvecklarroll för agent-ID (för att skapa skisser)
• Global administratör (för behörighetsbidrag och administratörsmedgivande)

setup all Alternativ