Prompts

Every Kadoa workflow is driven by a prompt: a plain-language description of what data you need and how to reach it. When you build with the Kadoa Assistant, your description is the prompt, and you can refine it any time by chatting or editing it directly.

How It Works

Describe what you want in plain language, with or without a starting URL
The agent reads your prompt, breaks it into steps, and navigates the site
Data is extracted into your schema and delivered to your destination

No selectors or click sequences are needed. The sections below help you write prompts that get the best results.

The Kadoa workflow setup prompt with a prompt editor and configuration controls

Writing good prompts

Good prompts are specific and sequential: tell the agent where to go, what to interact with, what to extract, and how far to continue. The examples below show the pattern.

Use the setup prompt

When creating a workflow in the dashboard, the setup prompt combines your instructions with optional workflow configuration. Use the controls below the editor to choose a template, notification channels, tags, or the workflow type. You can also insert reusable items while typing:

Shortcut	Inserts	Example
`@`	Notification channel	`Email:Operations`
`#`	Workflow tag	`Tag:Sales`
`$`	Variable	`Variable:keywords`

Selecting an item adds a chip to the prompt and updates its related workflow setting. Remove the chip to remove the channel or tag selection. You can create a variable, tag, or notification channel from its selector when needed. Choose Workflow for a dataset that runs once or on a schedule. Choose Real-time to monitor a site continuously; real-time workflows require a notification channel unless a selected template provides notifications.

Real-time monitoring is available on request. Contact support to enable it for your workspace.

Example Prompts

E-commerce product catalog

- Go to the "All Products" page
- Extract: product_name, price, brand, availability, rating
- Click "Next" to continue through all pages
- Stop when there are no more results

Financial document extraction

- Navigate to the investor relations section
- Find all quarterly earnings reports from 2024-2025
- Download each PDF and extract: revenue, net_income, eps, guidance
- Also collect: report_date, fiscal_quarter, filing_type

Job board with detail pages

- Go to the careers page
- For each job posting in the list, click into the detail page
- Extract: title, department, location, salary_range, description
- Return to the list and continue with the next posting
- Continue through all pages

Variables

Use reusable variables in your prompt. Variables are replaced at runtime.

Type $ in the setup prompt to see available variables
Select a variable to insert a chip that keeps its stored key and ID
Secret variables are encrypted and never sent to LLMs
Store entire prompts as variables to reuse them across workflows

Learn more about Variables → · Secret Variables →

Using in Code

Pass your prompt via userPrompt:

{
  "urls": ["https://example.com/products"],
  "userPrompt": "Extract all products. Continue through pagination. Open each item for full details."
}

Create workflows in code →

Foundations

Security & Compliance

Build with UI

Build with Code

Integrations

How It Works

Writing good prompts

Use the setup prompt

Example Prompts

Variables

Using in Code

​How It Works

​Writing good prompts

​Use the setup prompt

​Example Prompts

​Variables

​Using in Code

How It Works

Writing good prompts

Use the setup prompt

Example Prompts

Variables

Using in Code