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

# Prompt Builder

> Create agent workflows using natural language

<Note>
  The Prompt Builder is currently in **Beta**. It generates Agent Composer
  workflows from natural language descriptions.
</Note>

## Overview

The Prompt Builder lets you describe what you want your agent to do in
plain language, and it generates the workflow configuration automatically.
Instead of building nodes manually or writing YAML, you describe your use
case and the system creates the workflow for you.

## How It Works

1. **Describe your agent** — Write what the agent should do, what data
   sources it needs, and what output format you want
2. **Generate workflow** — The system creates an Agent Composer workflow
   based on your description
3. **Review and customize** — Fine-tune the generated workflow in the
   Visual Builder
4. **Deploy** — Save and start using your agent

## Create an Agent with Prompt Builder

### 1. Start a New Agent

1. Go to **Agents** in the left sidebar
2. Click **+ New Agent**
3. Select **Prompt** under Configuration

### 2. Describe Your Agent

Write a detailed description of what your agent should do. Include:

* **Your role** — Who will use this agent
* **The task** — What the agent needs to accomplish
* **Data sources** — What systems or documents it should search
* **Output format** — How results should be structured

**Example prompt:**

```
I am a rocket propulsion test engineer responsible for ensuring hot
fire tests meet compliance prerequisites. I need an agent that can
compile and cross-reference dozens of documents from multiple systems
to satisfy the requirements of NASA standard test readiness and build
them into a verification matrix document with an executive summary.

The agent should search for and verify these document categories:

1. Signed-off Test Procedures from MES/PLM systems
2. FTA, FMEA, and Hazard Controls from Safety databases
3. Approved Waivers from Configuration Management
4. Instrumentation Calibration Records from Metrology systems
5. Training and Certification records from LMS/ERP
6. Environmental and Safety Permits from EHS portals
7. Reference TRR Packages from Knowledge Management archives

The output should be a formal verification matrix showing the status
of each category (complete, needs attention, or missing) with document
citations and an executive summary with GO/NO-GO/CONDITIONAL status.
```

### 3. Generate and Customize

1. Click **Create & Customize** — the system generates a workflow
2. Review the workflow in the Visual Builder
3. Link your datastore with relevant documentation
4. Adjust nodes or connections as needed
5. Click **Save & Continue** → **Create**

Your agent is ready to use.

***

## Export and Import YAML

The workflow is stored as YAML. You can export it to save, share,
or version control your configuration.

**To Export:**

1. In the Visual Builder, click the **hamburger menu** (☰) next to
   "Agent Composer"
2. Click **Export**
3. Copy or download the YAML

**To Import:**

1. Create a new agent and open the Visual Builder
2. Click the **hamburger menu** (☰)
3. Click **Import**
4. Paste your YAML — the workflow appears visually

***

## Related

* [Agent Composer Quickstart](/quickstarts/agent-composer) —
  Overview of Agent Composer capabilities
* [Agent Composer GUI Guide](/how-to-guides/agent-composer-gui) —
  Build workflows visually without prompts
* [Agent Composer YAML Guide](/how-to-guides/agent-composer-yaml) —
  Write workflow configurations directly