Freigeben über

Agent 365 CLI-Befehlsreferenz config

Von Bedeutung

Sie müssen Teil des Frontier-Vorschauversionsprogramms sein, um Vorabzugriff auf 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.

Verwalten der Agent 365 CLI-Konfiguration. Bietet Optionen zum Verwalten von Agent 365 CLI-Konfigurationseinstellungen. Sie können neue Konfigurationen interaktiv initialisieren oder aktuelle Konfigurationseinstellungen anzeigen.

Mindestrolle erforderlich: Keine (lokale Konfiguration)

Syntax

a365 config [command] [options]

Options

Option Description
-?, -h--help Zeigen Sie Hilfe- und Nutzungsinformationen an.

config init

Konfigurieren Sie Agent 365 CLI interaktiv, oder importieren Sie sie aus einer Datei.

a365 config init [options]

Verwenden Sie diesen Befehl, um Ihre Agent 365 CLI-Konfiguration über einen interaktiven Prozess einzurichten oder einstellungen aus einer vorhandenen Konfigurationsdatei zu importieren.

init-Optionen

Option Description
-c, --configfile <configfile> Pfad zu einer vorhandenen Konfigurationsdatei zum Importieren
-g, --global Erstellen einer Konfiguration im globalen Verzeichnis (AppData) anstelle des aktuellen Verzeichnisses
-?, -h--help Zeigen Sie Hilfe- und Nutzungsinformationen an.

Bemerkungen

Der config init Befehl startet einen interaktiven Assistenten, der manuelle Eingaben minimiert:

  • Azure CLI integration: Erkennt automatisch Ihr Abonnement, Ihren Mandanten, Ressourcengruppen, App-Servicepläne und Regionen.
  • Intelligente Standardwerte: Generiert Ressourcennamen aus Ihrem Agentnamen und einen Zeitstempel (z. B myagent-webapp-11140916. ). Sie können diese Namen vor dem Speichern anpassen.
  • Platform-Erkennung: Erkennt Den Projekttyp (.NET, Node.js, Python) aus dem Bereitstellungsprojektpfad und warnt, wenn kein unterstützter Typ gefunden wird.
  • Client-App-Validierung: Überprüft Ihre Client-App-ID für Ihren Entra-Mandanten, überprüfen Sie, ob erforderliche Berechtigungen konfiguriert sind und die Administratorzustimmung erteilt wird. Sie haben bis zu drei Versuche, bevor der Assistent beendet wird.

Custom Blueprint permissions (optional): Der Assistent enthält einen optionalen Schritt zum Konfigurieren von Berechtigungen für zusätzliche externe Ressourcen, z. B. Teams-Anwesenheits- oder OneDrive-Dateien. Für die meisten Agents ist dies nicht erforderlich. Sie können berechtigungen auch nach dem anfänglichen Setup mithilfe von a365 config permissions.

Aktualisieren vorhandener Konfiguration: Die aktuelle a365 config init Ausführung wird als Standard geladen a365.config.json . Drücken Sie die EINGABETASTE an jeder Eingabeaufforderung, um den aktuellen Wert beizubehalten, oder geben Sie einen neuen Wert ein, um ihn zu aktualisieren.

config display

Aktuelle Agent 365 CLI-Konfiguration anzeigen.

a365 config display [options]

Mit diesem Befehl werden die aktuellen Konfigurationseinstellungen für die Agent 365 CLI angezeigt, damit Sie Ihr aktuelles Setup überprüfen können.

display-Optionen

Option Description
-g, --generated Generierte Konfiguration anzeigen (a365.generated.config.json).
-a, --all Zeigt sowohl statische als auch generierte Konfiguration an.
-f, --field <field> Gibt den Wert eines einzelnen Felds aus (z. B.: --field messagingEndpoint).
-?, -h--help Zeigen Sie Hilfe- und Nutzungsinformationen an.

Bemerkungen

Dient --field zum Abrufen eines einzelnen Werts aus Ihrer Konfiguration für die Verwendung in Skripts oder anderen Befehlen. Wenn Sie diese Option mit -g oder -averwenden, durchsucht die CLI zuerst die generierte Konfiguration.

# Get the messaging endpoint from generated config
a365 config display -g --field messagingEndpoint

# Get a value from static config
a365 config display --field webAppName

Konfigurationsdateistruktur

Die CLI verwendet eine JSON-Konfigurationsdatei (a365.config.json) mit den folgenden Schlüsseleigenschaften:

{
  "$schema": "./a365.config.schema.json",
  "tenantId": "your-tenant-id",
  "subscriptionId": "your-subscription-id",
  "resourceGroup": "rg-Agent 365-example",
  "location": "westus",
  "appServicePlanName": "asp-Agent 365-example",
  "appServicePlanSku": "B1",
  "webAppName": "webapp-Agent 365-example",
  "agentBlueprintDisplayName": "My Agent 365 Blueprint",
  "agentIdentityDisplayName": "My Agent 365 Agent",
  "agentUserPrincipalName": "agent@contoso.onmicrosoft.com",
  "agentUserDisplayName": "My Agent 365 User",
  "managerEmail": "manager@contoso.onmicrosoft.com",
  "agentUserUsageLocation": "US",
  "agentIdentityScopes": [
    "User.Read",
    "Mail.Send",
    "Calendars.ReadWrite",
    "Files.ReadWrite"
  ],
  "agentApplicationScopes": [
    "Mail.ReadWrite",
    "Chat.ReadWrite",
    "Sites.Read.All"
  ],
  "deploymentProjectPath": ".",
  "deploymentProjectFile": "YourProject.csproj",
  "botName": "my-Agent 365-bot",
  "botDescription": "My AI-powered agent for Microsoft 365 tasks"
}
  • Last updated on