Kommandoreferanse for Agent 365 CLI setup

Konfigurer Agent 365-miljøet med detaljert kontroll over hvert trinn. Denne kommandoen administrerer den første konfigurasjonsarbeidsflyten for Agent 365-tegninger.

Minimum-rolle kreves: Azure bidragsyter + Agent ID Developer

Syntax

a365 setup [command] [options]

Alternativer

Anbefalt kjøringsrekkefø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 kjør alle trinnene samtidig:

# 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 kjører som agent-ID-administrator eller agent-ID-utvikler (ikke global administrator), a365 setup all fullfører du alle trinnene unntatt OAuth2-tillatelsestilskudd. Når den er ferdig, inkluderer utdataene de neste stegene for at en global administrator skal fullføre tildelingene — inkludert en direkte lenke eller samtykke-URL de kan åpne.

setup requirements

Valider forutsetninger for agent 365-konfigurasjon. Kjører modulkravkontroller og gir veiledning for eventuelle problemer den finner.

a365 setup requirements [options]

Denne kommandoen kjører følgende trinn:

• Kontrollerer alle forutsetninger som kreves for agent 365-konfigurasjon.
• Rapporterer eventuelle problemer med detaljert løsningsveiledning.
• Fortsetter å kontrollere alle krav selv om noen kontroller mislykkes.
• Gir et sammendrag av alle kontrollene på slutten.

requirements Alternativer

setup blueprint

Opprett agenttegning (Entra ID programregistrering).

Minimum nødvendige tillatelser: Agent-ID Developer-rolle

a365 setup blueprint [options]

blueprint Alternativer

setup permissions

Konfigurer OAuth2-tillatelsestilskudd og arvbare tillatelser.

Minimum nødvendige tillatelser: Global administrator

a365 setup permissions [command] [options]

Alternativer

Subcommands

setup permissions mcp

Konfigurer MCP-server-OAuth2-bevilgninger og arvbare tillatelser.

Minimum nødvendige tillatelser: Global administrator

a365 setup permissions mcp [options]

This command:

• Leser ToolingManifest.json fra angitt deploymentProjectPath i a365.config.json.
• Gir OAuth2 delegerte tillatelsestilskudd for hvert MCP-serveromfang til agenttegningen.
• Konfigurerer arvbare tillatelser slik at agentforekomster kan få tilgang til MCP-verktøy.
• Er idempotent og trygt å kjøre flere ganger.

permissions mcp Alternativer

Overføre til MCP-tillatelser per server

Brukes --remove-legacy-scopes når du overfører fra den eldre modellen for delte tillatelser til per server-tillatelser:

• Eldre delt modell: Én enkelt ressursapp-ID (ea9ffc3e-8a23-4a7d-836d-234d7c7565c1) med delte omfang, for eksempel McpServers.Mail.All og McpServers.Teams.All.
• Modell per server: Hver MCP-server har sin egen app-ID med omfanget Tools.ListInvoke.All.

Eksemplet nedenfor viser hvordan tillatelser per server vises i Microsoft Entra administrasjonssenter etter at tegningen er brukt. Hver MCP-server, for eksempel WORK IQ Calendar MCP og Work IQ Mail MCP, har sitt eget delegerte Tools.ListInvoke.All omfang. Et delt McpServersMetadata.Read.All omfang gir tilgang til MCP-servermetadata.

setup permissions bot

Konfigurer Messaging Bot API OAuth2-bevilgninger og arvbare tillatelser.

Minimum nødvendige tillatelser: Global administrator

Forutsetninger: Blueprint- og MCP-tillatelser (kjør a365 setup permissions mcp først)

a365 setup permissions bot [options]

permissions bot Alternativer

setup permissions custom

Bruker egendefinerte API-tillatelser på agenttegningen som går utover standardtillatelsene som kreves for agentoperasjon. Ved å bruke denne kommandoen gir du agenten din tilgang til flere Microsoft Graph omfang, for eksempel tilstedeværelse, filer og chat, eller til egendefinerte API-er som er registrert i organisasjonens Microsoft Entra ID tenant.

