dataspace_file_source_stop

Downloads a file from a Dataspace source as a DAG workflow input node.

539|171|Updated May 3, 2018
One-click install
npx skills add https://github.com/cas-bigdatalab/piflow --skill dataspace-file-source-stop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dataspace_file_source_stop
Source: https://github.com/cas-bigdatalab/piflow/tree/main/workspace/skills/dataspace_file_source_stop
Command: npx skills add https://github.com/cas-bigdatalab/piflow --skill dataspace-file-source-stop

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Workflow pipelines often need files stored in a Dataspace as their starting input, but manually downloading and staging those files before running a DAG is repetitive and error-prone. This Skill acts as the entry node of a pipeline, fetching a single file from a Dataspace data source instance and exposing it as a local output for downstream operators.

Core Features & Use Cases

  • Dataspace File Download: Retrieves a file from a Dataspace data source instance using its datasource ID and in-space file path.
  • DAG Start Node: Runs with no upstream input, making it the designated starting operator of a workflow graph.
  • Downstream Output Slot: Writes the downloaded file to a local path and exposes it as an output reference for subsequent operators.
  • Use Case: A research data pipeline needs a CSV dataset hosted in a Dataspace. Use this Skill as the first node to download the file locally, then feed it into downstream cleaning, transformation, or analysis operators.

Quick Start

Ask the agent to download a file from a Dataspace data source by providing the datasource ID, the file path inside the space, and a local output path as the first node of the workflow.

Frequently Asked Questions about dataspace_file_source_stop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use a Dataspace file as input to a workflow DAG?

Use this operator as the starting node of the DAG. Provide the Dataspace datasource instance ID, the file path inside the space, and a local output path; the downloaded file is exposed as an output slot for downstream nodes.

What parameters does the Dataspace file source operator require?

It requires three parameters: datasource_id (the Dataspace data source instance ID), input_file_path (the file path within the space, optionally starting with /), and output (the local path where the downloaded file is written).

Can this operator run in the middle of a DAG pipeline?

No. It has no upstream input and is designed to be the starting node of a DAG. It only fetches a file from Dataspace and passes it downstream, so it must be placed at the beginning of the workflow.

Why does the Dataspace file download fail with an empty path error?

The script strips leading slashes from input_file_path and raises an error if the result is empty. Ensure the path points to an actual file inside the Dataspace space, not just a root slash or blank string.

What happens to the downloaded file after the operator runs?

The file is first downloaded into a temporary directory, then copied to the specified output path. The output path is returned as a reference so downstream operators can consume the local file.