Skip to main content
~20–30 minutes setup

What You'll Need

Prerequisites before starting

Knowledge Base vs. Prompt

The crucial distinction between facts and instructions

Best Practices

Formats that help your AI find the right answers

Quick Path

Condensed steps for experienced users

Step-by-Step Setup

Complete walkthrough (Steps 1–7)

Using an LLM

Time-saving shortcuts for content creation

Debugging

Inspect and improve AI answers

Quick Checklist

Verify your setup is complete

Troubleshooting & FAQs

Common issues & fixes

Introduction

You’ve set up your Irelia.ai agent, and it’s ready to have conversations — but it doesn’t know anything about your business yet. Without the right information loaded in, your agent can’t answer questions about your pricing, services, or policies. And prospects who don’t get answers move on fast. The Knowledge Base (KB) is where you fix that. It’s the place you fill with your business’s facts, FAQs, and details so your AI agent can search through them and respond accurately to every question a prospect asks. This guide walks you through everything: understanding how the Knowledge Base works, structuring your content for the best results, uploading it into Irelia, and setting up smart features like document assignment and gap detection. By the end of this guide, you’ll have: ✅ A clear understanding of how the Knowledge Base works and what content belongs there
✅ Well-structured Q&A documents uploaded and trained in your Irelia agent
✅ Customer reviews added for social proof in conversations
✅ Documents assigned to the right agents for maximum accuracy
✅ Notifications set up to automatically catch Knowledge Base gaps

How This Works

Think of the Knowledge Base as a reference library your AI agent can search during conversations. No technical background required — here’s the flow:
StepWhat HappensReal-World Analogy
📁 1. You add informationYou upload FAQs, product details, pricing, etc.Stocking the library shelves
🗂️ 2. AI indexes the contentIrelia processes and organizes your informationCreating a searchable catalog
💬 3. Prospect asks a question”What are your prices?” arrives in chatSomeone walks in with a question
🔍 4. AI searches for relevant infoThe system finds the most relevant pieces from your KBThe librarian finds the right books
💡 5. AI crafts a responseUsing the found information, the AI generates a natural replyThe librarian explains the answer conversationally
The key insight: your AI agent doesn’t memorize your content — it searches through your Knowledge Base every time it needs to answer a question. This means:
  • Information must be findable — Write content that matches how prospects ask questions
  • Clarity matters — Clear, well-structured info = better answers
  • Updates are instant — Change a document, and the AI immediately uses the new version
When we say you’re “training” the AI, you’re not teaching it to think differently. You’re simply giving it access to the specific business facts it needs. The AI already knows how to have conversations — your job is to provide the business-specific information it needs to be helpful.

📝 What You’ll Do

Here’s a quick overview of the steps in this guide:
  1. Set up your Knowledge Base — Access the KB, create documents, add content, and train your agent (~15 minutes)
  2. Add customer reviews — Upload testimonials for social proof (~5 minutes)
  3. Assign documents to specific agents — Control which agents access which information (~3 minutes)
  4. Set up missing info notifications — Enable gap detection for continuous improvement (~2 minutes)

📋 What You’ll Need

  • An Irelia.ai account with at least one active agent Required
  • Your business information gathered and ready (FAQs, pricing, product/service details, policies) Required
  • An LLM with reasoning capabilities (ChatGPT, Claude, Gemini, or similar) to help format your content — see the LLM section for ready-to-use prompts Optional
No coding required. If you can copy and paste, you can do this.

⚖️ Knowledge Base vs. Prompt: What Goes Where?

This is the #1 source of confusion for new users. Let’s clear it up.

The Clear Distinction

Knowledge BasePrompt (Agent Settings)
PurposeWHAT the AI knowsHOW the AI behaves
ContainsFacts, FAQs, product info, pricing, policiesPersonality, tone, conversation rules, goals
AnalogyThe employee handbook & product catalogThe training on “how to talk to customers”
Example”Our premium plan costs €99/month and includes…""Be friendly and professional. Always try to book a call…”

📥 What Belongs in the Knowledge Base

