Del via

Agent 365 CLI-kommandoreference create-instance

Vigtig

Du skal være en del af prøveversionsprogrammet Frontier for at få early adgang til Microsoft Agent 365. Frontier forbinder dig direkte med Microsoft seneste AI-innovationer. Fronteksempler er underlagt de eksisterende prøveversionsbetingelser i dine kundeaftaler. Da disse funktioner stadig er under udvikling, kan deres tilgængelighed og egenskaber ændre sig over tid.

Opret agentidentitet og agentbruger, og føj tilladelser til identiteten og licenserne til brugeren. Kommandoen create-instance opretter agentforekomster med identiteter, licenser og nødvendige tilladelser. Brug denne kommando til at konfigurere komplette agentforekomster, herunder oprettelse af agentidentiteten, tildeling af nødvendige licenser og tildeling af tilladelser til identiteten.

Kommandoen create-instance udfører følgende handlinger:

  1. Creates Agent Identity – Registrerer en agentidentitetstjenesteprincipal i Microsoft Entra via Graph API.
  2. Opretter agentbruger – opretter en agentbrugerkonto, der er knyttet til identiteten.
  3. Tildeler leder og sponsor – Angiver den aktuelle bruger som leder og sponsor for agentbrugeren og -identiteten.
  4. Tildeler licenser – tildeler agentbrugeren de påkrævede Agent 365-licenser.

Minimumrolle kræves: Global administrator

Bemærkning

Hvis du ikke har de nødvendige Agent 365-licenser at tildele endnu, kan du fortsætte med at bruge create-instance identity og derefter bruge create-instance licenses bagefter til at tildele licenserne, når du har dem.

Syntax

Følgende viser syntaksen for kommandoen create-instance og dens valgfri underkommandoer.

a365 create-instance [command] [options]

Når du kører create-instance uden en underkommando, udføres begge trin i rækkefølge: Den opretter agentens identitet og agentbrugeren og tildeler derefter licenser.

Indstillinger

Brug disse indstillinger sammen med create-instance kommandoen eller create-instance identity underkommandoerne og create-instance licenses .

Mulighed Beskrivelse
-c, --config <config> Sti til konfigurationsfil (standard: a365.config.json)
-v, --verbose Vis detaljeret output
--dry-run Vis, hvad der skal gøres uden at udføre
-?, , , -h--help Vis oplysninger om hjælp og brug

Forudsætninger

Før du kører create-instance, skal du sikre dig, at du:

  • Fuldførte trinnet i installationsagentens kursusplan (a365 setup).
  • Publicerede din agent ved hjælp a365 publishaf .
  • Hav en gyldig a365.config.json og a365.generated.config.json i din arbejdsmappe.
  • Logget på med en konto, der har globale administratortilladelser.

create-instance Eksempler

I disse eksempler kan du se, hvordan du bruger kommandoen create-instance uden underkommandoer.

Opret en fuld agentforekomst

Kør create-instance uden indstillinger for at oprette en komplet agentforekomst ved hjælp af standardkonfigurationen.

a365 create-instance

Opret med en bestemt konfigurationsfil

Brug indstillingen --config til at angive en brugerdefineret konfigurationsfilsti.

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

Vis ændringerne

Brug indstillingen --dry-run til at se, hvad der create-instance ville gøre uden at foretage ændringer.

a365 create-instance --dry-run

create-instance identity

Opret agentidentitet og agentbruger, men tildel ikke licenser.

Brug denne kommando til at springe licenserne over under oprettelse af en identitet.

Bemærkning

Hvis du endnu ikke har tilgængelige licenser, skal du bruge denne kommando, så du ikke er blokeret. Du kan køre create-instance licenses , når du har licenser.

a365 create-instance identity

create-instance licenses

Føj licenser til en eksisterende agentbruger.

Brug denne kommando til at oprette licenser, når identiteten allerede findes.

Bemærkning

Hvis du har brugt create-instance identity tidligere, skal du bruge denne kommando, når der er tilgængelige licenser.

a365 create-instance licenses

Brug disse kommandoer sammen med create-instance til at administrere hele din agents livscyklus.

  • Last updated on