Skip to main content
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

  1. Describe what you want in plain language, with or without a starting URL
  2. The agent reads your prompt, breaks it into steps, and navigates the site
  3. Data is extracted into your schema and delivered to your destination
No selectors, no click sequences, no configuration needed. The sections below help you write prompts that get the best results. Prompt step

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.

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

Procurement portal behind login

- Log in with @username and @password
- Navigate to "Purchase Orders"
- Filter by status "Open"
- Extract: po_number, vendor, amount, date, status
- Continue through pagination

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 @variableName to reference reusable values in your prompt. Variables are replaced at runtime.
  • Type @ in the prompt editor to see available variables
  • 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 →