Del via

Kommandoreferanse for Agent 365 CLI setup

Viktig!

Du må være en del av frontier-forhåndsvisningsprogrammet for å få tidlig tilgang til Microsoft Agent 365. Frontier kobler deg direkte til Microsofts nyeste ai-innovasjoner. Grenseforhåndsvisninger er underlagt de eksisterende forhåndsvisningsvilkårene i kundeavtalene dine. Ettersom disse funksjonene fremdeles er under utvikling, kan tilgjengeligheten og funksjonene endres over tid.

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 + Global-administrator

Syntaks

a365 setup [command] [options]

Alternativer

Alternativ Beskrivelse
-?, , -h--help Viser informasjon om hjelp og bruk. 
# 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 kjør alle trinnene samtidig:

# Full setup (includes infrastructure)
a365 setup all

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

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

Alternativ Beskrivelse
-c, --config <config> Konfigurasjonsfilbane. Standardverdien er a365.config.json.
-v, --verbose Viser detaljerte utdata for alle kontroller.
--category <category> Kjører ser bare etter en bestemt kategori, for eksempel Azure, Authentication eller Configuration.
-?, , -h--help Viser informasjon om hjelp og bruk.

setup infrastructure

Opprett Azure infrastruktur.

Minimum nødvendige tillatelser: Azure abonnementsbidragsyter eller eier

a365 setup infrastructure [options]

infrastructure Alternativer

Alternativ Beskrivelse
-c, --config <config> Konfigurasjonsfilbane. Standardverdien er a365.config.json.
-v, --verbose Vis detaljerte utdata.
--dry-run Vis hva som ville blitt gjort uten å kjøre.
-?, , -h--help Viser informasjon om hjelp og bruk.

setup blueprint

Opprett agenttegning (entra-ID-programregistrering).

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

a365 setup blueprint [options]

blueprint Alternativer

Alternativ Beskrivelse
-c, --config <config> Konfigurasjonsfilbane. Standardverdien er a365.config.json.
-v, --verbose Vis detaljerte utdata.
--dry-run Vis hva som ville blitt gjort uten å kjøre.
--no-endpoint Ikke registrer meldingsendepunktet (bare blåkopi).
--endpoint-only Bare registrer meldingsendepunkt. Krever eksisterende plantegning.
-?, , -h--help Viser informasjon om hjelp og bruk.

setup permissions

Konfigurer OAuth2-tillatelsestilskudd og arvbare tillatelser.

Minimum nødvendige tillatelser: Global administrator

a365 setup permissions [command] [options]

Alternativer

Alternativ Beskrivelse
-?, , -h--help Viser informasjon om hjelp og bruk.

Underkommandoer

Underkommandoen Beskrivelse
mcp Konfigurer MCP-server-OAuth2-bevilgninger og arvbare tillatelser.
bot Konfigurer Messaging Bot API OAuth2-bevilgninger og arvbare tillatelser.
custom Bruker egendefinerte API-tillatelser på agenttegningen som går utover standardtillatelsene som kreves for agentoperasjon.
copilotstudio Konfigurerer OAuth2-tillatelsestilskudd og arvbare tillatelser for agenttegningen for å aktivere Copilot Studio-copiloter via Power Platform API-en.

setup permissions mcp

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

Minimum nødvendige tillatelser: Global administrator

a365 setup permissions mcp [options]

Denne kommandoen:

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

Viktig!

  • Før du kjører denne kommandoen, kjører a365 config display du for å bekrefte at deploymentProjectPath peker til prosjektmappen som inneholder den oppdaterte ToolingManifest.json. Hvis utvikleren legger til MCP-servere på en annen maskin, kan du dele den oppdaterte ToolingManifest.json med den globale administratoren først. Hvis du kjører uten riktig, ToolingManifest.json legges ikke de nye MCP-servertillatelsene til tegningen.
  • Kjør denne kommandoen etter at utvikleren kjører a365 develop add-mcp-servers. Å legge til MCP-servere i manifestet og gi tillatelser til tegningen er to separate trinn. Når denne kommandoen er fullført, er MCP-servertillatelsene synlige i agenttegningen.

