Del via


Kommandoreferanse for Agent 365 CLI create-instance

Viktig!

Du må være en del av forhåndsvisningsprogrammet for Frontier for å få early access til Microsoft Agent 365. Frontier kobler deg direkte til Microsoft 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.

Opprett agentidentitet og agentbruker, og legg til tillatelser for identiteten og lisensene til brukeren. Kommandoen create-instance oppretter agentforekomster med identiteter, lisenser og nødvendige tillatelser. Bruk denne kommandoen til å konfigurere fullstendige agentforekomster, inkludert oppretting av agentidentiteten, tilordne nødvendige lisenser og gi tillatelser til identiteten.

Kommandoen create-instance utfører disse operasjonene:

  1. Creates Agent Identity – Registrerer en agentidentitetstjenestekontohaver i Microsoft Entra gjennom Graph API.
  2. Oppretter agentbruker – Oppretter en agentbrukerkonto som er knyttet til identiteten.
  3. Tilordner overordnet og sponsor – angir gjeldende bruker som leder og sponsor for agentbrukeren og identiteten.
  4. Tilordner lisenser – Tilordner de nødvendige Agent 365-lisensene til agentbrukeren.

Minimumsrolle kreves: Global administrator

Bemerkning

Hvis du ikke har de nødvendige Agent 365-lisensene å tilordne ennå, kan du fortsette å bruke create-instance identity og deretter bruke create-instance licenses etterpå til å tilordne lisensene når du har dem.

Syntaks

Følgende viser syntaksen create-instance for kommandoen og de valgfrie underkommandoene.

a365 create-instance [command] [options]

Når du kjører create-instance uten en underkommando, utfører den begge trinnene i rekkefølge: den oppretter agentidentiteten og agentbrukeren, og tilordner deretter lisenser.

Alternativer

Bruk disse alternativene med create-instance kommandoen eller create-instance identity og create-instance licenses underkommandoene.

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

Forutsetninger

Før du kjører create-instance, må du kontrollere at du:

create-instance Eksempler

Disse eksemplene viser hvordan du bruker create-instance kommandoen uten underkommandoer.

Opprett en fullstendig agentforekomst

Kjør create-instance uten alternativer for å opprette en fullstendig agentforekomst ved hjelp av standardkonfigurasjonen.

a365 create-instance

Opprette med en bestemt konfigurasjonsfil

--config Bruk alternativet for å angi en egendefinert konfigurasjonsfilbane.

a365 create-instance --config path/to/a365.config.json

Forhåndsvise endringene

--dry-run Bruk alternativet for å se hva som create-instance ville gjort uten å gjøre noen endringer.

a365 create-instance --dry-run

create-instance identity

Opprett agentidentitet og agentbruker, men ikke tilordne lisenser.

Bruk denne kommandoen til å hoppe over lisensene mens du oppretter en identitet.

Bemerkning

Hvis du ikke har lisenser tilgjengelig ennå, kan du bruke denne kommandoen slik at du ikke blokkeres. Du kan kjøre create-instance licenses når du har lisenser.

a365 create-instance identity

create-instance licenses

Legg til lisenser til en eksisterende agentbruker.

Bruk denne kommandoen til å opprette lisensene når identiteten allerede finnes.

Bemerkning

Hvis du brukte create-instance identity tidligere, kan du bruke denne kommandoen når lisenser er tilgjengelige.

a365 create-instance licenses

Bruk disse kommandoene sammen med create-instance for å administrere hele livssyklusen til agenten din.