Information your AI can look up and share:
  • Product/service descriptions
  • Pricing and packages
  • FAQs and common objections
  • Company information and history
  • Process explanations (how things work)
  • Policies (shipping, refunds, etc.)
  • Case studies and results
Example: “Q: What are your pricing plans? A: We offer three plans: Starter at €29/month (up to 100 contacts), Growth at €79/month (up to 1,000 contacts), and Enterprise at €199/month (unlimited contacts with priority support).” This is a fact about your business. When someone asks about pricing, the AI searches for this information and shares it.

🚫 What Doesn’t Belong in the Knowledge Base

These are behavioral instructions — they belong in the Prompt:
  • “Always be friendly and professional”
  • “If someone asks about price, first understand their needs”
  • “Never promise exact results”
  • “Always try to schedule a call”
  • “Speak in first person as the company”
  • Conversation flow instructions
  • Qualifying questions to ask
Common mistake: “When someone asks about pricing, first ask them about their business size and then recommend the appropriate plan. Be enthusiastic but not pushy.” This tells the AI how to act, not what information to share. It’s an instruction, not a fact — so it goes in the Prompt.

The Quick Test

Ask yourself: “Is this a FACT or an INSTRUCTION?”
  • Fact → Knowledge Base
  • Instruction → Prompt
That’s it. Keep them separate, and your AI will perform much better.

✍️ Best Practices for Structuring Your Content

How you structure your information directly impacts how well your AI can find and use it.

💎 The Golden Format: Q&A Style

The most effective format for Knowledge Base content is Question & Answer: Q: What are your business hours? A: We’re open Monday to Friday, 9 AM to 6 PM (CET). We’re closed on weekends and Italian public holidays. Why this works:
  • Mirrors how prospects actually ask questions
  • Easy for the AI to match questions to answers
  • Simple to maintain and update

🔄 Include Question Variations

People ask the same thing in many different ways. Adding variations helps the AI match and retrieve the right information, no matter how a prospect phrases their request. Example: Q: What are your business hours? / When are you open? / What time do you close? / Are you open on weekends? / Can I reach you on Saturdays? A: We’re open Monday to Friday, 9 AM to 6 PM (CET). We’re closed on weekends and Italian public holidays. Five different questions, one answer. The more angles you cover, the more reliably your AI finds the right answer.

🧭 The 5W Framework: Anticipate Every Question

Use this framework to brainstorm what questions your prospects might ask:
  • WHAT — What is your product? What does it include? What results can I expect?
  • 🤔 WHY — Why should I choose you over competitors? Why does this approach work?
  • WHEN — When can I start? When will I see results? When are you available?
  • 👤 WHO — Who is this for? Who’s behind the company? Who will I work with?
  • 📍 WHERE — Where are you located? Where do you ship/operate?
  • ⚙️ HOW — How does it work? How do I get started? How much does it cost?
Go through each category and write Q&A pairs for the questions your prospects actually ask.

📂 Document Organization: Think in Categories

Don’t put everything in one giant document. Split your information by topic — this makes it easier to update specific sections and assign only relevant content to specific agents.
Plan ahead for agent assignment. Before creating your documents, think about which AI agents will need which information. If you’re running multiple funnels or selling different products, structure your documents so you can easily assign the right content to the right agent later. See Step 6 for details.
For example, you might create separate documents for:
  • Coaching Service FAQs — your process, onboarding steps, timelines, common questions and objections
  • Online Course FAQs — costs, what’s included, payment options, common questions and objections
  • Company Info — about us, team, credentials
The exact categories depend on your business. Think about the main topics prospects ask about, and create one document per topic.

Formatting Tips

Do:
  • Use clear, simple language
  • Include specific numbers and details
  • Include variations of how people might ask
Don’t:
  • Use complex jargon without explanation
  • Include contradictory information
  • Write walls of text without structure

💰 Strategic Price Omission for Service Businesses

