Spaltenzuordnung verwenden#

In diesem Dokument wird erläutert, wie Eingaben mit Spaltenzuordnung beim Ausführen eines Flows zugeordnet werden.

Einführung in die Spaltenzuordnung#

Die Spaltenzuordnung ist eine Zuordnung von Flow-Eingabenamen zu bestimmten Werten. Wenn sie angegeben ist, wird der Flow mit dem bereitgestellten Wert für die angegebenen Eingaben ausgeführt. Die folgenden Arten von Werten in der Spaltenzuordnung werden unterstützt:

${data.<column_name>}, um aus Ihrem Testdatensatz zu referenzieren.
${run.inputs.<input_name>}, um von der Eingabe eines referenzierten Durchlaufs zu referenzieren. Hinweis: Dies wird nur unterstützt, wenn --run für pf run angegeben ist.
${run.outputs.<output_name>}, um von der Ausgabe eines referenzierten Durchlaufs zu referenzieren. Hinweis: Dies wird nur unterstützt, wenn --run für pf run angegeben ist.
STATIC_VALUE, um einen statischen Wert für alle Zeilen für die angegebene Spalte zu erstellen.

Priorität der Überschreibung von Flow-Eingaben#

Die Werte der Flow-Eingaben werden gemäß der folgenden Priorität überschrieben:

„in Spaltenzuordnung angegeben“ > „Standardwert“ > „Spalte mit gleichem Namen in bereitgestellten Daten“.

Wenn wir beispielsweise einen Flow mit den folgenden Eingaben haben:

inputs:
  input1:
    type: string
    default: "default_val1"
  input2:
    type: string
    default: "default_val2"
  input3:
    type: string
  input4:
    type: string
...

Und der Flow gibt jede Eingabe in den Ausgaben zurück.

Mit den folgenden Daten:

{"input3": "val3_in_data", "input4": "val4_in_data"}

Und verwenden Sie das folgende YAML zum Ausführen:

$schema: https://azuremlschemas.azureedge.net/promptflow/latest/Run.schema.json
flow: path/to/flow
# my_flow has default value val2 for key2
data: path/to/data
# my_data has column key3 with value val3
column_mapping:
    input1: "val1_in_column_mapping"
    input3: ${data.input3}

Da der Flow jede Eingabe in der Ausgabe zurückgibt, können wir die tatsächlichen Eingaben aus dem Feld outputs.output in den Ausführungsdetails abrufen.

column_mapping_details

Die Eingabe „input1“ hat den Wert „val1_in_column_mapping“, da sie als Konstante in der column_mapping angegeben ist.
Die Eingabe „input2“ hat den Wert „default_val2“, da sie den Standardwert im Flow-DAG verwendet.
Die Eingabe „input3“ hat den Wert „val3_in_data“, da sie als Datenreferenz in der column_mapping angegeben ist.
Die Eingabe „input4“ hat den Wert „val4_in_data“, da sie eine Spalte mit demselben Namen in den bereitgestellten Daten enthält.