Agent 365 CLI-Befehlsreferenz develop

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 Sie MCP-Toolserver für die Agententwicklung. Der develop Befehl bietet Optionen zum Verwalten von MCP-Toolservern (Model Context Protocol) für die Agententwicklung. Sie können verfügbare Server auflisten, konfigurierte Server anzeigen und MCP-Server aus Ihrer Agentkonfiguration hinzufügen oder entfernen.

Minimale Rolle erforderlich: Keine (lokale Manifestverwaltung)

Syntax

a365 develop [command] [options]

Options

Option	Description
-c, --config <config>	Konfigurationsdateipfad. Standard: a365.config.json
-v, --verbose	Aktivieren der ausführlichen Protokollierung
-?, -h--help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

develop list-available

Auflisten aller MCP-Server, die im Katalog verfügbar sind (was Sie installieren können).

a365 develop list-available [options]

Dieser Befehl zeigt alle MCP-Server an, die im Katalog verfügbar sind, und Sie können sie für die Verwendung mit Ihrer Agent-Entwicklung installieren.

list-available-Optionen

Option	Description
-c, --config <config>	Konfigurationsdateipfad. Standard: a365.config.json
--dry-run	Zeigen Sie an, was der Befehl tun würde, ohne ihn auszuführen.
--skip-auth	Authentifizierung überspringen. Nur für Tests. Der Befehl schlägt wahrscheinlich ohne gültige Authentifizierung fehl.
-?, -h--help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

develop list-configured

Auflisten der derzeit konfigurierten MCP-Server von Ihrem lokalen ToolingManifest.json.

a365 develop list-configured [options]

Dieser Befehl zeigt alle MCP-Server an, die Sie derzeit in Ihrer lokalen ToolingManifest.json Datei konfiguriert haben.

list-configured-Optionen

Option	Description
-c, --config <config>	Konfigurationsdateipfad. Standard: a365.config.json
--dry-run	Zeigen Sie an, was der Befehl tun würde, ohne ihn auszuführen.
-?, -h--help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

develop add-mcp-servers

Fügen Sie MCP-Server zur aktuellen Agentkonfiguration hinzu.

a365 develop add-mcp-servers [<servers>...] [options]

Mit diesem Befehl werden die angegebenen MCP-Server ToolingManifest.json in Ihrem Projektordner hinzugefügt. Sie gewährt dem Agent-Blueprint keine Berechtigungen.It doesn't grant permissions to the agent blueprint.

Von Bedeutung

Dieser Befehl aktualisiert ToolingManifest.json nur – er gewährt keine Berechtigungen für den Agent-Blueprint. Wie Berechtigungen angewendet werden, hängt davon ab, wo Sie sich im Setupprozess befinden:

• Vor der ersteinrichtung: Fahren Sie mit a365 setup all. MCP-Berechtigungen werden als Teil der anfänglichen Blueprinterstellung angewendet.
• Nachdem der Blueprint bereits vorhanden ist: Ein globaler Administrator muss separat ausgeführt werden a365 setup permissions mcp . Der Administrator muss zuerst ausgeführt werden a365 config display , um zu überprüfen, ob deploymentProjectPath er in seinen a365.config.json Punkten auf den Projektordner mit dem aktualisierten ToolingManifest.jsonOrdner verweist.

add-mcp-servers-Argumente

Geben Sie einen oder mehrere MCP-Servernamen an, die Der Agentkonfiguration hinzugefügt werden sollen. Sie können mehrere Servernamen durch Leerzeichen getrennt angeben.

Argument	Description
<servers>	Namen der hinzuzufügenden MCP-Server

add-mcp-servers-Optionen

Verwenden Sie diese Optionen, um das Verhalten des add-mcp-servers Befehls anzupassen, einschließlich konfigurationsdateiauswahl und Trockenlauftests.

Option	Description
-c, --config <config>	Konfigurationsdateipfad. Standard: a365.config.json
--dry-run	Zeigen Sie an, was der Befehl tun würde, ohne ihn auszuführen.
-?, -h--help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

develop remove-mcp-servers

Entfernen Sie MCP-Server aus der aktuellen Agent-Konfiguration.

a365 develop remove-mcp-servers [<servers>...] [options]

Mit diesem Befehl werden angegebene MCP-Server aus der aktuellen Agent-Konfiguration entfernt.

remove-mcp-servers-Argumente

Argument	Description
<servers>	Namen der zu entfernenden MCP-Server

remove-mcp-servers-Optionen

Option	Description
-c, --config <config>	Konfigurationsdateipfad. Standard: a365.config.json
--dry-run	Zeigen Sie an, was der Befehl tun würde, ohne ihn auszuführen.
-?, -h--help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

develop add-permissions

