Files
tilbudgivern/docs/guides/AI_TILBUDS_PROMPT_GUIDE.md
alexpolo1 f9484eff3a feat: Enhance project quote generation with hierarchical structure and detailed prompts
- Updated AI prompt in projectQuoteGenerationService.js to include a hierarchical task description format for professional quotes.
- Added critical rules for AI to follow, emphasizing action words and specific material descriptions.
- Created comprehensive documentation for the updated quote system, including examples and guidelines for AI prompts.
- Developed a new layout template for quotes to improve readability and professionalism.
- Established a detailed guide on professional quote structure based on Mikael Holck's standards.
2025-10-30 18:58:22 +00:00

10 KiB

🤖 AI Tilbuds Prompt Guide

Til brug i: projectQuoteGenerationService.js
FormĂĽl: Guide AI til at generere professionelle tilbud som Mikael Holck
Dato: 2025-10-30


📋 Prompt Struktur

System Message

Du er en erfaren tømrermester der skriver professionelle tilbud.
Brug prĂŚcis de angivne data og priser.
Følg nøjagtigt den hierarkiske struktur som i professionelle hündvÌrkertilbud.

🎯 Nøgle-Principper for AI

1. Hierarkisk Opgave-Beskrivelse

✅ KORREKT FORMAT:

HOVEDOPGAVE (fed skrift)

  Underopgave 1
    • Detalje 1
    • Detalje 2
    • Detalje 3
  
  Underopgave 2
    • Detalje 1
    • Detalje 2
  
  Tilbudspris: XX.XXX,00 kr. ex moms

❌ FORKERT FORMAT:

HOVEDOPGAVE
Forskellige ting skal laves.
Vi gør det hele.

Pris: X kr

📝 Beskrivelse Templates

Eksempel 1: Skorsten

SKORSTEN

Sikring omkring skorsten
  • Sliske og stillads udføres omkring skorsten

Skorsten demonteres
  • Mursten fra skorsten sendes til deponi
  • Skorsten demonteres ned til etageadskillelse
  • Forstærkninger fjernes igen, affald bortkøres

Tilbudspris: 34.940,00 kr. ex moms

Nøgleelementer:

  • Hovedopgave: "SKORSTEN"
  • Kategorier: "Sikring", "Demonteres"
  • Bullets: Konkrete handlinger
  • Inklusioner: "affald bortkøres", "sendes til deponi"

Eksempel 2: VĂŚrelse Udvidelse

UDVIDELSE AF VÆRELSE
Tegning 09 vĂŚrelserne 103 og 106

Demonteringsarbejde
  • Eksisterende skunkvæg demonteres i værelse og trapperum
  • Ved "knæk" fjernes skråloft ud mod skunk
  • Skillevæg og gulv i skunk demonteres

Ny konstruktion pĂĽ skrĂĽvĂŚg
  • Udføres med dampspærre, isolering, forskalling og gips
  • Hele skråvæg afsluttes med 1 lag gips monteret ny og gl. skråvæg
  • Skunkvæg opføres med kingspan og gips

Fodpaneler og gulv
  • Der monteres nye fodpaneler i forlængelse af eksisterende paneler
  • Der leveres og monteres nye gulvbrædder i lignede dimension og træsort som øvrig gulv

Malerarbejde
  • Nye skråvægge spartles og males fra kant til kant
  • Fodpaneler pletspartles og males 1 gang

Tilbudspris: 36.108,00 kr. ex moms inkl. maler
Fradrag jf. tilbudsliste: 18.125,00 kr. ex moms
────────────────────────────────────────────
Samlet tilbud: 17.983,00 kr. ex moms

Nøgleelementer:

  • Reference: "Tegning 09..."
  • Logisk arbejdsgang: Demontering → Montering → Afslutning → Maling
  • Materialespecifikationer: "kingspan og gips", "dampspĂŚrre, isolering, forskalling"
  • Detaljer: "1 lag gips", "lignede dimension og trĂŚsort"
  • Inklusioner: "inkl. maler"
  • Fradrag: Tydeligt markeret

🔨 Aktionsord (Start hver bullet med disse)

Demontering

  • "demonteres"
  • "fjernes"
  • "nedtages"
  • "bortkøres"
  • "sendes til deponi"

Montering

  • "monteres"
  • "udføres"
  • "opføres"
  • "etableres"
  • "leveres og monteres"

Afslutning

  • "spartles"
  • "males"
  • "afsluttes"
  • "fĂŚrdiggøres"
  • "efterlades rent"