If you’re selling high-ticket services, consider not including specific pricing in your Knowledge Base. Instead, add this to your FAQs: “Q: How much does it cost? / What are your prices? A: Pricing depends on your specific situation and goals. Book a quick call with our team and we’ll give you a custom quote based on your needs.” Why this works from a sales perspective: When someone’s first question is “how much does it cost?”, they’re often comparing you on price alone — essentially commoditizing your service. By directing them to a call, you:
  • Keep curiosity alive — Price curiosity is a powerful motivation to book a call. Once you reveal the number, that motivation disappears — they either dismiss you as “too expensive” without context, or they get what they needed and leave.
  • Create the opportunity to frame value properly — In a sales meeting, you can understand their specific needs, position your solution, differentiate from competitors, and help them see the true value of what you offer.
This shifts the conversation from price-based buying (who’s cheapest?) to value-based buying (who’s the best fit for my needs?). In a call, you can better create the right framing. Based on our experience, service businesses that use this approach see more booked calls and higher-quality conversations.
Important: This strategy works best for services and high-ticket offers. For e-commerce or standardized products, clear pricing typically converts better.

⚡ Quick Path (Experienced Users)

Already familiar with Irelia’s Knowledge Base? Here’s the condensed version:
  1. Irelia: Go to irelia.ai/settings → click the Knowledge Base icon in the left sidebar
  2. Create: Click ”+ Create a new document” → Name it descriptively → Add Q&A formatted content
  3. Save: Click “Save” → Wait for the ✓ checkmark confirming training is complete
  4. Reviews: Switch to the “Reviews” tab → Create one document per review using the format “[Name] from [Source] says: [review text]” → Save each one
  5. Assign: Go to your agent’s settings → “Knowledge Base” section → Toggle off “Allow this agent to access all information” → Select specific documents
  6. Notify: Go to your agent’s “Events and Notifications” tab → Enable the missing info notification → Add a webhook URL or enable email alerts
Need more detail? Continue with the full guide below.

🔧 Step-by-Step Setup

1

Access the Knowledge Base

~1 minute
  1. Navigate to your Irelia settings: irelia.ai/settings
  2. Click the Knowledge Base icon in the left sidebar
  1. You’ll see two tabs at the top:
    • “Informations” — For FAQs, product info, company details
    • “Reviews” — For customer testimonials and social proof
2

Create a New Document

~2 minutes
  1. Click the ”+ Create a new document” button at the bottom of the document list
  1. You’ll be prompted to enter a document name — choose a clear, descriptive name (e.g., “Pricing”, “FAQs”, “Product Features”)
Document names can’t be changed after creation. If you need to rename a document, you’ll have to delete it and create a new one with the correct name. Double-check your naming before confirming!
  1. Once you confirm the name, your new document appears in the list and you can start editing
3

Add Your Content

~10–15 minutes
  1. Click on your document to open the editor
  2. Start adding your Q&A formatted content (see Best Practices for Structuring Your Content for formatting guidance)
Plenty of room: Each document can hold up to 220,000 characters — that’s roughly 35,000–40,000 words. You won’t run out of space.
4

Save and Train Your Agent

~1 minuteWhen you’ve added or edited content, the document icon changes to indicate unsaved changes.
  1. Click the “Save” button to save your changes and train the AI
  1. A loading spinner appears next to your document name while the AI processes the new information
  2. When complete, a checkmark icon ✓ appears, confirming your AI is now trained on this content
Success! Your AI agent can now use this information in conversations.
5

Add Customer Reviews

~5 minutesReviews are powerful for building trust. Irelia has a dedicated section for them, allowing your agent to reference real testimonials when social proof would help the conversation.

Switch to the Reviews tab

  1. Click the “Reviews” tab at the top of the Knowledge Base screen

Create and format review documents

  1. Click the ”+ Create a new document” button for each review you want to add
  2. Use this format for each review: “[Name] from [Source] says: [review text]”
Example: “Marco R. from Google Reviews says: ‘Incredible service! They helped me automate my lead follow-up and I’ve seen a 40% increase in appointments booked. Highly recommended!’”
One review per document. Each document must contain exactly one review. This allows the AI to select the most relevant testimonial for each conversation context.
  1. Click “Save” for each review document and wait for the ✓ checkmark