permissions mcp Alternativer

Alternativ Beskrivelse
-c, --config <config> Konfigurasjonsfilbane. Standardverdien er a365.config.json.
-v, --verbose Vis detaljerte utdata.
--dry-run Vis hva som ville blitt gjort uten å kjøre.
-?, , -h--help Viser informasjon om hjelp og bruk.

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)

Next-trinn: Distribuer agenten (kjør a365 deploy hvis du er vert for Azure)

a365 setup permissions bot [options]

permissions bot Alternativer

Alternativ Beskrivelse
-c, --config <config> Konfigurasjonsfilbane. Standardverdien er a365.config.json.
-v, --verbose Vis detaljerte utdata.
--dry-run Vis hva som ville blitt gjort uten å kjøre.
-?, , -h--help Viser informasjon om hjelp og bruk.

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 Entra ID-leier.

Minimum nødvendige tillatelser: Global administrator

Forutsetninger: Kjør a365 setup blueprint først. Legg til egendefinerte tillatelser ved bruk a365.config.jsona365 config permissions før du kjører denne kommandoen.

a365 setup permissions custom [options]

Denne kommandoen:

  • 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 som ble slettet fra konfigurasjonen.
  • Er idempotent og trygt å kjøre flere ganger.

permissions custom Alternativer

Alternativ Beskrivelse
-c, --config <config> Konfigurasjonsfilbane. Standardverdien er a365.config.json.
-v, --verbose Vis detaljerte utdata.
--dry-run Vis hva som ville blitt gjort uten å kjøre.
-?, , -h--help Viser informasjon om hjelp og bruk.

Konfigurer egendefinerte tillatelser

Brukes a365 config permissions til å legge til egendefinerte tillatelser i konfigurasjonen før du kjører denne kommandoen:

# 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

Ressursnavnet løses automatisk fra Azure under installasjonen. Du trenger ikke å angi det i konfigurasjonen.

Fjerne egendefinerte tillatelser

Slik fjerner du egendefinerte tillatelser fra både konfigurasjonen og 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 konfigurasjonen inneholder egendefinerte tillatelser, konfigurerer kjøring a365 setup all dem automatisk. Den fullstendige konfigurasjonsrekkefølgen er:

  1. Infrastruktur
  2. Plan
  3. MCP-tillatelser
  4. Bot-API-tillatelser
  5. Egendefinerte plantegningstillatelser (hvis konfigurert)
  6. Meldingsendepunkt

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]

Denne kommandoen:

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

permissions copilotstudio Alternativer

Alternativ Beskrivelse
-c, --config <config> Konfigurasjonsfilbane. Standardverdien er a365.config.json.
-v, --verbose Vis detaljerte utdata.
--dry-run Vis hva som ville blitt gjort uten å kjøre.
-?, , -h--help Viser informasjon om hjelp og bruk.

Bruk denne kommandoen når agenten din må aktivere Copilot Studio-kopiloter under 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: Infrastruktur, plantegning, tillatelser og endepunkt.

Minimum nødvendige tillatelser (global administrator har alle disse tillatelsene):

  • Azure abonnementsbidragsyter (for infrastruktur og endepunkt)
  • Utviklerrolle for agent-ID (for oppretting av plantegning)
  • Global administrator (for tillatelsestilskudd og administratorsamtykke)

setup all Alternativer

Alternativ Beskrivelse
-c, --config <config> Konfigurasjonsfilbane. Standardverdien er a365.config.json.
-v, --verbose Vis detaljerte utdata.
--dry-run Vis hva som ville blitt gjort uten å kjøre.
--skip-infrastructure Hopp over Azure oppretting av infrastruktur (bruk hvis infrastruktur allerede finnes). Dette alternativet oppretter fortsatt: Plantegning, Tillatelser og Endepunkt.
--skip-requirements Hopp over kravvalideringskontroll. Vær forsiktig: Installasjonsprogrammet kan mislykkes hvis forutsetningene ikke oppfylles.
-?, , -h--help Viser informasjon om hjelp og bruk.
  • Last updated on