pfazure#
Experimental feature
This is an experimental feature, and may change at any time. Learn more.
Manage prompt flow resources on Azure with the prompt flow CLI.
Command |
Description |
|---|---|
Manage flows. |
|
Manage runs. |
pfazure flow#
Manage flows.
Command |
Description |
|---|---|
Create a flow. |
|
List flows in a workspace. |
pfazure flow create#
Create a flow in Azure AI from a local flow folder.
pfazure flow create [--flow]
[--set]
[--subscription]
[--resource-group]
[--workspace-name]
Parameters#
--flow
Local path to the flow directory.
--set
Update an object by specifying a property path and value to set.
display-name: Flow display name that will be created in remote. Default to be flow folder name + timestamp if not specified.type: Flow type. Default to be “standard” if not specified. Available types are: “standard”, “evaluation”, “chat”.description: Flow description. e.g. “–set description=<description>.”tags: Flow tags. e.g. “–set tags.key1=value1 tags.key2=value2.”
--subscription
Subscription id, required when there is no default value from az configure.
--resource-group -g
Resource group name, required when there is no default value from az configure.
--workspace-name -w
Workspace name, required when there is no default value from az configure.
pfazure flow list#
List remote flows on Azure AI.
pfazure flow list [--max-results]
[--include-others]
[--type]
[--output]
[--archived-only]
[--include-archived]
[--subscription]
[--resource-group]
[--workspace-name]
[--output]
Parameters#
--max-results -r
Max number of results to return. Default is 50, upper bound is 100.
--include-others
Include flows created by other owners. By default only flows created by the current user are returned.
--type
Filter flows by type. Available types are: “standard”, “evaluation”, “chat”.
--archived-only
List archived flows only.
--include-archived
List archived flows and active flows.
--output -o
Output format. Allowed values: json, table. Default: json.
--subscription
Subscription id, required when there is no default value from az configure.
--resource-group -g
Resource group name, required when there is no default value from az configure.
--workspace-name -w
Workspace name, required when there is no default value from az configure.
pfazure run#
Manage prompt flow runs.
Command |
Description |
|---|---|
Create a run. |
|
List runs in a workspace. |
|
Show details for a run. |
|
Stream run logs to the console. |
|
Show a run details. |
|
Show run metrics. |
|
Visualize a run. |
|
Archive a run. |
|
Restore a run. |
|
Update a run. |
pfazure run create#
Create a run.
pfazure run create [--file]
[--flow]
[--data]
[--column-mapping]
[--run]
[--variant]
[--stream]
[--environment-variables]
[--connections]
[--set]
[--subscription]
[--resource-group]
[--workspace-name]
Parameters#
--file -f
Local path to the YAML file containing the prompt flow run specification; can be overwritten by other parameters. Reference here for YAML schema.
--flow
Local path to the flow directory.
--data
Local path to the data file or remote data. e.g. azureml:name:version.
--column-mapping
Inputs column mapping, use ${data.xx} to refer to data columns, use ${run.inputs.xx} to refer to referenced run’s data columns, and ${run.outputs.xx} to refer to run outputs columns.
--run
Referenced flow run name. For example, you can run an evaluation flow against an existing run. For example, “pfazure run create –flow evaluation_flow_dir –run existing_bulk_run –column-mapping url=’${data.url}’”.
--variant
Node & variant name in format of ${node_name.variant_name}.
--stream -s
Indicates whether to stream the run’s logs to the console.
default value: False
--environment-variables
Environment variables to set by specifying a property path and value. Example:
--environment-variable key1='${my_connection.api_key}' key2='value2'. The value reference
to connection keys will be resolved to the actual value, and all environment variables
specified will be set into os.environ.
--connections
Overwrite node level connections with provided value.
Example: --connections node1.connection=test_llm_connection node1.deployment_name=gpt-35-turbo
--set
Update an object by specifying a property path and value to set.
Example: --set property1.property2=<value>.
--subscription
Subscription id, required when there is no default value from az configure.
--resource-group -g
Resource group name, required when there is no default value from az configure.
--workspace-name -w
Workspace name, required when there is no default value from az configure.
pfazure run list#
List runs in a workspace.
pfazure run list [--archived-only]
[--include-archived]
[--max-results]
[--subscription]
[--resource-group]
[--workspace-name]
Parameters#
--archived-only
List archived runs only.
default value: False
--include-archived
List archived runs and active runs.
default value: False
--max-results -r
Max number of results to return. Default is 50, upper bound is 100.
default value: 50
--subscription
Subscription id, required when there is no default value from az configure.
--resource-group -g
Resource group name, required when there is no default value from az configure.
--workspace-name -w
Workspace name, required when there is no default value from az configure.
pfazure run show#
Show details for a run.
pfazure run show --name
[--subscription]
[--resource-group]
[--workspace-name]
Parameters#
--name -n
Name of the run.
--subscription
Subscription id, required when there is no default value from az configure.
--resource-group -g
Resource group name, required when there is no default value from az configure.
--workspace-name -w
Workspace name, required when there is no default value from az configure.
pfazure run stream#
Stream run logs to the console.
pfazure run stream --name
[--subscription]
[--resource-group]
[--workspace-name]
Parameters#
--name -n
Name of the run.
--subscription
Subscription id, required when there is no default value from az configure.
--resource-group -g
Resource group name, required when there is no default value from az configure.
--workspace-name -w
Workspace name, required when there is no default value from az configure.
pfazure run show-details#
Show a run details.
pfazure run show-details --name
[--subscription]
[--resource-group]
[--workspace-name]
Parameters#
--name -n
Name of the run.
--subscription
Subscription id, required when there is no default value from az configure.
--resource-group -g
Resource group name, required when there is no default value from az configure.
--workspace-name -w
Workspace name, required when there is no default value from az configure.
pfazure run show-metrics#
Show run metrics.
pfazure run show-metrics --name
[--subscription]
[--resource-group]
[--workspace-name]
Parameters#
--name -n
Name of the run.
--subscription
Subscription id, required when there is no default value from az configure.
--resource-group -g
Resource group name, required when there is no default value from az configure.
--workspace-name -w
Workspace name, required when there is no default value from az configure.
pfazure run visualize#
Visualize a run.
pfazure run visualize --name
[--subscription]
[--resource-group]
[--workspace-name]
Parameters#
--name -n
Name of the run.
--subscription
Subscription id, required when there is no default value from az configure.
--resource-group -g
Resource group name, required when there is no default value from az configure.
--workspace-name -w
Workspace name, required when there is no default value from az configure.
pfazure run archive#
Archive a run.
pfazure run archive --name
[--subscription]
[--resource-group]
[--workspace-name]
Parameters#
--name -n
Name of the run.
--subscription
Subscription id, required when there is no default value from az configure.
--resource-group -g
Resource group name, required when there is no default value from az configure.
--workspace-name -w
Workspace name, required when there is no default value from az configure.
pfazure run restore#
Restore a run.
pfazure run restore --name
[--subscription]
[--resource-group]
[--workspace-name]
Parameters#
--name -n
Name of the run.
--subscription
Subscription id, required when there is no default value from az configure.
--resource-group -g
Resource group name, required when there is no default value from az configure.
--workspace-name -w
Workspace name, required when there is no default value from az configure.
pfazure run update#
Update a run’s metadata, such as display name, description and tags.
pfazure run update --name
[--set display_name="<value>" description="<value>" tags.key="<value>"]
[--subscription]
[--resource-group]
[--workspace-name]
Examples#
Set display name, description and tags:
pfazure run update --name <run_name> --set display_name="<value>" description="<value>" tags.key="<value>"
Parameters#
--name -n
Name of the run.
--set
Set meta information of the run, like display_name, description or tags. Example: –set
--subscription
Subscription id, required when there is no default value from az configure.
--resource-group -g
Resource group name, required when there is no default value from az configure.
--workspace-name -w
Workspace name, required when there is no default value from az configure.