Run Components in Isolation

Run individual components independently in Pipeline Builder to test, debug, and validate them before deploying your full pipeline.

About This Task

In Pipeline Builder, you can run components in isolation to test them without deploying the entire pipeline or index. Running a single component helps you:

  • Verify its configuration and parameters.
  • Validate input and output formats.
  • Identify issues in the configuration.
  • Understand how it processes data.
  • Experiment with different settings.

This saves time by letting you validate components early, before deploying a full pipeline or index.

Documents as Input

When you run an individual component, Pipeline Builder automatically fills in its input, except for components that require documents. For these, the input defaults to an empty array.

To use real documents, first run a component that retrieves them (for example, a Retriever), and then click Run Next to use the retrieved documents as an input for the next component.

All input must be valid JSON.

Run a Single Component

You can run a component that's already a part of a pipeline or you can drag and drop a single component on the canvas and run it there.

  1. Choose how to run a component:

    • To run a standalone component:
      1. Go to Pipelines>Create Pipeline>Create empty pipeline.
      2. Give your pipeline a name and click Create Pipeline.
      3. In Component Library, find the component you want to run and drag it onto the canvas.
      4. Click the component card to view additional actions.
    • To run a component that's part of a pipeline:
      1. Go to Pipelines, find the pipeline containing the component, and click More Actions>Edit. This opens Pipeline Builder.
      2. Find the component to run and click its card to view additional actions.
  2. Click Run. This opens a window with the component input automatically filled in (except for components that take documents). You can edit the input and format it with the Format button.

    The component run option displayed above the component card
  3. Click Run Component. After the component runs, its output is displayed so you can verify the result. If the component is part of a pipeline, you can then click Run Next to run the next component in the pipeline.