Freigeben über

Agent 365 CLI-Befehlsreferenz create-instance

Von Bedeutung

Sie müssen Teil des vorschauprogramms Frontier sein, um early access zu Microsoft Agent 365 zu erhalten. Frontier verbindet Sie direkt mit den neuesten KI-Innovationen von Microsoft. Frontier-Vorschauen unterliegen den bestehenden Vorschaubedingungen Ihrer Kundenverträge. Da diese Funktionen noch in Entwicklung sind, können sich ihre Verfügbarkeit und Fähigkeiten im Laufe der Zeit ändern.

Erstellen Sie Agent-Identität und Agent-Benutzer, und fügen Sie dem Benutzer Berechtigungen für die Identität und Lizenzen hinzu. Der create-instance Befehl erstellt Agentinstanzen mit Identitäten, Lizenzen und erforderlichen Berechtigungen. Verwenden Sie diesen Befehl, um vollständige Agentinstanzen einzurichten, einschließlich der Erstellung der Agent-Identität, dem Zuweisen der erforderlichen Lizenzen und dem Erteilen von Berechtigungen für die Identität.

Der create-instance Befehl führt die folgenden Vorgänge aus:

  1. Creates Agent Identity – Registriert einen Agent-Identitätsdienstprinzipal im Microsoft Entra über die Graph-API.
  2. Erstellt agent-Benutzer – Erstellt ein Agent-Benutzerkonto, das der Identität zugeordnet ist.
  3. Weist Manager und Sponsor zu – Legt den aktuellen Benutzer als Vorgesetzter und Sponsor des Agent-Benutzers und der Identität fest.
  4. Weist Lizenzen zu – Weist dem Agent-Benutzer die erforderlichen Agent 365-Lizenzen zu.

Mindestrolle erforderlich: Globaler Administrator

Hinweis

Wenn Sie noch nicht über die erforderlichen Agent 365-Lizenzen verfügen, können Sie die Verwendung fortsetzen create-instance identity und anschließend verwenden create-instance licenses , um die Lizenzen zuzuweisen, wenn Sie sie besitzen.

Syntax

Im Folgenden finden Sie die Syntax für den create-instance Befehl und die optionalen Unterbefehle.

a365 create-instance [command] [options]

Wenn Sie ohne einen Unterbefehl ausführen create-instance , werden beide Schritte sequenziert: Er erstellt die Agent-Identität und den Agent-Benutzer und weist dann Lizenzen zu.

Options

Verwenden Sie diese Optionen mit dem Befehl oder den create-instancecreate-instance identity Unterbefehlen.create-instance licenses

Option Description
-c, --config <config> Konfigurationsdateipfad (Standard: a365.config.json)
-v, --verbose Detaillierte Ausgabe anzeigen
--dry-run Zeigen Sie an, was ohne Ausführung geschehen würde.
-?, -h--help Anzeigen von Hilfe- und Nutzungsinformationen

Voraussetzungen

Stellen Sie vor der Ausführung create-instancesicher, dass Sie:

  • Abgeschlossen den Setup-Agent-Blueprintschritt (a365 setup).
  • Ihr Agent mithilfe von a365 publish.
  • Sie verfügen über ein gültiges a365.config.json Und a365.generated.config.json in Ihrem Arbeitsverzeichnis.
  • Angemeldet mit einem Konto mit globalen Administratorberechtigungen.

Beispiele für create-instance

In diesen Beispielen wird gezeigt, wie Sie den create-instance Befehl ohne Unterbefehle verwenden.

Erstellen einer vollständigen Agent-Instanz

Führen Sie create-instance ohne Optionen aus, um eine vollständige Agentinstanz mithilfe der Standardkonfiguration zu erstellen.

a365 create-instance

Erstellen mit einer bestimmten Konfigurationsdatei

Verwenden Sie die --config Option, um einen benutzerdefinierten Konfigurationsdateipfad anzugeben.

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

Vorschau der Änderungen

Verwenden Sie die --dry-run Option, um zu sehen, was create-instance ohne Änderungen zu tun wäre.

a365 create-instance --dry-run

create-instance identity

Erstellen Sie Agent-Identität und Agent-Benutzer, weisen Sie jedoch keine Lizenzen zu.

Verwenden Sie diesen Befehl, um die Lizenzen beim Erstellen einer Identität zu überspringen.

Hinweis

Wenn Sie noch keine Lizenzen zur Verfügung haben, verwenden Sie diesen Befehl, damit Sie nicht blockiert werden. Sie können ausführen create-instance licenses , wenn Sie über Lizenzen verfügen.

a365 create-instance identity

create-instance licenses

Hinzufügen von Lizenzen zu einem vorhandenen Agent-Benutzer.

Verwenden Sie diesen Befehl, um die Lizenzen zu erstellen, wenn die Identität bereits vorhanden ist.

Hinweis

Wenn Sie zuvor verwendet haben create-instance identity , verwenden Sie diesen Befehl, wenn Lizenzen verfügbar sind.

a365 create-instance licenses

Verwenden Sie diese Befehle zusammen mit create-instance der Verwaltung des vollständigen Lebenszyklus Ihres Agents.

  • Last updated on