pfazure#

Experimentelles Feature

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

Verwalten Sie Prompt-Flow-Ressourcen auf Azure mit der Prompt-Flow-CLI.

Befehl

Beschreibung

pfazure flow

Flows verwalten.

pfazure run

Läufe verwalten.

pfazure flow#

Flows verwalten.

Befehl

Beschreibung

pfazure flow create

Einen Flow erstellen.

pfazure flow update

Einen Flow aktualisieren.

pfazure flow list

Flows in einem Workspace auflisten.

pfazure flow create#

Erstellen Sie einen Flow in Azure AI aus einem lokalen Flow-Ordner.

pfazure flow create [--flow]
                    [--set]
                    [--subscription]
                    [--resource-group]
                    [--workspace-name]

Parameter#

--flow

Lokaler Pfad zum Flow-Verzeichnis.

--set

Aktualisieren Sie ein Objekt, indem Sie einen Eigenschaftspfad und einen Wert angeben, der gesetzt werden soll.

  • display_name: Anzeigename des Flows, der remote erstellt wird. Standardmäßig ist dies der Name des Flow-Ordners plus ein Zeitstempel, falls nicht angegeben. z.B. „–set display_name=<display_name>“.

  • type: Flow-Typ. Standardmäßig „standard“, falls nicht angegeben. Verfügbare Typen sind: „standard“, „evaluation“, „chat“. z.B. „–set type=<type>“.

  • description: Flow-Beschreibung. z.B. „–set description=<description>.“

  • tags: Flow-Tags. z.B. „–set tags.key1=value1 tags.key2=value2.“

--subscription

Abonnement-ID, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--resource-group -g

Name der Ressourcengruppe, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--workspace-name -w

Name des Workspaces, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

pfazure flow update#

Aktualisieren Sie die Metadaten eines Flows, z. B. display name, description und tags.

pfazure flow update --flow
                    [--set]
                    [--subscription]
                    [--resource-group]
                    [--workspace-name]

Parameter#

--flow

Der Flow-Name auf Azure. Dies ist eine GUID, die auf zwei Arten gefunden werden kann

  • Nachdem ein Flow nach Azure hochgeladen wurde, kann er in der ausgegebenen Nachricht im Attribut „name“ gefunden werden.

  • Öffnen Sie einen Flow im Azure-Portal, die GUID befindet sich in der URL. z.B. https://ml.azure.com/prompts/flow/{workspace-id}/{flow-name}/xxx

--set

Aktualisieren Sie ein Objekt, indem Sie einen Eigenschaftspfad und einen Wert angeben, der gesetzt werden soll.

  • display_name: Anzeigename des Flows. z.B. „–set display_name=<display_name>“.

  • description: Flow-Beschreibung. z.B. „–set description=<description>.“

  • tags: Flow-Tags. z.B. „–set tags.key1=value1 tags.key2=value2.“

--subscription

Abonnement-ID, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--resource-group -g

Name der Ressourcengruppe, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--workspace-name -w

Name des Workspaces, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

pfazure flow list#

Remote-Flows auf Azure AI auflisten.

pfazure flow list [--max-results]
                  [--include-others]
                  [--type]
                  [--output]
                  [--archived-only]
                  [--include-archived]
                  [--subscription]
                  [--resource-group]
                  [--workspace-name]
                  [--output]

Parameter#

--max-results -r

Maximale Anzahl der zurückzugebenden Ergebnisse. Standard ist 50, Obergrenze ist 100.

--include-others

Enthält Flows, die von anderen Besitzern erstellt wurden. Standardmäßig werden nur von anderen Benutzern erstellte Flows zurückgegeben.

--type

Flows nach Typ filtern. Verfügbare Typen sind: „standard“, „evaluation“, „chat“.

--archived-only

Nur archivierte Flows auflisten.

--include-archived

Archivierte und aktive Flows auflisten.

--output -o

Ausgabeformat. Zulässige Werte: json, table. Standard: json.

--subscription

Abonnement-ID, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--resource-group -g

Name der Ressourcengruppe, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--workspace-name -w

Name des Workspaces, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

pfazure run#

Prompt-Flow-Läufe verwalten.

Befehl

Beschreibung

pfazure run create

Einen Lauf erstellen.

pfazure run list

Läufe in einem Workspace auflisten.

pfazure run show

Details zu einem Lauf anzeigen.

pfazure run stream

Streamt Run-Protokolle an die Konsole.

pfazure run show-details

Details zu einem Lauf anzeigen.

pfazure run show-metrics

Laufmetriken anzeigen.

pfazure run visualize

Einen Lauf visualisieren.

pfazure run archive

Archiviert einen Run.

pfazure run restore