Success! Your agent now has social proof to reference during conversations.
6

Assign Documents to Specific Agents

~3 minutesIf you’re running multiple agents (e.g., different funnels, multiple products, or different use cases), you can keep each agent focused by controlling which Knowledge Base documents it can access.Why this matters:
  • Relevance — Each agent only sees information relevant to its role
  • Accuracy — Less irrelevant information = lower risk of confusion
  • Organization — Keep things clean and manageable

Configure document access

  1. Go to your agent’s settings (in the agent configuration section)
  2. Find the “Knowledge Base” section
  1. You have two options:
    • Toggle on the “Allow this agent to access all information” switch — the agent sees everything
    • Toggle off and select specific documents — the agent only sees what you choose
  2. The same options exist for “Reviews” on the right side
Example setup:
AgentDocuments AssignedReviews
Coaching Program AgentCoaching Pricing, Program Details, Coach Bio, Coaching FAQsCoaching testimonials only
Online Course AgentCourse Pricing, Course Curriculum, Course FAQsCourse testimonials only
Agency Services AgentService Packages, Case Studies, Agency FAQsAgency client testimonials
This way, your coaching agent won’t accidentally mention course pricing, and vice versa.
Success! Each agent now only accesses the documents relevant to its role.
7

Set Up Missing Info Notifications

~2 minutesOne of the most powerful features in Irelia: get notified when your AI can’t find information to answer a question.Why this is valuable:
  • 🎯 Discover gaps in your Knowledge Base
  • 📊 See what real prospects are actually asking
  • 🔄 Continuously improve your AI’s performance

Enable the notification

  1. Go inside one of your agents
  2. Click the “Events and Notifications” tab
  3. Enable the notification for questions the AI lacks information to answer
  1. You can set up either or both options:
    • Webhook URL — Send data to Slack, a spreadsheet, or your CRM automatically
    • Email notifications — Receive an email for each missing-info question

What you’ll receive

You’ll get the exact question that stumped your AI. Use this to:
  • Add the missing information to your Knowledge Base
  • Identify patterns — are many people asking the same thing?
  • Improve your Q&A coverage over time

🎉 Congratulations! You Did It!

Take a moment to appreciate what you just built: ✅ Your AI agent has a fully stocked Knowledge Base with your business information
✅ Customer reviews are ready to use as social proof in conversations
✅ Each agent only accesses relevant documents for more accurate responses
✅ Missing info notifications ensure your Knowledge Base keeps improving automatically
What happens now: Every time a prospect asks a question, your AI agent searches through your Knowledge Base, finds the most relevant information, and crafts a natural, accurate response — without you lifting a finger.

What’s Next?

Now that your Knowledge Base is set up, the possibilities are wide open. Your options from here:
  1. 🤖 Want help creating content? Jump to Using an LLM to Prepare Your Documents for ready-to-use prompts that speed up content creation
  2. 🔍 Want to understand your AI’s answers? Check out Debugging to see exactly which information the AI uses for each response
  3. 📋 Want to verify everything’s set up correctly? Use the Quick Checklist to make sure nothing was missed
  4. Have more content to add? Repeat Steps 2–4 for each new topic — create a new document, add Q&A content, and save

🤖 Using an LLM to Prepare Your Documents

Don’t have time to write everything from scratch? Any powerful LLM with reasoning enabled will do — ChatGPT, Claude, Gemini, or similar. Just paste the prompts below into your preferred tool.

Method 1: Transform Existing Documents and Web Pages

If you already have business information (website copy, brochures, internal docs), use this prompt to convert it into Knowledge Base format:

Transform existing content into Q&A Knowledge Base format

What’s the 5W+H framework? It’s a simple brainstorming method for anticipating questions. See the 5W Framework section for the full breakdown.

Method 2: Generate Questions and Objections from Scratch

Don’t have existing content? Use this prompt to generate a complete Knowledge Base starting from just a description of your business:

Generate Q&A content from a business description

This gives you a solid foundation to customize with your specific details.

Review Before Uploading

