> ## Documentation Index > Fetch the complete documentation index at: https://docs.kadoa.com/llms.txt > Use this file to discover all available pages before exploring further. # Prompts > Tell Kadoa what to extract and how to get there 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](/docs/ui/getting-started), 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 โ†’](/docs/workflows/variables) ยท [Secret Variables โ†’](/docs/workflows/secrets) *** ## Using in Code Pass your prompt via `userPrompt`: ```json theme={null} { "urls": ["https://example.com/products"], "userPrompt": "Extract all products. Continue through pagination. Open each item for full details." } ``` [Create workflows in code โ†’](/docs/sdk/workflows/create)