Fügen Sie MCP-Server-API-Berechtigungen zu Microsoft Entra Anwendungen für Entwicklungsszenarien hinzu, in denen Sie benutzerdefinierte Anwendungen für den Zugriff auf MCP-Server konfigurieren müssen.

a365 develop add-permissions [options]

add-permissions-Optionen

Verwenden Sie diese Optionen, um Ihrer App-Registrierung erforderliche API-Berechtigungen und Bereiche hinzuzufügen und Werte aus dem Toolmanifest zu nutzen.

Option	Description
-c, --config <config>	Konfigurationsdateipfad (Standard: a365.config.json)
-m, --manifest <manifest>	Pfad zu ToolingManifest.json (Standard: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id>	Anwendungs-ID (Client) zum Hinzufügen von Berechtigungen (Standard: clientAppId von der Konfiguration)
--scopes <scopes>	Bestimmte Bereiche, die hinzugefügt werden sollen (leerzeichentrennt) (Standard: Alle Bereiche von ToolingManifest.json)
--dry-run	Anzeigen, was der Befehl tun würde, ohne Änderungen vorzunehmen
-v, --verbose	Detaillierte Ausgabe anzeigen
-?, -h--help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Von Bedeutung

Die von --app-id oder clientAppId angegebene Anwendung muss die Berechtigung Application.ReadWrite.All in Microsoft Entra besitzen. Dieser Befehl richtet sich an benutzerdefinierte Clientanwendungen. Um Berechtigungen für Agent-Blueprints zu konfigurieren, verwenden Sie a365 setup permissions mcp stattdessen.

develop get-token

Rufen Sie Bearertoken zum Testen von MCP-Servern während der Entwicklung mithilfe der interaktiven Browserauthentifizierung ab.

a365 develop get-token [options]

get-token-Optionen

Verwenden Sie diese Optionen, um ein Zugriffstoken, Steuerelementbereiche, Aktualisierungsverhalten anzufordern und das Ausgabeformat auszuwählen.

Option	Description
-c, --config <config>	Konfigurationsdateipfad (Standard: a365.config.json)
--app-id <app-id>	Anwendungs-ID (Client)-ID für die Authentifizierung (Standard: clientAppId from config)
-m, --manifest <manifest>	Pfad zu ToolingManifest.json (Standard: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes>	Bestimmte Bereiche, die angefordert werden sollen (durch Leerzeichen getrennt) (Standard: Lesen von ToolingManifest.json)
-o, --output <output>	Ausgabeformat: table, json, oder raw (Standard: table)
--force-refresh	Erzwingen der Tokenaktualisierungsumgehung des Caches
--resource <resource>	Ressourcenschlüsselwort zum Abrufen von Token für: mcp (Standard) oder powerplatform
--resource-id <resource-id>	Benutzerdefinierte Ressourcenanwendungs-ID (GUID) für Ressourcen, die nicht von --resource Schlüsselwörtern abgedeckt werden
-v, --verbose	Detaillierte Ausgabe anzeigen, einschließlich des vollständigen Tokens
-?, -h--help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

get-token Ressourcenoptionen

Verwenden Sie die Optionen --resource und --resource-id, um Token für verschiedene Azure-Ressourcen abzurufen:

• --resource: Verwenden Sie ein Schlüsselwort, um eine vordefinierte Ressource auszuwählen:
  • mcp (Standard): Agent 365-Tools für MCP-Server
  • powerplatform: Power Platform-API
• --resource-id: Geben Sie eine benutzerdefinierte Ressourcenanwendungs-ID (GUID) für Ressourcen ein, die nicht von Schlüsselwörtern abgedeckt werden

Von Bedeutung

--resource und --resource-id kann nicht zusammen verwendet werden. Wenn Sie eine der beiden Optionen verwenden, schließen --scopesSie diese ein. Nur der standardmäßige MCP-Fluss unterstützt manifestbasierte Bereichsauflösung.

develop start-mock-tooling-server

Starten Sie einen Simulierten Toolingserver zu Test- und Entwicklungszwecken.

a365 develop start-mock-tooling-server [options]

Mit diesem Befehl wird ein Simulierter Toolserver für Test- und Entwicklungszwecke gestartet. Mithilfe dieses Servers können Sie MCP-Serverinteraktionen simulieren, ohne dass tatsächliche Serverimplementierungen erforderlich sind.

start-mock-tooling-server-Optionen

Verwenden Sie diese Optionen, um das Verhalten des start-mock-tooling-server Befehls anzupassen.

Option	Description	Standard
-p, --port <port>	Portnummer für den Pseudoserver	5309
-v, --verbose	Aktivieren der ausführlichen Protokollierung	Falsch
-?, -h, --help	Anzeigen von Hilfe- und Nutzungsinformationen	-
-bg	Ausführen des Servers auf einem neuen Terminal	-