Einen Lauf wiederherstellen.

pfazure run update

Einen Lauf aktualisieren.

pfazure run download

Einen Lauf herunterladen.

pfazure run create#

Einen Lauf erstellen.

pfazure run create [--file]
                   [--flow]
                   [--data]
                   [--column-mapping]
                   [--run]
                   [--variant]
                   [--stream]
                   [--environment-variables]
                   [--connections]
                   [--resume-from] # require promptflow>=1.8.0
                   [--set]
                   [--subscription]
                   [--resource-group]
                   [--workspace-name]

Parameter#

--file -f

Lokaler Pfad zur YAML-Datei mit der Spezifikation des Prompt-Flow-Laufs; kann durch andere Parameter überschrieben werden. Referenzieren Sie hier für das YAML-Schema.

--flow

Die Flow-Quelle zum Erstellen des Laufs. Sie kann sein

  • Lokaler Pfad zum Flow-Verzeichnis.

    pfazure run create --flow <path-to-flow-directory> --data <path-to-data-file> --column-mapping <key-value-pair>

  • Der Flow-Name auf Azure mit dem Präfix azureml:. Der Flow-Name ist eine GUID, die auf zwei Arten gefunden werden kann

    • Nachdem ein Flow nach Azure hochgeladen wurde, kann er in der ausgegebenen Nachricht im Attribut „name“ gefunden werden.

    • Öffnen Sie einen Flow im Azure-Portal, die GUID befindet sich in der URL. z.B. https://ml.azure.com/prompts/flow/{workspace-id}/{flow-name}/xxx

    pfazure run create --flow azureml:<flow-name> --data <path-to-data-file> --column-mapping <key-value-pair>

--data

Lokaler Pfad zur Datendatei oder entfernte Daten. z.B. azureml:name:version.

--column-mapping

Spaltenzuordnung der Eingaben, verwenden Sie ${data.xx}, um auf Datenspalten zu verweisen, verwenden Sie ${run.inputs.xx}, um auf Daten der referenzierten Run-Spalten zu verweisen, und ${run.outputs.xx}, um auf Run-Ausgabespalten zu verweisen.

--run

Referenzierter Flow-Laufname. Sie können beispielsweise einen Bewertungsflow gegen einen vorhandenen Lauf ausführen. z.B. „pfazure run create –flow evaluation_flow_dir –run existing_bulk_run –column-mapping url=’${data.url}’“.

--variant

Knoten- & Variantenname im Format von ${node_name.variant_name}.

--stream -s

Gibt an, ob die Protokolle des Laufs zur Konsole gestreamt werden sollen. Standardwert: False

--environment-variables

Umgebungsvariablen, die durch Angabe eines Eigenschaftspfads und eines Werts gesetzt werden sollen. Beispiel: --environment-variable key1='${my_connection.api_key}' key2='value2'. Der Wert, der auf Verbindungskeys verweist, wird in den tatsächlichen Wert aufgelöst, und alle angegebenen Umgebungsvariablen werden in os.environ gesetzt.

--connections

Überschreiben Sie Verbindungen auf Knotenebene mit dem bereitgestellten Wert. Beispiel: --connections node1.connection=test_llm_connection node1.deployment_name=gpt-35-turbo

--resume-from

Erstellen Sie einen Lauf, der von einem vorhandenen Lauf fortgesetzt wird. (Erfordert promptflow>=1.8.0) Beispiel: --resume-from <run_name>

--set

Aktualisieren Sie ein Objekt, indem Sie einen Eigenschaftspfad und einen Wert angeben, der gesetzt werden soll. Beispiel: --set property1.property2=<value>.

--subscription

Abonnement-ID, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--resource-group -g

Name der Ressourcengruppe, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--workspace-name -w

Name des Workspaces, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

pfazure run list#

Läufe in einem Workspace auflisten.

pfazure run list [--archived-only]
                 [--include-archived]
                 [--max-results]
                 [--subscription]
                 [--resource-group]
                 [--workspace-name]

Parameter#

--archived-only

Nur archivierte Läufe auflisten. Standardwert: False

--include-archived

Archivierte und aktive Läufe auflisten. Standardwert: False

--max-results -r

Maximale Anzahl der zurückzugebenden Ergebnisse. Standard ist 50, Obergrenze ist 100. Standardwert: 50

--subscription

Abonnement-ID, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--resource-group -g

Name der Ressourcengruppe, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--workspace-name -w

Name des Workspaces, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

pfazure run show#

Details zu einem Lauf anzeigen.

pfazure run show --name
                 [--subscription]
                 [--resource-group]
                 [--workspace-name]

Parameter#

--name -n

Name des Laufs.

