Normalized for Mintlify from
knowledge-base/aiconnected-apps-and-modules/modules/kb-generator/ai-knowledge-training-system.mdx.AI Knowledge Training System
The Insight
The Skin Beauty AI works exceptionally well not because of the model, but because of the structured knowledge base. This wasn’t scraped content—it was carefully authored educational content designed to:- Map customer concerns to services
- Help customers self-identify their needs
- Explain the “why” behind each service
- Guide decisions, not just list features
The Transformation Pipeline
┌─────────────────────────────────────────────────────────────────┐
│ USER PROVIDES URL │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ STEP 1: WEB CRAWL │
│ │
│ • Crawl all pages (services, about, FAQ, blog, testimonials) │
│ • Extract raw text, images, structure │
│ • Identify page types and hierarchy │
│ • Capture pricing tables, contact info │
│ │
│ Output: Raw content corpus │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ STEP 2: ENTITY EXTRACTION │
│ │
│ AI extracts structured data: │
│ │
│ • Business: name, type, location, phone, hours │
│ • Services: name, description, price, duration │
│ • Brand signals: tone, formality, target demographic │
│ • Differentiators: what makes them unique │
│ • Trust signals: credentials, experience, testimonials │
│ │
│ Output: Structured business profile + service list │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ STEP 3: KNOWLEDGE ENHANCEMENT (THE MAGIC) │
│ │
│ For each service, AI generates: │
│ │
│ ┌────────────────────────────────────────────────────────────┐ │
│ │ CONCERN MAPPING │ │
│ │ "What problems does this service solve?" │ │
│ │ │ │
│ │ Input: "Morpheus8 RF microneedling treatment" │ │
│ │ Output: ["skin_laxity", "wrinkles", "acne_scars", │ │
│ │ "texture", "stretch_marks"] │ │
│ └────────────────────────────────────────────────────────────┘ │
│ │
│ ┌────────────────────────────────────────────────────────────┐ │
│ │ SELF-IDENTIFICATION TRIGGERS │ │
│ │ "Who is this perfect for?" │ │
│ │ │ │
│ │ Output: │ │
│ │ • "You notice your jawline isn't as defined as it used to │ │
│ │ be" │ │
│ │ • "You're bothered by acne scars from your teenage years" │ │
│ │ • "Your skin just doesn't 'bounce back' like it used to" │ │
│ └────────────────────────────────────────────────────────────┘ │
│ │
│ ┌────────────────────────────────────────────────────────────┐ │
│ │ CHOOSE THIS SERVICE FOR │ │
│ │ "Quick decision guidance" │ │
│ │ │ │
│ │ Output: │ │
│ │ • Tightening loose or sagging skin │ │
│ │ • Deep acne scar treatment │ │
│ │ • Long-lasting anti-aging results │ │
│ │ • Safe treatment for all skin types │ │
│ └────────────────────────────────────────────────────────────┘ │
│ │
│ ┌────────────────────────────────────────────────────────────┐ │
│ │ EDUCATIONAL EXPANSION │ │
│ │ "The why behind the what" │ │
│ │ │ │
│ │ Takes basic description and expands with: │ │
│ │ • How it works (in plain language) │ │
│ │ • What to expect during treatment │ │
│ │ • Results timeline │ │
│ │ • Why this vs. alternatives │ │
│ └────────────────────────────────────────────────────────────┘ │
│ │
│ ┌────────────────────────────────────────────────────────────┐ │
│ │ DIFFERENTIATION │ │
│ │ "How does this compare to similar services?" │ │
│ │ │ │
│ │ Output: │ │
│ │ • "Unlike regular microneedling, Morpheus8 adds RF │ │
│ │ energy for deeper penetration" │ │
│ │ • "Goes up to 4mm deep vs 1-2mm for standard devices" │ │
│ └────────────────────────────────────────────────────────────┘ │
│ │
│ Output: Enhanced service knowledge base │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ STEP 4: RELATIONSHIP MAPPING │
│ │
│ Build the concern → service graph: │
│ │
│ concerns: { │
│ "acne": ["acne_treatment", "chill_pill", "advatx"], │
│ "aging": ["morpheus8", "skin_tightening", "photoshop"], │
│ "glow": ["glow_getter", "oxygen_facial", "glacial"], │
│ "event_prep": ["photoshop", "oxygen_facial", "jetsetter"], │
│ ... │
│ } │
│ │
│ Also map: │
│ • Service → related services (upsell paths) │
│ • Concern severity → service recommendations │
│ • Customer journey paths (first visit → maintenance) │
│ │
│ Output: Knowledge graph │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ STEP 5: CONVERSATION DESIGN │
│ │
│ Generate conversation starters based on: │
│ • Most common concerns for this business type │
│ • Highest-value services │
│ • Seasonal relevance │
│ • Customer journey entry points │
│ │
│ Output: │
│ [ │
│ { icon: "✨", title: "I want glowing skin", │
│ subtitle: "Radiance treatments", │
│ message: "I want glowing, radiant skin" }, │
│ { icon: "🎯", title: "Help with acne", │
│ subtitle: "Clear skin solutions", │
│ message: "I need help with acne and breakouts" }, │
│ ... │
│ ] │
│ │
│ Also generate: │
│ • Quiz questions (if applicable) │
│ • Follow-up question templates │
│ • Objection handling responses │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ STEP 6: SYSTEM PROMPT GENERATION │
│ │
│ Create custom system prompt with: │
│ │
│ • Business identity and role │
│ • Brand voice characteristics │
│ • Service knowledge injection point │
│ • Response formatting rules │
│ • Booking/conversion guidance │
│ • What NOT to do (competitor mentions, off-topic, etc.) │
│ │
│ Output: Complete system prompt │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ STEP 7: HUMAN REVIEW (OPTIONAL) │
│ │
│ Present generated knowledge for review: │
│ • "We found 12 services. Is this correct?" │
│ • Preview enhanced descriptions │
│ • Test conversation flow │
│ • Adjust tone if needed │
│ │
│ Allow: │
│ • Add missing services │
│ • Edit descriptions │
│ • Correct pricing │
│ • Adjust concern mappings │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ DEPLOY TO CHAT │
└─────────────────────────────────────────────────────────────────┘
Admin UI Flow
Screen 1: Getting Started
┌─────────────────────────────────────────────────────────────────┐
│ │
│ 🌟 Train Your AI │
│ │
│ We'll analyze your website to create a knowledgeable │
│ AI assistant that truly understands your business. │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ https:// │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ [ Analyze My Website ] │
│ │
│ This usually takes 2-3 minutes. │
│ │
└─────────────────────────────────────────────────────────────────┘
Screen 2: Analysis Progress
┌─────────────────────────────────────────────────────────────────┐
│ │
│ Analyzing your website... │
│ │
│ ✓ Found 24 pages │
│ ✓ Identified business type: Medical Spa │
│ ✓ Extracted 14 services │
│ ◐ Generating knowledge base... │
│ ○ Creating conversation flows │
│ ○ Building your AI assistant │
│ │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━░░░░░░░ 65% │
│ │
└─────────────────────────────────────────────────────────────────┘
Screen 3: Review Services
┌─────────────────────────────────────────────────────────────────┐
│ │
│ We found 14 services [ + Add ] │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ ✓ Morpheus8 RF Microneedling $800+ │ │
│ │ Concerns: aging, scars, texture, laxity [Edit]│ │
│ ├─────────────────────────────────────────────────────┤ │
│ │ ✓ Glow Getter Facial $225+ │ │
│ │ Concerns: dullness, hydration, glow [Edit] │ │
│ ├─────────────────────────────────────────────────────┤ │
│ │ ✓ Acne Treatment $175+ │ │
│ │ Concerns: acne, breakouts, oily [Edit] │ │
│ ├─────────────────────────────────────────────────────┤ │
│ │ ... │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ Missing something? You can add services manually. │
│ │
│ [ Continue ] │
│ │
└─────────────────────────────────────────────────────────────────┘
Screen 4: Review Knowledge (Expandable)
┌─────────────────────────────────────────────────────────────────┐
│ │
│ Review AI Knowledge │
│ │
│ ▼ Morpheus8 RF Microneedling │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ │ │
│ │ Description: │ │
│ │ The deepest RF microneedling available, Morpheus8 │ │
│ │ combines gold-coated microneedles with... │ │
│ │ │ │
│ │ Choose this service for: │ │
│ │ • Tightening loose or sagging skin │ │
│ │ • Deep acne scar treatment │ │
│ │ • Long-lasting anti-aging results │ │
│ │ │ │
│ │ Perfect for people who: │ │
│ │ • Notice their jawline isn't as defined │ │
│ │ • Are bothered by acne scars │ │
│ │ • Want results without surgery │ │
│ │ │ │
│ │ [ Edit ] │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ ▶ Glow Getter Facial │
│ ▶ Acne Treatment │
│ ▶ Chill Pill Facial │
│ │
│ [ Continue ] │
│ │
└─────────────────────────────────────────────────────────────────┘
Screen 5: Conversation Style
┌─────────────────────────────────────────────────────────────────┐
│ │
│ Your AI's Personality │
│ │
│ Based on your website, we detected: │
│ │
│ Tone: ○ Professional ● Warm ○ Casual │
│ Formality: ○ Formal ● Conversational ○ Friendly │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Sample response: │ │
│ │ │ │
│ │ "I'd love to help you with that! For acne-prone │ │
│ │ skin, our Chill Pill facial is amazing—it uses RF │ │
│ │ technology to calm oil glands and reduce │ │
│ │ inflammation. Many clients see 50-70% improvement │ │
│ │ after just one session! Would you like to know │ │
│ │ more about how it works?" │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ [ Continue ] │
│ │
└─────────────────────────────────────────────────────────────────┘
Screen 6: Test & Launch
┌─────────────────────────────────────────────────────────────────┐
│ │
│ Test Your AI Assistant │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ │ │
│ │ ┌─────────────────────────────────────────────┐ │ │
│ │ │ │ │ │
│ │ │ [Live Chat Preview] │ │ │
│ │ │ │ │ │
│ │ │ User: I have acne scars from high school │ │ │
│ │ │ │ │ │
│ │ │ AI: I completely understand—acne scars │ │ │
│ │ │ can really affect how you feel about │ │ │
│ │ │ your skin. The good news is we have │ │ │
│ │ │ excellent options for this! │ │ │
│ │ │ │ │ │
│ │ │ [Service Card: Morpheus8] │ │ │
│ │ │ [Service Card: TCA CROSS] │ │ │
│ │ │ │ │ │
│ │ └─────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ ┌─────────────────────────────────────────────┐ │ │
│ │ │ Type a test message... │ │ │
│ │ └─────────────────────────────────────────────┘ │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ [ 🚀 Launch AI ] │
│ │
└─────────────────────────────────────────────────────────────────┘
Data Schema
// What gets stored after training
{
// Basic business info
business: {
name: "Skin Beauty Med Spa",
type: "med_spa", // used for industry-specific prompting
location: {
address: "750 Hammond Dr",
city: "Atlanta",
state: "GA",
zip: "30328"
},
phone: "(404) 992-4345",
website: "https://skinbeauty.skin",
bookingUrl: "https://skinbeauty.skin/book",
},
// Brand voice settings
brandVoice: {
tone: "warm", // warm | professional | casual
formality: "conversational", // formal | conversational | friendly
characteristics: ["empathetic", "knowledgeable", "reassuring"],
avoidWords: ["cheap", "discount", "deal"], // luxury positioning
preferredPhrases: ["investment in yourself", "your skin journey"],
},
// Enhanced service data
services: [
{
id: "morpheus8",
name: "Morpheus8 RF Microneedling",
// Basic info (from website)
description: "FDA-cleared fractional RF microneedling...",
price: "$800+",
duration: "60-90 min",
// AI-generated enhancements
expandedEducation: "Unlike standard microneedling that only...",
chooseThisFor: [
"Tightening loose or sagging skin",
"Deep acne scar treatment",
"Long-lasting anti-aging results",
"Safe treatment for all skin types"
],
perfectFor: [
"You notice your jawline isn't as defined as it used to be",
"You're bothered by acne scars from your teenage years",
"You want real results without going under the knife"
],
concerns: ["aging", "skin_laxity", "acne_scars", "texture", "wrinkles"],
relatedServices: ["skin_tightening", "facial_scars", "tca_cross"],
differentiators: [
"Deepest RF microneedling available (up to 4mm on face)",
"First device FDA-cleared for soft tissue contraction",
"Safe for all skin types including Fitzpatrick VI"
],
faqs: [
{ q: "How many treatments do I need?", a: "Most clients see..." },
{ q: "Is it painful?", a: "We use topical numbing..." }
],
tags: ["anti-aging", "scars", "tightening", "all-skin-types"],
requiresConsultation: true,
},
// ... more services
],
// Concern-to-service mapping
concernMap: {
"acne": {
primary: ["acne_treatment", "chill_pill"],
secondary: ["advatx", "glacial"],
severity: {
mild: ["chill_pill", "glow_getter"],
moderate: ["acne_treatment", "advatx"],
severe: ["acne_treatment"] // consultation required
}
},
"aging": {
primary: ["morpheus8", "skin_tightening"],
secondary: ["photoshop_facial", "trilift"],
byArea: {
eyes: ["eye_treatment"],
jawline: ["morpheus8", "trilift"],
fullFace: ["skin_tightening"]
}
},
// ... more concerns
},
// Conversation starters
conversationStarters: [
{
icon: "✨",
title: "I want glowing skin",
subtitle: "Radiance treatments",
message: "I want glowing, radiant skin",
targetConcern: "glow"
},
// ... more starters
],
// Generated system prompt
systemPrompt: `You are the AI assistant for Skin Beauty Med Spa...`,
// Quiz configuration (if enabled)
quiz: {
enabled: true,
questions: [...],
scoringLogic: {...}
},
// Metadata
training: {
sourceUrl: "https://skinbeauty.skin",
crawledAt: "2026-01-09T...",
pagesAnalyzed: 24,
lastUpdated: "2026-01-09T...",
version: 1
}
}
AI Prompts for Each Transformation Step
Prompt: Entity Extraction
Analyze this website content and extract structured business information.
Content:
{raw_crawled_content}
Extract and return JSON:
{
"business": {
"name": "",
"type": "", // e.g., "med_spa", "dental", "salon", "fitness", "restaurant"
"location": {},
"phone": "",
"hours": "",
"bookingUrl": ""
},
"services": [
{
"name": "",
"description": "",
"price": "",
"duration": ""
}
],
"brandSignals": {
"tone": "", // warm, professional, casual
"targetDemographic": "",
"uniqueSellingPoints": []
}
}
Prompt: Knowledge Enhancement (per service)
You are creating a knowledge base entry for an AI assistant that helps
customers find the right service.
Business: {business_name} ({business_type})
Service: {service_name}
Current Description: {service_description}
Price: {price}
Generate enhanced knowledge that helps customers self-identify if this
service is right for them. Write in a {tone} tone.
Return JSON:
{
"expandedEducation": "2-3 paragraphs explaining how this works and why,
in plain language a customer would understand",
"chooseThisFor": [
"3-5 clear use cases, starting with action verbs"
],
"perfectFor": [
"3-5 statements that help customers self-identify,
written as 'You...' statements describing their situation"
],
"concerns": [
"list of concern keywords this service addresses"
],
"differentiators": [
"what makes this different from similar services or DIY alternatives"
],
"commonQuestions": [
{ "q": "question customers often ask", "a": "helpful answer" }
]
}
Prompt: System Prompt Generation
Create a system prompt for an AI assistant for this business:
Business: {business_name}
Type: {business_type}
Tone: {brand_tone}
Services: {service_list}
The AI should:
- Act as a knowledgeable consultant, not a salesperson
- Help customers identify their needs through questions
- Only recommend services this business offers
- Guide toward booking when appropriate
- Never mention competitors
- Use the specified brand voice
Generate a complete system prompt (500-800 words) that will make this AI
helpful, on-brand, and conversion-focused while feeling genuinely caring.
Technical Implementation
Crawling Options
- Firecrawl - Best for JS-heavy sites, returns clean markdown
- Apify - More control, handles complex sites
- Custom Puppeteer - Full control, more maintenance
Processing Pipeline
// Simplified flow
async function trainFromUrl(url) {
// Step 1: Crawl
const pages = await firecrawl.crawl(url, {
maxPages: 50,
includeHtml: false
});
// Step 2: Extract entities
const extraction = await ai.chat({
model: 'claude-sonnet-4-20250514',
messages: [{
role: 'user',
content: ENTITY_EXTRACTION_PROMPT.replace('{content}', pages.markdown)
}]
});
const businessData = JSON.parse(extraction.content);
// Step 3: Enhance each service
const enhancedServices = await Promise.all(
businessData.services.map(service =>
enhanceService(service, businessData.business)
)
);
// Step 4: Build concern map
const concernMap = buildConcernMap(enhancedServices);
// Step 5: Generate conversation starters
const starters = await generateStarters(businessData, enhancedServices);
// Step 6: Generate system prompt
const systemPrompt = await generateSystemPrompt(businessData, enhancedServices);
// Step 7: Compile final knowledge base
return {
business: businessData.business,
brandVoice: businessData.brandSignals,
services: enhancedServices,
concernMap,
conversationStarters: starters,
systemPrompt,
training: {
sourceUrl: url,
crawledAt: new Date().toISOString(),
pagesAnalyzed: pages.length
}
};
}
Cost Estimation
Per training run (typical business with 10-20 services):| Step | Tokens | Cost (Claude Sonnet) |
|---|---|---|
| Crawl | N/A | ~$0.01 (Firecrawl) |
| Entity extraction | ~10K in, ~2K out | ~$0.04 |
| Service enhancement (×15) | ~30K in, ~15K out | ~$0.20 |
| Concern mapping | ~5K in, ~2K out | ~$0.02 |
| Starter generation | ~5K in, ~1K out | ~$0.02 |
| System prompt | ~8K in, ~2K out | ~$0.03 |
| Total | ~$0.35 |
Success Metrics
A well-trained AI should:- Recommend relevant services for any concern mentioned
- Never hallucinate services or prices that don’t exist
- Maintain brand voice consistently
- Guide toward booking naturally
- Handle edge cases gracefully (unknown concerns, competitor questions)
- Self-identify triggers resonate with actual customers
Future Enhancements
- Automatic re-training - Monitor website for changes, re-crawl weekly
- Analytics feedback loop - Learn from which recommendations convert
- Industry templates - Pre-built concern maps for common business types
- Multi-location support - Different services/prices per location
- Seasonal adjustments - Automatically suggest seasonal services