Kommandoreferens för Agent 365 CLI create-instance

Viktigt!

Du måste vara en del av förhandsversionen av Frontier för att få early åtkomst till Microsoft Agent 365. Frontier ansluter dig direkt till Microsoft senaste AI-innovationer. Förhandsversioner av Gräns omfattas av de befintliga förhandsversionsvillkoren för dina kundavtal. Eftersom dessa funktioner fortfarande är under utveckling kan deras tillgänglighet och funktioner ändras över tid.

Skapa agentidentitet och agentanvändare och lägg till behörigheter till identiteten och licenserna för användaren. Kommandot create-instance skapar agentinstanser med identiteter, licenser och nödvändiga behörigheter. Använd det här kommandot för att konfigurera fullständiga agentinstanser, inklusive att skapa agentidentiteten, tilldela nödvändiga licenser och bevilja behörigheter till identiteten.

Kommandot create-instance utför följande åtgärder:

  1. Skapa agentidentitet – Registrerar ett huvudnamn för agentidentitetstjänsten i Microsoft Entra via Graph API.
  2. Skapar agentanvändare – Skapar ett agentanvändarkonto som är associerat med identiteten.
  3. Tilldelar chef och sponsor – Anger den aktuella användaren som chef och sponsor för agentanvändaren och identiteten.
  4. Tilldelar licenser – Tilldelar nödvändiga Agent 365-licenser till agentanvändaren.

Minsta roll krävs: Global administratör

Anmärkning

Om du inte har de agent 365-licenser som krävs för att tilldela ännu kan du fortsätta använda create-instance identity och sedan använda create-instance licenses efteråt för att tilldela licenserna när du har dem.

Syntax

Följande visar syntaxen create-instance för kommandot och dess valfria underkommandon.

a365 create-instance [command] [options]

När du kör create-instance utan en underkommando körs båda stegen i följd: den skapar agentidentiteten och agentanvändaren och tilldelar sedan licenser.

Options

Använd de här alternativen med create-instance kommandot eller underkommandona create-instance identity och create-instance licenses .

Option Description
-c, --config <config> Konfigurationsfilsökväg (standard: a365.config.json)
-v, --verbose Visa detaljerade utdata
--dry-run Visa vad som skulle göras utan att köra
-?, , -h--help Visa hjälp- och användningsinformation

Förutsättningar

Innan du kör create-instancekontrollerar du att du:

  • Slutfört skisssteget för installationsagenten (a365 setup).
  • Publicerade din agent med hjälp a365 publishav .
  • Ha en giltig a365.config.json och a365.generated.config.json i arbetskatalogen.
  • Inloggad med ett konto som har behörighet som global administratör.

create-instance exempel

De här exemplen visar hur du create-instance använder kommandot utan underkommandon.

Skapa en fullständig agentinstans

Kör create-instance utan alternativ för att skapa en fullständig agentinstans med hjälp av standardkonfigurationen.

a365 create-instance

Skapa med en specifik konfigurationsfil

Använd alternativet --config för att ange en anpassad konfigurationsfilsökväg.

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

Förhandsgranska ändringarna

Använd alternativet --dry-run för att se vad create-instance som skulle göra utan att göra några ändringar.

a365 create-instance --dry-run

create-instance identity

Skapa agentidentitet och agentanvändare, men tilldela inte licenser.

Använd det här kommandot för att hoppa över licenserna när du skapar en identitet.

Anmärkning

Om du inte har några licenser tillgängliga än använder du det här kommandot så att du inte blockeras. Du kan köra create-instance licenses när du har licenser.

a365 create-instance identity

create-instance licenses

Lägg till licenser till en befintlig agentanvändare.

Använd det här kommandot för att skapa licenser när identiteten redan finns.

Anmärkning

Om du använde create-instance identity tidigare använder du det här kommandot när licenser är tillgängliga.

a365 create-instance licenses

Använd dessa kommandon tillsammans med create-instance för att hantera hela livscykeln för din agent.

  • Last updated on