Minimum nødvendige tillatelser: Global administrator

Forutsetninger: Kjør a365 setup blueprint først.

a365 setup permissions custom [options]

This command:

• Konfigurerer OAuth2-delegerte tillatelsestilskudd med administratorsamtykke for hver konfigurerte ressurs.
• Angir arvbare tillatelser slik at agentbrukere kan arve tilgang fra tegningen.
• Avstemmer Microsoft Entra med gjeldende konfigurasjon ved å legge til nye tillatelser og fjerne eventuelle tillatelser du slettet fra konfigurasjonen.
• Er idempotent og trygt å kjøre flere ganger.

permissions custom Alternativer

Konfigurer egendefinerte tillatelser inline

Bruk --resource-app-id og --scopes for å anvende egendefinerte tillatelser direkte uten å redigere 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

Ressursnavnet løses automatisk fra Microsoft Entra. Du trenger ikke å spesifisere det.

Konfigurer egendefinerte tillatelser via konfigurasjonsfil

Alternativt, legg til customBlueprintPermissionsa365.config.json og kjør kommandoen uten inline-flagg:

a365 setup permissions custom

Denne kommandoen forener Microsoft Entra med de konfigurerte tillatelsene – den legger til nye tillatelser og fjerner eventuelle tillatelser du har slettet fra konfigurasjonen.

Integrering med setup all

Når konfigurasjonen inneholder egendefinerte tillatelser, konfigurerer kjøring a365 setup all automatisk dem som en del av en enkelt satsvis tillatelsesfase. Den fullstendige konfigurasjonsrekkefølgen er:

1. Blueprint
2. Tillatelsesgruppe (MCP, Bot API, egendefinerte plantegningstillatelser – alle konfigurert sammen)

setup permissions copilotstudio

Konfigurerer OAuth2-tillatelsestilskudd og arvbare tillatelser for agenttegningen for å aktivere Copilot Studio copiloter via Power Platform-API-en.

Minimum nødvendige tillatelser: Global administrator

Forutsetninger: Kjør a365 setup blueprint først.

a365 setup permissions copilotstudio [options]

This command:

• Sikrer at API-tjenestekontohaveren for Power Platform finnes i leieren.
• Oppretter et OAuth2-tillatelsestilskudd fra tegningen til Power Platform API-en med omfanget CopilotStudio.Copilots.Invoke .
• Angir arvbare tillatelser slik at agentforekomster kan aktivere Copilot Studio copiloter.

permissions copilotstudio Alternativer

Bruk denne kommandoen når agenten din må aktivere Copilot Studio copiloter ved kjøring eller ringe Power Platform-API-er som krever CopilotStudio-tillatelser.

setup all

Utfør alle konfigurasjonstrinnene for å konfigurere Agent 365-miljøet

a365 setup all [options]

Kjører det fullstendige agent 365-oppsettet, alle trinnene i rekkefølge.

Inkluderer: Plantegning og tillatelser.

Trinnene som fullføres, avhenger av rollen din:

Når du kjører a365 setup all uten global administrator, gjør CLI følgende:

1. Fullfører alle trinnene det kan (oppretting av tegning og arvbare tillatelser).
2. Genererer nettadresser for administrator per ressurs og lagrer dem i a365.generated.config.json.
3. Viser neste steg i utdataene for en global administrator for å fullføre OAuth2-tilskuddene, inkludert en direkte lenke eller samtykke-URL.

Minimum nødvendige tillatelser:

• Utviklerrolle for agent-ID (for oppretting av plantegning)
• Global Administrator (for OAuth2-tillatelser – hvis ikke tilgjengelig, skriver CLI-en ut neste steg i utdataen)
• Application Administrator eller Global Administrator (for S2S (Server-to-Server) agentidentitet gir – --authmode s2s eller both; hvis ikke tilgjengelig, skriver CLI-en ut en PowerShell-fallback i oppsettsoppsummeringen)

