Promptflow Konfigurationen festlegen

Experimentelles Feature

Dies ist eine experimentelle Funktion und kann sich jederzeit ändern. Erfahren Sie mehr.

Promptflow unterstützt die Festlegung globaler Konfigurationen, um zu vermeiden, dass dieselben Parameter an jeden Befehl übergeben werden. Die globalen Konfigurationen werden in einer YAML-Datei gespeichert, die sich standardmäßig unter ~/.promptflow/pf.yaml befindet.

Zusätzlich unterstützt Promptflow das Festlegen von Konfigurationen für einen bestimmten Pfad. Diese Konfigurationen werden nur für das Promptflow-Programm wirksam, wenn das Arbeitsverzeichnis der angegebene Pfad oder dessen Unterverzeichnisse sind. Die Konfigurationen werden in einer YAML-Datei gespeichert, die sich unter <config_folder>/pf.yaml befindet.

Die Konfigurationsdatei wird zwischen der Promptflow-Erweiterung und dem SDK/CLI geteilt. Die Promptflow-Erweiterung steuert jede Konfiguration über die Benutzeroberfläche. Die folgenden Abschnitte zeigen daher, wie globale Konfigurationen mithilfe der Promptflow-CLI festgelegt werden.

Konfiguration festlegen

Globale Konfiguration festlegen

pf config set <config_name>=<config_value>

Zum Beispiel

pf config set connection.provider="azureml://subscriptions/<your-subscription>/resourceGroups/<your-resourcegroup>/providers/Microsoft.MachineLearningServices/workspaces/<your-workspace>"

Konfiguration für einen bestimmten Pfad festlegen

pf config set <config_name>=<config_value> --path <config_folder>

Zum Beispiel

pf config set connection.provider="azureml://subscriptions/<your-subscription>/resourceGroups/<your-resourcegroup>/providers/Microsoft.MachineLearningServices/workspaces/<your-workspace>" --path .

Konfiguration anzeigen

Der folgende Befehl ruft alle Konfigurationen ab und zeigt sie im JSON-Format an

pf config show

Nach Ausführung des obigen Befehls zum Festlegen der Konfiguration gibt der Befehl zum Anzeigen der Konfiguration das folgende Ergebnis zurück

{
  "connection": {
    "provider": "azureml://subscriptions/<your-subscription>/resourceGroups/<your-resourcegroup>/providers/Microsoft.MachineLearningServices/workspaces/<your-workspace>"
  }
}

Unterstützte Konfigurationen

connection.provider

Der Verbindungsanbieter, standardmäßig auf "local" gesetzt. Es gibt 3 mögliche Werte für den Anbieter.

local

Verbindungsanbieter auf "local" setzen mit connection.provider=local.

Verbindungen werden lokal gespeichert. PFClient (oder pf connection Befehle) werden lokale Verbindungen verwalten. Folglich wird der Flow mit diesen lokalen Verbindungen ausgeführt.

Vollständige Azure Machine Learning Workspace-Ressourcen-ID

Verbindungsanbieter auf einen bestimmten Workspace setzen mit

connection.provider=azureml://subscriptions/<your-subscription>/resourceGroups/<your-resourcegroup>/providers/Microsoft.MachineLearningServices/workspaces/<your-workspace>

Wenn Verbindungen mit get oder list abgerufen werden, gibt PFClient (oder pf connection Befehle) Workspace-Verbindungen zurück, und der Flow wird mit diesen Workspace-Verbindungen ausgeführt. *Geheimnisse für Workspace-Verbindungen werden von diesen Befehlen nicht angezeigt, was bedeutet, dass Sie möglicherweise ein leeres Wörterbuch {} für benutzerdefinierte Verbindungen sehen.*

Hinweis

Die Befehle create, update und delete werden für Workspace-Verbindungen nicht unterstützt. Bitte verwalten Sie diese im Workspace-Portal, Azure AI Studio, az ml cli oder azure-ai-ml sdk.

azureml

Zusätzlich zur vollständigen Ressourcen-ID können Sie den Verbindungsanbieter als "azureml" mit connection.provider=azureml festlegen. In diesem Fall versucht Promptflow, die Workspace-Konfiguration abzurufen, indem es .azureml/config.json aus dem aktuellen Verzeichnis und dann fortschreitend aus seinen übergeordneten Ordnern sucht. Daher ist es möglich, die Workspace-Konfiguration für verschiedene Flows festzulegen, indem die Konfigurationsdatei im Projektordner platziert wird.

Das erwartete Format der Konfigurationsdatei ist wie folgt

{
  "workspace_name": "<your-workspace-name>",
  "resource_group": "<your-resource-group>",
  "subscription_id": "<your-subscription-id>"
}

service.host

Der Host des Promptflow-Dienstes, standardmäßig auf "127.0.0.1" gesetzt. Sie können den Diensthost mit service.host=<your-host> festlegen.

Zum Beispiel

pf config set service.host="0.0.0.0"

💡 Tipps Zusätzlich zum Festlegen über die CLI-Befehlszeile unterstützen wir auch das Festlegen dieses Verbindungsanbieters über die Benutzeroberfläche der VS Code-Erweiterung. Klicken Sie hier, um mehr zu erfahren.