> ## Documentation Index
> Fetch the complete documentation index at: https://futureagi.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Run Prompt in Dataset

> Learn how to execute prompts against your dataset and generate responses

<Steps>
  <Step title="Navigate to Run Prompt">
    Click on the "Run Prompt" button in the top-right corner to begin creating a prompt.

    <img src="https://mintcdn.com/futureagi/_BWZpFx7YR35DSc4/screenshot/product/dataset/how-to/run-prompt-in-dataset/1.png?fit=max&auto=format&n=_BWZpFx7YR35DSc4&q=85&s=b54154ace1cdf4ab8307c0da981cef5b" alt="Run Prompt" width="3824" height="1712" data-path="screenshot/product/dataset/how-to/run-prompt-in-dataset/1.png" />

    <img src="https://mintcdn.com/futureagi/QcEFJkN22Gu7AqY5/screenshot/product/dataset/how-to/run-prompt-in-dataset/2.png?fit=max&auto=format&n=QcEFJkN22Gu7AqY5&q=85&s=5d48b30f0f2c23aef68a845c6a293c55" alt="Run Prompt" width="2856" height="1770" data-path="screenshot/product/dataset/how-to/run-prompt-in-dataset/2.png" />

    <img src="https://mintcdn.com/futureagi/QcEFJkN22Gu7AqY5/screenshot/product/dataset/how-to/run-prompt-in-dataset/3.png?fit=max&auto=format&n=QcEFJkN22Gu7AqY5&q=85&s=f9890388f67ede25acf5c0714a602873" alt="Run Prompt" width="1276" height="1776" data-path="screenshot/product/dataset/how-to/run-prompt-in-dataset/3.png" />
  </Step>

  <Step title="Assign Prompt Name">
    Assign a name to your prompt. This name will appear as a new <Tooltip tip="Dynamic columns are generated on-the-fly and contain data derived from other columns or external operations." cta="Learn more about dynamic columns" href="/future-agi/get-started/dataset/concept/dynamic-column">dynamic column</Tooltip> in your dataset.
  </Step>

  <Step title="Choose Model Type">
    Select the model type based on your use-case.

    <Tabs>
      <Tab title="LLM" icon="robot">
        Choose "LLM" to generate text responses using general-purpose LLM models. Recommended for everyday use-cases.

        <img src="https://mintcdn.com/futureagi/QcEFJkN22Gu7AqY5/screenshot/product/dataset/how-to/run-prompt-in-dataset/4.png?fit=max&auto=format&n=QcEFJkN22Gu7AqY5&q=85&s=9614151812367c6828196502f9377355" alt="LLM" width="1274" height="1060" data-path="screenshot/product/dataset/how-to/run-prompt-in-dataset/4.png" />

        <Tip>
          Click [here](/future-agi/get-started/evaluation/use-custom-models) to learn how to create custom models.
        </Tip>
      </Tab>

      <Tab title="Text-to-Speech" icon="microphone">
        <img src="https://mintcdn.com/futureagi/QcEFJkN22Gu7AqY5/screenshot/product/dataset/how-to/run-prompt-in-dataset/5.png?fit=max&auto=format&n=QcEFJkN22Gu7AqY5&q=85&s=a57ea4bbca159713d8dc33863a95861d" alt="Text-to-Speech" width="1278" height="1022" data-path="screenshot/product/dataset/how-to/run-prompt-in-dataset/5.png" />

        <Tip>
          Click [here](/future-agi/get-started/evaluation/use-custom-models) to learn how to create custom models.
        </Tip>
      </Tab>

      <Tab title="Speech-to-Text" icon="page">
        <img src="https://mintcdn.com/futureagi/QcEFJkN22Gu7AqY5/screenshot/product/dataset/how-to/run-prompt-in-dataset/6.png?fit=max&auto=format&n=QcEFJkN22Gu7AqY5&q=85&s=8f84ba15279239b3fa617996db0799ac" alt="Speech-to-Text" width="1278" height="554" data-path="screenshot/product/dataset/how-to/run-prompt-in-dataset/6.png" />

        <Tip>
          Click [here](/future-agi/get-started/evaluation/use-custom-models) to learn how to create custom models.
        </Tip>
      </Tab>

      <Tab title="Image Generation" icon="image">
        <img src="https://mintcdn.com/futureagi/QcEFJkN22Gu7AqY5/screenshot/product/dataset/how-to/run-prompt-in-dataset/7.png?fit=max&auto=format&n=QcEFJkN22Gu7AqY5&q=85&s=e16efa5ae18e865784912b52a9347b17" alt="Image Generation" width="1276" height="878" data-path="screenshot/product/dataset/how-to/run-prompt-in-dataset/7.png" />

        <video autoPlay muted loop playsInline className="w-full aspect-video rounded-xl" src="https://mintcdn.com/futureagi/QcEFJkN22Gu7AqY5/screenshot/product/dataset/how-to/run-prompt-in-dataset/image-generation-demo.mp4?fit=max&auto=format&n=QcEFJkN22Gu7AqY5&q=85&s=fc817aee0c707726d4c23b33c7c2c61d" data-path="screenshot/product/dataset/how-to/run-prompt-in-dataset/image-generation-demo.mp4" />
      </Tab>
    </Tabs>
  </Step>

  <Step title="Configure Prompt with Roles">
    Define your prompt using roles. You can configure messages with different roles:

    * **User Role (Required)**: The main input message from the user perspective. This role is required for the prompt to work.
    * **System Role (Optional)**: System-level instructions that guide the model's behavior and set the context.

    ### Using Variables

    You can reference dataset columns as variables within your prompt using the `{{ }}` syntax. Simply wrap the column name in double curly braces:

    **Basic Example:**

    ```
    System: You are a helpful assistant that summarizes content.

    User: Please summarize the following text: {{column_name}}
    ```

    The variables (column names) will be dynamically replaced with actual values from your dataset when the prompt runs.

    ### JSON Dot Notation

    For JSON type columns, you can access nested fields directly using dot notation. This allows you to reference specific keys within structured data without additional processing:

    **JSON Example:**

    ```
    User: Based on this prompt: {{column_name.key_name}}, generate a response that addresses {{column_name.key_name}}
    ```

    In this example:

    * `{{column_name.key_name}}` accesses the `key_name` field within the `column_name` JSON column

    This feature significantly simplifies complex data handling and speeds up setup when working with structured JSON data in your dataset.
  </Step>

  <Step title="Configure Model Parameters (optional)">
    Adjust model parameters such as temperature, max tokens, top\_p, and other settings to fine-tune the model's behavior according to your needs.
  </Step>

  <Step title="Configure Tools (optional)">
    Add tools or functions that the model can use during execution. This enables the model to perform specific actions or access external capabilities.
  </Step>

  <Step title="Configure Concurrency">
    Set the concurrency level to control how many prompt executions run in parallel. Higher concurrency speeds up processing but may consume more resources.
  </Step>

  <Step title="Run Prompt">
    Click the "Run" button to execute the prompt across your dataset. The responses will be generated and saved as a new dynamic column in your dataset.
  </Step>
</Steps>