--subscription

Abonnement-ID, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--resource-group -g

Name der Ressourcengruppe, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--workspace-name -w

Name des Workspaces, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

pfazure run stream#

Streamt Run-Protokolle an die Konsole.

pfazure run stream --name
                   [--timeout]
                   [--subscription]
                   [--resource-group]
                   [--workspace-name]

Parameter#

--name -n

Name des Laufs.

--timeout

Timeout in Sekunden. Wenn der Lauf im selben Status verbleibt und länger als der Timeout-Wert keine neuen Protokolle erzeugt, wird die Stream-Operation abgebrochen. Standardwert ist 600 Sekunden

--subscription

Abonnement-ID, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--resource-group -g

Name der Ressourcengruppe, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--workspace-name -w

Name des Workspaces, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

pfazure run show-details#

Details zu einem Lauf anzeigen.

pfazure run show-details --name
                         [--subscription]
                         [--resource-group]
                         [--workspace-name]

Parameter#

--name -n

Name des Laufs.

--subscription

Abonnement-ID, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--resource-group -g

Name der Ressourcengruppe, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--workspace-name -w

Name des Workspaces, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

pfazure run show-metrics#

Laufmetriken anzeigen.

pfazure run show-metrics --name
                         [--subscription]
                         [--resource-group]
                         [--workspace-name]

Parameter#

--name -n

Name des Laufs.

--subscription

Abonnement-ID, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--resource-group -g

Name der Ressourcengruppe, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--workspace-name -w

Name des Workspaces, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

pfazure run visualize#

Einen Lauf visualisieren.

pfazure run visualize --name
                      [--subscription]
                      [--resource-group]
                      [--workspace-name]

Parameter#

--name -n

Name des Laufs.

--subscription

Abonnement-ID, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--resource-group -g

Name der Ressourcengruppe, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--workspace-name -w

Name des Workspaces, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

pfazure run archive#

Archiviert einen Run.

pfazure run archive --name
                    [--subscription]
                    [--resource-group]
                    [--workspace-name]

Parameter#

--name -n

Name des Laufs.

--subscription

Abonnement-ID, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--resource-group -g

Name der Ressourcengruppe, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--workspace-name -w

Name des Workspaces, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

pfazure run restore#

Einen Lauf wiederherstellen.

pfazure run restore --name
                    [--subscription]
                    [--resource-group]
                    [--workspace-name]

Parameter#

--name -n

Name des Laufs.

--subscription

Abonnement-ID, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--resource-group -g

Name der Ressourcengruppe, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--workspace-name -w

Name des Workspaces, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

pfazure run update#

Aktualisieren Sie die Metadaten eines Laufs, z. B. display name, description und tags.

pfazure run update --name
                    [--set display_name="<value>" description="<value>" tags.key="<value>"]
                    [--subscription]
                    [--resource-group]
                    [--workspace-name]

Beispiele#

Setzen von display name, description und tags

pfazure run update --name <run_name> --set display_name="<value>" description="<value>" tags.key="<value>"

Parameter#

--name -n

Name des Laufs.

--set

Metainformationen des Laufs setzen, wie z.B. display_name, description oder tags. Beispiel: –set=.

--subscription

Abonnement-ID, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--resource-group -g

Name der Ressourcengruppe, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--workspace-name -w

Name des Workspaces, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

pfazure run download#

Laden Sie Metadaten eines Laufs herunter, wie z.B. input, output, snapshot und artifact. Nach Abschluss des Downloads können Sie pf run create --source <run-info-local-folder> verwenden, um diesen Lauf als lokale Laufaufzeichnung zu registrieren. Anschließend können Sie Befehle wie pf run show/visualize verwenden, um den Lauf wie einen von einem lokalen Flow erstellten Lauf zu inspizieren.

pfazure run download --name
                    [--output]
                    [--overwrite]
                    [--subscription]
                    [--resource-group]
                    [--workspace-name]

Beispiele#

Laufdaten lokal herunterladen

pfazure run download --name <name> --output <output-folder-path>

Parameter#

--name -n

Name des Laufs.

--output -o

Ausgabeordnerpfad zum Speichern der heruntergeladenen Laufdaten. Standardmäßig ~/.promptflow/.runs, falls nicht angegeben.

--overwrite

Vorhandene Laufdaten überschreiben, wenn der Ausgabeordner bereits existiert. Standardmäßig False, falls nicht angegeben.

--subscription

Abonnement-ID, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--resource-group -g

Name der Ressourcengruppe, erforderlich, wenn kein Standardwert von az configure vorhanden ist.

--workspace-name -w

Name des Workspaces, erforderlich, wenn kein Standardwert von az configure vorhanden ist.