Forberedelse

  • "sikres"
  • "afdĂŚkkes"
  • "beskytres"
  • "opmĂĽles"

🧱 Materialespecifikationer

✅ GOD SPEC (Konkret og specifik)

• Ny konstruktion udføres med dampspærre, isolering, forskalling og gips
• Skunkvæg opføres med kingspan og gips
• Der monteres nye gulvbrædder i lignede dimension og træsort som øvrig gulv
• Hele skråvæg afsluttes med 1 lag gips monteret ny og gl. skråvæg

❌ DÅRLIG SPEC (For generel)

• Der bruges isolering
• Gips monteres
• Gulv lægges
• Vægge færdiggøres

💰 Pris Formatering

Enkelt Opgave

Tilbudspris: 34.940,00 kr. ex moms

Med Fradrag

Tilbudspris:        36.108,00 kr. ex moms inkl. maler
Fradrag jf. liste:  18.125,00 kr. ex moms
─────────────────────────────────────────────────
Samlet tilbud:      17.983,00 kr. ex moms

Total (Sidste Side)

Momsfrit beløb:        0,00
Momspligtigt beløb:    111.144,00
──────────────────────────────────────
Subtotal:              111.144,00
25,00% Moms:           27.786,00
══════════════════════════════════════
Total DKK:             138.930,00

📐 Arbejdsgang Logik

Korrekt RÌkkefølge

  1. Forberedelse

    • Sikring
    • Stillads
    • AfdĂŚkning
  2. Demontering

    • Fjernelse af gammelt
    • Bortkørsel af affald
  3. Ny Konstruktion

    • Skelet/konstruktion
    • Isolering
    • Forskalling
  4. Afslutning

    • Gips
    • Spartling
    • Maling
  5. Oprydning

    • Affald bortkøres
    • OmrĂĽdet efterlades rent

🎨 Sprog og Tone

Professionel men TilgĂŚngelig

✅ GOD TONE:

"Eksisterende skunkvĂŚg demonteres i vĂŚrelse og trapperum"
"Der leveres og monteres nye gulvbrĂŚdder"
"Vi indhenter tilbud fra flere leverandører"
"Alt affald bortkøres"

❌ DÅRLIG TONE:

"Vi laver skunkvĂŚggen"
"Gulvene bliver lagt"
"Vi finder materialer"
"Rydder op"

PrĂŚcision

✅ PRÆCIS:

"Hele skrĂĽvĂŚg afsluttes med 1 lag gips"
"Fodpaneler pletspartles og males 1 gang"
"Skorsten demonteres ned til etageadskillelse"

❌ UPRÆCIS:

"VÌggen gøres fÌrdig"
"Paneler males"
"Skorsten fjernes"

📋 Komplet AI Prompt Template

Du er en erfaren tømrermester der skriver professionelle tilbud.

KRITISK: Brug HIERARKISK struktur som i dette eksempel:

HOVEDOPGAVE

  Underopgave 1
    • Konkret detalje med aktionsord
    • Konkret detalje med aktionsord
  
  Underopgave 2
    • Konkret detalje med aktionsord
    • Konkret detalje med aktionsord
  
  Tilbudspris: XX.XXX,00 kr. ex moms

REGLER:
1. Start bullets med AKTIONSORD: "demonteres", "monteres", "udføres"
2. VĂŚr SPECIFIK om materialer: "kingspan og gips", "dampspĂŚrre, isolering, forskalling"
3. Følg LOGISK arbejdsgang: Demontering → Montering → Afslutning
4. Inkluder hvad der INDGÅR: "affald bortkøres", "sendes til deponi", "inkl. maler"
5. Brug PRÆCISE priser - ingen runding

PROJEKT DATA:
{
  "projektInfo": {
    "navn": "Tagrenovering MaglegĂĽrds Alle",
    "kunde": "Rasmus Gamrath",
    "beskrivelse": "Komplet tagrenovering med nye tagsten"
  },
  "tagArbejde": {
    "type": "Sadeltag",
    "areal": "120 m²",
    "kompleksitet": 1.2
  },
  ...
}

Skriv tilbud der følger PRÆCIS ovenstående struktur.
Maksimalt 80 nye ord udover den statiske template.

🔍 Eksempel Prompts

For Tagrenovering

PROJEKT: Tagrenovering sadeltag 120m²

Beskriv arbejdet hierarkisk:

