The tool that not only generates AI results – but also checks them
Precise control: Adjust halo effects, scenarios and channel parameters in real time
AI prompt input: strategy development and tool control
YourValidator
AI Prompt Capabilities – Complete Reference
This document describes all capabilities of the AI Prompt function in YourValidator. It is based exclusively on the implemented code and contains no assumptions or future plans.
Requirements
The AI function requires an active Pro license and your own API key from one of the supported providers. The key is stored exclusively in your browser and never leaves your device.
| Provider | Model | Note |
|---|---|---|
| Anthropic | claude-sonnet-4-20250514 | Recommended – highest accuracy |
| OpenAI | gpt-4o | Alternative |
| Google Gemini | gemini-2.0-flash | Most affordable option |
Priority when multiple keys are stored: Anthropic → OpenAI → Gemini. The AI Interpretation (KPI output) supports only Anthropic and OpenAI.
1. Channel Creation
The AI can create new channels on explicit user request – with any name and automatic type detection. A maximum of 5 channels can be created per prompt.
Freely Named Channels
Any name is allowed. The internal channel ID is generated automatically: spaces are replaced by underscores.
| Input Name | Internal ID |
|---|---|
| Radio Berlin | radio_berlin |
| Google Ads | google_ads |
| SMS Campaign 1 | sms_campaign_1 |
| Golf Club Network | golf_club_network |
Special characters such as !, (, / remain in the ID. Recommendation: use clear, descriptive names without special characters.
Type Detection
The AI automatically detects the channel type from name and context:
| Type | Recognition Criteria |
|---|---|
| Paid/CPC | Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads, Bing Ads, Amazon Ads, any "Ads" or "CPC" in the name, Performance Marketing |
| Referral | Golf Club, Association, Network, Referral, Partner, Cooperation, personal contact, Community Network |
| Standard | Radio, TV, Print, SMS, WhatsApp, Podcast, YouTube, Trade Show, Event, Newsletter, Influencer, Cold Outreach – everything else |
Trigger Words for Channel Creation
The AI creates channels only on explicit request. Without a trigger word it recommends channels in text form but does not create them.
- German: erstelle, füge hinzu, ich brauche, leg an, hinzufügen
- English: create, add, I need, set up
Duplicate Protection
If a channel with the same name or ID already exists, it is skipped. No existing channel is modified. A toast message informs the user.
2. Channel Filling
After creation – or for existing channels – the AI can fill all input fields.
Standard Channels (SEO, PR/Content, Social, Email, Offline, Referral, Paid)
| Field | Patch Key (SEO example) |
|---|---|
| Volume / Reach (Stage 1) | seo.stufe_1_volumen |
| Click Rate / Open Rate (Stage 2) | seo.stufe_2_rate |
| Click to Lead (Stage 3) | seo.stufe_3_rate |
| Lead to Conversion (Stage 4) | seo.stufe_4_rate |
| Monthly Budget | seo.budget_monat_eur |
| Creation Time (months) | seo.erstellungszeit_monate |
| Ramp-up Time (months) | seo.anlaufzeit_monate |
| Saturation Limit | seo.saettigungsgrenze_alpha_eur |
| Halo Sources | seo.halo_sources |
Custom Paid Channels
Paid channels use daily budget, not monthly budget. The tool calculates internally: daily budget × 30 = monthly cost.
| Field | Patch Key |
|---|---|
| Daily Budget (€/day) | [id].tagesbudget_eur |
| Cost per Click (€) | [id].cost_per_click_eur |
| Click to Lead (%) | [id].stufe_3_rate |
| Lead to Conversion (%) | [id].stufe_4_rate |
| Saturation Limit | [id].saettigungsgrenze_alpha_eur |
Important: budget_monat_eur must not be used for Custom Paid channels. 100 in tagesbudget_eur means 100 €/day = 3,000 €/month.
Custom Referral Channels
| Field | Patch Key |
|---|---|
| Referrals p.M. | [id].stufe_1_volumen |
| Response Rate (%) | [id].stufe_2_rate |
| Contact to Lead (%) | [id].stufe_3_rate |
| Lead to Conversion (%) | [id].stufe_4_rate |
| Monthly Budget (€) | [id].budget_monat_eur |
Halo Sources
The AI can set halo sources for any channel – with time delay and decay rate.
| Parameter | Meaning |
|---|---|
| from | Source channel (ID key, e.g. pr) |
| pct | Uplift in % (positive = boost, negative = cannibalization) |
| lag | Delay in months before the effect starts |
| decay | Monthly reduction of the effect in % |
Timeline Parameters (S-Curve)
The AI sets default values per channel type and only overrides them when the user explicitly mentions different values.
| Channel | Creation Time | Ramp-up |
|---|---|---|
| SEO | 2 months | 6 months |
| PR/Content | 1 month | 4 months |
| Social Media | 0 months | 3 months |
| 0 months | 1 month | |
| Referral | 0 months | 3 months |
| Paid/CPC | 0 months | 0 months |
| Podcast | 2 months | 8 months |
| YouTube | 1 month | 5 months |
| Trade Show/Event | 0 months | 0 months |
Seasonality
All 12 months can be set as a percentage value (100 = baseline). The AI knows industry-typical patterns for tax advisory, retail, tourism, B2B/SaaS, construction and gastronomy.
3. Tool Control
The AI can control global tool parameters via prompts – without touching channel-specific data.
| Parameter | What AI can set |
|---|---|
| Base Data | Order value, profit margin, strategy period, city, industry, initial investment, management budget |
| Market Factors | Regionality (Enum: 0.8 to 1.2) and market position (Enum: 0.7 to 1.3) – only defined levels |
| Global Change | Growth in % for all channels simultaneously (e.g. -20% recession) |
| CLV Parameters | Retention rate, annual order value, CLV duration, discount rate |
| Target Customer Count | For goal back-calculation – as starting point for budget scaling |
Activating or deactivating channels via AI is not possible. New channels are automatically created as active. Deactivation is only possible manually via the toggle button.
4. Follow-up Prompts and Field Protection
The AI supports any number of follow-up prompts within a browser session. Each follow-up prompt refines precisely – without touching the rest.
Conversation History
The AI knows all previous prompts in the current session. The history is stored in sessionStorage and ends when the browser tab is closed.
Field Protection
Every field that the user has manually edited is automatically protected. The AI does not overwrite protected fields – even if they would fit contextually. Protection is cleared when the browser tab is closed.
Yellow Highlighting
Fields with AI benchmark estimates are highlighted in yellow. Yellow means: this is an estimate – please review. The highlighting disappears as soon as the user manually edits the field.
5. Benchmarks
With every prompt the AI delivers benchmark ranges for all active channels. These update the ratings in the channel overview. Benchmarks are adjusted by industry and region: DACH, International, UK. For unknown channel types, PR/Content serves as a conservative fallback. Benchmark fields can be manually overridden and are then protected.
6. Language
| Question | Answer |
|---|---|
| Does AI work in German? | Yes, fully. Default for .de domains. |
| Does AI work in English? | Yes, fully. Default for .com domains. |
| Is mixed input possible? | Yes. The AI detects the language automatically. |
| Does AI respond in the input language? | Yes. If the user writes in English, the AI responds in English – even on a .de domain. |
7. Limitations
| What AI cannot do | Reason |
|---|---|
| Activate / deactivate channels | kanal_aktiv is write-protected for AI |
| Create more than 5 channels per prompt | Hard limit in the channel creation logic |
| Overwrite manually changed fields | Protection through internal Protected-Set |
| Save or load plans | Plan management without AI interface |
| Trigger Zapier export | Export is a user action, not an AI command |
| Generate PDF export | No AI interface |
| Set market factors outside enum values | Tool ignores invalid values |
| Cross-session memory | History ends when tab is closed |
Where manual input is required
- Channel activation: New channels are automatically created as active. Deactivation is only possible manually.
- Save plan: After an AI session the user must manually save. AI saves nothing.
- Benchmark correction: If AI estimates benchmarks from the wrong industry, the user must clarify or correct manually.
- Market factors: If the desired setting falls between two enum values, the user must choose manually.
8. Example Prompts
The following prompts work directly, without any preparation.
1 – Simple: Enter base data
Result: Company name, city, order value, profit margin and strategy period are set. Market factors at city level.
2 – Simple: Fill one channel
Result: All SEO fields are filled. Seasonality and other channels remain unchanged.
3 – Medium: Multiple channels at once
Result: Base data, market factors and two channels are fully filled.
4 – Medium: Create paid channel
Result: Paid channel Google Ads is created and filled with daily budget. No factor-30 error.
5 – Medium: Create referral channel
Result: Referral channel is created. Referrals = 120, response rate = 35%, budget = 300 €.
6 – Medium: Set seasonality
Result: All 12 seasonality fields are set. All other tool values remain unchanged.
7 – Advanced: Define halo effect
Result: seo.halo_sources is set with from=pr, pct=15, lag=2, decay=10.
8 – Advanced: Three channels of different types
Result: 3 channels created (Standard, Paid, Referral), all filled, benchmarks for tax advisory set.
9 – Advanced: Recession simulation
Result: wachstum_prozent = -15, marktfaktoren.marktstellung = 0.85, auftragswert_eur = 2800.
10 – Complex: Full initial setup
Result: All base data set. 4 channels created (SEO Standard, Google Ads Paid, Patient Network Referral, Trade Show Standard). Benchmarks for healthcare / DACH.