setup all Alternativer

Agent setup

Som standard a365 setup all kjører blueprint agent-flyten. Denne flyten oppretter en agent uten en datavers- eller AI-teammedlemsavhengighet. Det fungerer for agenter som kommuniserer direkte med Agent 365-plattformen.

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

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

For å kjøre AI-lagkameratens agentflyt i stedet, pass --aiteammate.

Denne flyten utfører følgende trinn i rekkefølge:

1. Requirements validation – kontrollerer Azure roller og forutsetninger.
2. Blueprint – oppretter eller bruker Entra ID Agent Blueprint-programmet på nytt.
3. Batch-tillatelser – konfigurerer delegerte tillatelsestilskudd på tegningen for Microsoft Graph, Agent 365 Tools, Messaging Bot API, Observability API, Power Platform og eventuelle egendefinerte ressurser.
4. Agent Identity creation – oppretter en agentidentitet i Entra ID via agentidentiteten Graph API.
5. Agentregistrering – registrerer agenten via AgentX V2 Agent Registration API.
6. Konfigurasjonssynkronisering – skriver innstillingene for kjøretidstilkobling og konfigurasjon av overholdelse til prosjektfilene (appsettings.json, .env).

Konfigurasjonsfritt konfigurasjon med --agent-name

Hvis du ikke har en a365.config.json fil, kan du bruke --agent-name til å kjøre installasjonsprogrammet uten en. CLI oppdager tenanten automatisk og løser klientappen ved å slå opp den velkjente Agent 365 CLI appregistreringen i leieren.

# 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 bruker --agent-name:

• TenantId oppdages automatisk fra az account show. Send --tenant-id til overstyring.
• ClientAppId løses ved å se etter en Entra-app som er navngitt Agent 365 CLI i leieren. Hvis ikke funnet, avsluttes CLI med en feil. Se Registrering av egendefinert klientapp for hvordan du registrerer denne appen.
• Visningsnavn er avledet som "<name> Agent" (identitet) og "<name> Blueprint" (plantegning).
• Infrastruktur hoppes alltid over (ekstern vert antas).
• Konfigurasjonssynkronisering (skriving appsettings.json) hoppes over siden det ikke er konfigurert noen prosjektbane.

Administratorsamtykke under konfigurasjon

Hvis klientappen ikke har AllPrincipals administratorsamtykke for de nødvendige tillatelsene, oppdager CLI dette og ber deg om å gi samtykke interaktivt:

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

Skriv inn y for å gi samtykke i køen. Hvis du ikke er en Global Administrator, avslå — CLI-en publiserer de neste stegene for en Global Administrator i oppsettsoppsummeringen.

Agentidentitet gir (--authmode)

Som standard oppretter a365 setup all principal-scoped delegerte tildelinger på agentidentitetstjenesteprincipalen (obo modus). Disse tilskuddene krever ikke en administrativ rolle.

Bruk --authmode for å kontrollere tilskuddstypen:

# 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 innloggede brukeren mangler den nødvendige rollen for S2S-tildelinger, skriver CLI ut en PowerShell-fallback-blokk i oppsettsoppsummeringen. En administrator kan kjøre det for å fullføre oppgavene.

Satt authMode inn a365.config.json slik at det gjelder på hver gjennomspilling uten flagget:

{
  "authMode": "s2s"
}

Config sync

Etter en vellykket kjøring skriver CLI automatisk kjøretidsinnstillinger til prosjektfilene:

Cli oppretter filen hvis den ikke finnes og oppdaterer individuelle felt uten å overskrive resten av konfigurasjonen.

Prøv en mislykket registrering på nytt

Hvis oppsettet fullfører tegning og tillatelser, men mislykkes under agentregistrering, kan du bare prøve --agent-registration-only dette trinnet på nytt uten å gjenta tidligere arbeid:

a365 setup all --agent-registration-only