TAGRENOVERING

  Forberedelse
    • Stillads etableres omkring hele huset
    • Eksisterende tagrender og nedløbsrør demonteres
    • Arbejdsområde sikres og afdækkes
  
  Demontering af eksisterende tag
    • Gamle tagsten og lægter demonteres
    • Undertag og dampspærre fjernes
    • Alt materiale sendes til deponi
  
  Ny tagkonstruktion
    • Ny undertag monteres med dampspærre
    • Nye lægter monteres med korrekt afstand
    • Nye tagsten leveres og monteres
  
  Afslutning
    • Nye tagrender og nedløbsrør monteres
    • Alle overgange tætnes korrekt
    • Arbejdsområde efterlades rent, affald bortkøres

  Tilbudspris: 85.400,00 kr. ex moms

For Gulvudskiftning

PROJEKT: Udskiftning af gulv i stue 35m²

GULVUDSKIFTNING

  Forberedelse
    • Møbler flyttes og området ryddes
    • Eksisterende gulv opmåles
  
  Demontering
    • Gamle gulvbrædder demonteres
    • Eksisterende bjælkelag kontrolleres
    • Gammelt materiale bortkøres
  
  Ny gulvkonstruktion
    • Bjælkelag forstærkes hvor nødvendigt
    • Nye gulvbrædder i douglas-gran leveres og monteres
    • Gulv slibes og olies 2 gange
  
  Afslutning
    • Nye fodpaneler monteres
    • Området efterlades rent
  
  Tilbudspris: 32.800,00 kr. ex moms

⚠️ Almindelige Fejl AI Skal Undgå

❌ Fejl 1: Flad Struktur

TAGRENOVERING
• Gammelt tag fjernes
• Nyt tag monteres
• Pris: 85.000 kr

Problem: Ingen underopgaver, ingen detaljer, ikke hierarkisk

❌ Fejl 2: For Generel

TAGRENOVERING
Vi renoverer dit tag med nye materialer.
Alt inkluderet.
Pris: 85.000 kr

Problem: Ingen konkrete arbejdsgange, ingen materialespecifikationer

❌ Fejl 3: Forkerte Aktionsord

TAGRENOVERING
• Vi laver taget
• Der bliver brugt nye sten
• Det hele bliver malet

Problem: Passiv form, ikke professionelt sprog

❌ Fejl 4: Manglende Inklusioner

TAGRENOVERING
• Gammelt tag demonteres
• Nyt tag monteres

Problem: Hvad sker der med affaldet? Er stillads inkluderet?


✅ Tjekliste for AI-Genereret Tilbud

  • Hierarkisk struktur (Hovedopgave → Underopgaver → Bullets)
  • Aktionsord i alle bullets
  • Materialespecifikationer konkrete
  • Logisk arbejdsgang (Forberedelse → Demontering → Montering → Afslutning)
  • Inklusioner nĂŚvnt (affald, oprydning)
  • PrĂŚcise priser brugt
  • Professionelt sprog
  • Ingen stavefejl
  • Korrekt formatering

🚀 Implementation

I projectQuoteGenerationService.js

buildOptimizedPrompt(quoteData, options) {
  const systemMessage = `Du er en erfaren tømrermester der skriver professionelle tilbud.

KRITISK STRUKTUR-PRINCIP:
Brug HIERARKISK opgave-beskrivelse:

HOVEDOPGAVE
  Underopgave 1
    • Detalje 1
    • Detalje 2
  Underopgave 2
    • Detalje 1

Eksempel:
"SKORSTEN

Sikring omkring skorsten
  • Sliske og stillads udføres omkring skorsten

Skorsten demonteres
  • Mursten sendes til deponi
  • Skorsten demonteres ned til etageadskillelse
  • Forstærkninger fjernes, affald bortkøres

Tilbudspris: 34.940,00 kr. ex moms"`;

  const userMessage = `PROJEKT DATA:
${JSON.stringify(structuredData, null, 2)}

KRITISKE REGLER:
1. AKTIONSORD først: "demonteres", "monteres", "udføres"
2. SPECIFIK om materialer: "kingspan og gips"
3. LOGISK arbejdsgang: Forberedelse → Demontering → Montering → Afslutning
4. INKLUDER: "affald bortkøres", "sendes til deponi"
5. PRÆCISE priser - ingen runding

Skriv tilbud der følger NØJAGTIGT denne hierarkiske struktur.`;

  return { systemMessage, userMessage };
}

Vedligeholdt af: Tilbudgivern Team
Sidst opdateret: 2025-10-30
Baseret pĂĽ: Mikael Holck ApS Tilbud #1846