Manage workflow artifacts and data lineage¶
Query the links between artifacts, files, and processing nodes; inspect output blocks and their revisions; and switch revisions or rerun processing nodes when needed. This page does not start or resume an entire workflow job; see Run, resume, and retry workflow jobs for those operations.
Prerequisites¶
Prepare credentials that can access the target workspace and the IDs of the artifact, file, or processing node to trace. For service endpoints, authentication, and general request formats, see Make your first AI Studio API call.
Before creating a revision, setting an effective revision, or rerunning a node, query the relevant lineage, node, output blocks, and revisions to confirm the target object.
Call sequence¶
Start with an artifact or file to query its processing lineage and locate the node to inspect.
Query node details and the artifact or node output blocks and revision records to confirm the output to inspect or adjust.
Create an output-block revision when you need to retain a new version; set an effective revision when you need to change the revision in use.
Rerun the node with its current configuration or specified revisions when needed, then query the lineage and output blocks again to confirm the result.
API operations¶
Query lineage and nodes¶
Task |
Use it when |
|---|---|
You need to trace processing from an artifact. |
|
You need to trace processing from a file. |
|
You located a node and need its details. |
Inspect and revise output blocks¶
Task |
Use it when |
|---|---|
You need to inspect output blocks associated with an artifact. |
|
You need to inspect output blocks for a specified node. |
|
You need to inspect existing output-block revisions. |
|
You need to inspect revisions for a node output block. |
|
You need to add a revision for an output block. |
|
You need to add a revision for a node output block. |
|
You need to switch the revision used by an artifact. |
|
You need to switch the revision used by a node. |
Rerun nodes¶
Task |
Use it when |
|---|---|
You need to reprocess a node using its current configuration. |
|
You need to reprocess a node with selected revisions. |
Confirm the result¶
After creating or switching a revision, query the corresponding output blocks and revision records to confirm current content. After rerunning a node, query artifact lineage or processing-node details again to confirm node information.
Limitations and notes¶
Revisions, nodes, and artifacts are objects at different levels. Before switching or rerunning, use lineage and node details to confirm the target level.
Setting an effective revision and rerunning affect the output used later. Check the relevant operation page for conditions and scope first.