Always review AI-generated content before adding it to your Knowledge Base:
  • ✅ Adjust the tone to match your brand
  • ✅ Add specific details (numbers, names, etc.)
  • ✅ Check for accuracy and remove irrelevant information

🔍 Debugging: Understanding How Your AI Uses Your Info

Need to understand why the AI gave a specific answer? Irelia has built-in debugging tools that show you exactly which Knowledge Base content the AI used.

🔬 How to Access Debug Info

  1. Go to irelia.ai/leads (your chat panel)
  2. Find a conversation where the AI responded
  3. Look for the info icon (ℹ️) next to AI messages — this icon indicates which message pulled information from the Knowledge Base to reply
  1. Click the icon to open the debug popup

👁️ What You’ll See

The popup shows:
  • Information chunks pulled — The exact pieces of your Knowledge Base the AI found relevant
  • Summary — A condensed view of the relevant information pulled (what the AI actually uses to reply)

📈 How to Use This for Improvement

What You SeeWhat It MeansAction to Take
Wrong info was pulledKeywords in the question matched unrelated contentRewrite your Q&As to be more specific
⚠️ Right topic, incomplete answerInfo exists but isn’t complete enoughAdd more detail to that section
🚫 No info was foundThe question isn’t coveredAdd a new Q&A for this topic
🔀 Multiple conflicting chunksSimilar topics are causing confusionConsolidate or clarify your documents

✅ Quick Checklist

Use this to verify your Knowledge Base setup is complete:

Content Preparation

  • Created and named documents in Irelia
  • Saved each document (look for the ✓ checkmark)
  • Added reviews (one per document)
  • Assigned documents to the appropriate agents
  • Enabled missing info notifications
  • Tested common questions with your agent
  • Filled gaps based on real conversations
All checked? Your Knowledge Base is ready!
Remember the golden rule: Knowledge Base = WHAT your AI knows. Prompt = HOW your AI behaves. Keep them separate, and your AI will perform beautifully!

🛠️ Troubleshooting & FAQs

What this means: Your AI agent can’t find or access the content you uploaded, so it’s either ignoring it or giving generic responses.How to fix it:Step 1: Check that documents are saved and assigned
  • Look for the ✓ checkmark icon next to your document name in the Knowledge Base
  • Verify the document is assigned to this agent
Step 2: Check question phrasing
  • The prospect’s question may not match how you wrote the information
  • Use the debug feature to see what info was pulled
  • If the information exists and is saved but the AI didn’t find it, add multiple question variations so the AI can match the right content regardless of how the prospect phrases the request
What this means: The AI is pulling outdated, conflicting, or incomplete content from your Knowledge Base.How to fix it:Step 1: Review your documents
  • Check for outdated content that’s still in the Knowledge Base
  • Look for contradictory information across documents
  • Make answers more specific — vague answers cause the AI to “fill in gaps”
Step 2: Use debugging to identify the source
  • Open the debug popup to see exactly which information the AI pulled
  • Update or remove the problematic content
No. Focus on information your prospects actually need. Too much irrelevant information can confuse the AI’s search.
  • Include: Anything a prospect might ask about
  • Exclude: Internal processes, information only employees need
Update when:Best practice: Review monthly, plus whenever something changes.
Plain text works best. Keep formatting simple:
  • Use clear line breaks between Q&As
  • Avoid complex formatting that might not be supported by WhatsApp, Instagram, or Messenger
Write in the language your prospects use. Irelia’s AI can understand and respond in 50+ languages, but your Knowledge Base should match your audience.
Solution: It depends on your business model:
  • For standardized products / e-commerce: Yes, include clear pricing. Prospects expect it.
  • For services and high-ticket offers: Consider omitting specific prices and directing prospects to book a call instead.
See Strategic Price Omission for Service Businesses for the full sales logic behind this approach.

🆘 Need Help?

Irelia.ai Support:
  • Contact support in the WhatsApp priority support group or send an email to info@irelia.ai
  • Include: screenshots of your Knowledge Base setup, your account name, an example of the issue, and what you expected vs. what happened