> ## Documentation Index
> Fetch the complete documentation index at: https://docs.loopz.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge Base

> Train your agent with documents, links, and FAQs

Your agent becomes smarter when you give it information about your business. There are three ways to add knowledge:

## 1. Upload Documents 📄

Upload files containing information about your business.

### Supported Formats

<CardGroup cols={4}>
  <Card title="PDF" icon="file-pdf">
    .pdf files
  </Card>

  <Card title="Text" icon="file-lines">
    .txt files
  </Card>

  <Card title="Excel" icon="file-excel">
    .xlsx files
  </Card>

  <Card title="CSV" icon="file-csv">
    .csv files
  </Card>
</CardGroup>

### What to Upload

* Product catalogs
* Service descriptions
* Company policies
* Return and shipping information
* Frequently asked questions

### How to Upload

<Steps>
  <Step title="Open Knowledge Base">
    Go to your agent's **Knowledge Base** tab
  </Step>

  <Step title="Upload Files">
    Click **"Upload"** or drag and drop files
  </Step>

  <Step title="Wait for Processing">
    The system extracts and learns from your content
  </Step>

  <Step title="Confirm Completion">
    Files show **"Completed"** when ready
  </Step>
</Steps>

<Note>
  Maximum file size is **50MB** per file.
</Note>

## 2. Add Links 🔗

Point your agent to web pages with useful information.

<Steps>
  <Step title="Open Links Tab">
    Click the **"Links"** tab in Knowledge Base
  </Step>

  <Step title="Enter URL">
    Enter the web page URL
  </Step>

  <Step title="Add Details">
    Add a title and optional description
  </Step>

  <Step title="Save">
    Click **"Add Link"**
  </Step>
</Steps>

### Good Links to Add

<CardGroup cols={2}>
  <Card title="Product pages" icon="box">
    Help your agent recommend and describe products
  </Card>

  <Card title="About us page" icon="building">
    Let customers learn about your company
  </Card>

  <Card title="Terms and conditions" icon="file-contract">
    Answer policy-related questions accurately
  </Card>

  <Card title="Blog posts" icon="blog">
    Share helpful information and guides
  </Card>
</CardGroup>

## 3. Create FAQs ❓

Add common questions and their answers directly.

<Steps>
  <Step title="Open FAQs Tab">
    Click the **"FAQs"** tab
  </Step>

  <Step title="Add New FAQ">
    Click **"Add FAQ"**
  </Step>

  <Step title="Enter Question">
    Enter the question customers might ask
  </Step>

  <Step title="Provide Answer">
    Provide the answer you want your agent to give
  </Step>

  <Step title="Categorize (Optional)">
    Add a category to organize FAQs
  </Step>
</Steps>

### Example FAQ

<ResponseField name="Question" type="string">
  "What are your shipping times?"
</ResponseField>

<ResponseField name="Answer" type="string">
  "We ship within 1-2 business days. Delivery takes 3-5 days within Saudi Arabia."
</ResponseField>

## 📋 Standard FAQ Templates for Your AI Agent

Below is a collection of high-probability questions. Use the tabs below to find the category that fits your business. Copy the questions you need and provide your specific details.

<Tabs>
  <Tab title="General Information & Location Questions">
    ### 📍 Location & Contact

    <ResponseField name="Question" type="string">
      Where is your exact location and do you have a physical branch?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Fill in your location, district, and landmarks here. Mention if you are online-only or have a physical store/clinic.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      What are your official working hours and days?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Provide your daily schedule, weekend shifts, and any special holiday hours.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      How can I contact a human representative?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Provide your phone number, WhatsApp link, or email here.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Is there a specific landmark near your location to make it easier to find?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Fill in a famous mall, building, or street nearby.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Is there nearby parking available for visitors?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Describe parking availability or valet services if applicable.]
    </ResponseField>
  </Tab>

  <Tab title="Clinics & Medical Services Questions">
    ### 🏥 Appointments & Specialties

    <ResponseField name="Question" type="string">
      How can I book, reschedule, or cancel an appointment?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Explain the process via the agent, website, or app. Mention the cancellation policy window.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      What medical departments and specialties are currently available at your center?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[List your main clinics, e.g., Dental, Cardiology, Internal Medicine, Pediatrics, etc.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Do you have specialized units for chronic disease management (e.g., Diabetes)?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Explain if you have a dedicated unit or which clinic handles these cases.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Do you offer general health check-up packages?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Provide details on your general screening or 'Executive' check-up packages.]
    </ResponseField>

    ### 🦷 Dental & Cosmetic Units

    <ResponseField name="Question" type="string">
      What specific services are provided in the Dental department?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Mention root canal, veneers, whitening, or orthodontics.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Is there a dedicated department for dermatology and laser treatments?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Specify the available cosmetic procedures or skin treatments.]
    </ResponseField>

    ### 👨‍⚕️ Physician Expertise

    <ResponseField name="Question" type="string">
      Can you provide a list of the leading doctors in each specialty?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[List names and titles of your key physicians, e.g., Dr. \[Name] - Consultant.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Can I request a specific doctor for my appointment?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Explain your policy on selecting a preferred physician.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Do you have female doctors available in the OBGYN department?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Confirm availability of female staff for specific departments.]
    </ResponseField>

    ### 🧪 Diagnostics & Policies

    <ResponseField name="Question" type="string">
      Does the clinic have an in-house laboratory and radiology department?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Confirm if you have X-ray, Ultrasound, or blood test facilities on-site.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      What happens if I arrive late for my scheduled appointment?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Specify your grace period (e.g., 15 minutes) and the policy for late arrivals.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Do you handle emergency cases?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Clarify if you are a clinic or a 24/7 ER facility.]
    </ResponseField>
  </Tab>

  <Tab title="E-commerce & Retail Questions">
    ### 📦 Logistics & Delivery

    <ResponseField name="Question" type="string">
      How can I track the current status of my order?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Zid Logic: "I can track it for you! Provide your order number for live updates from our dashboard."]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Do you offer same-day delivery in my city?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Specify zones: e.g., "Orders in Riyadh before 2 PM are delivered the same day."]
    </ResponseField>

    <ResponseField name="Question" type="string">
      How long does shipping and delivery take to my city?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Specify delivery windows for local vs. regional shipping.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Can I modify my order (add/remove items) after it's been placed?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Clarify the window for changes: "Only if the status is still 'New' or 'Processing'."]
    </ResponseField>

    ### 📏 Products & Quality

    <ResponseField name="Question" type="string">
      How do I choose the correct size for my height/weight?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Sizing Logic: "For Abayas, height is key. 150cm = Size 52. Tell me your height for a suggestion."]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Is the product exactly as it appears in the photos (Color/Fabric)?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Reassure the customer about photography, fabric type, and lighting.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      How should I care for/wash this product?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Provide care instructions like "Dry clean only" or "Hand wash cool".]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Does the item come with any accessories (e.g., a matching scarf)?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Specify what is included in the package.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Will out-of-stock items be restocked soon?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Explain if you have a "Notify Me" feature or restocking cycles.]
    </ResponseField>
  </Tab>

  <Tab title="Restaurants & Cafes Questions">
    ### 🥡 Quality & Packaging

    <ResponseField name="Question" type="string">
      How do you ensure the food stays hot and fresh until it reaches my door?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Explain your specialized thermal packaging or insulated bags.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Is your packaging microwave-safe or suitable for re-heating?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Clarify if the containers are high-quality plastic, foil, or paper-based.]
    </ResponseField>

    ### 🥗 Diet & Health

    <ResponseField name="Question" type="string">
      Do you provide nutritional facts (Calories, Macros)?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Confirm if you list calories on the menu or if the AI can provide them.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Do you offer monthly subscription plans for diet and weight loss?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Detail your meal-prep subscription plans and how to subscribe.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Can I customize my meal to exclude certain allergens (Gluten, Nuts)?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Explain your customization policy for dietary restrictions.]
    </ResponseField>

    ### 🎊 Catering & Economy

    <ResponseField name="Question" type="string">
      Do you offer catering for large gatherings or office lunches?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Mention capacity and lead time, e.g., "Please book 48 hours in advance."]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Are there special menus or "Party Boxes" for celebrations?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Describe your event-exclusive platters or hospitality boxes.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Do you have "Value Meals" or family-sized budget boxes?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[List your economy combos or group savings deals.]
    </ResponseField>

    ### ☕ Cafe & Beverages

    <ResponseField name="Question" type="string">
      Do you offer milk alternatives (Oat, Almond, Soy)?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[List the dairy-free options available at your cafe.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Can I order bulk coffee or "Coffee Boxes" for office meetings?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Explain if you have large thermal dispensers for hot/cold beverages.]
    </ResponseField>
  </Tab>

  <Tab title="Policies & Support Questions">
    ### 💳 Payments & Refunds

    <ResponseField name="Question" type="string">
      What payment methods do you accept?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[List options: Mada, Visa, Apple Pay, Cash, or Bank Transfer.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Do you offer installment plans like Tabby or Tamara?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Confirm if buy-now-pay-later services are integrated into your store.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Do you accept medical insurance? Which companies?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[List the insurance providers you are contracted with.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      I cancelled my order; when will the refund appear in my account?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Give a specific window: "Usually 7–14 business days depending on your bank."]
    </ResponseField>

    <ResponseField name="Question" type="string">
      My payment failed but the amount was deducted. What happened?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Reassure the customer about bank holds and automatic reversals.]
    </ResponseField>

    ### 🔄 Returns & Loyalty

    <ResponseField name="Question" type="string">
      What is your return or exchange policy?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Detail the timeframe (e.g., 7 days) and conditions for returns.]
    </ResponseField>

    <ResponseField name="Question" type="string">
      How can I join your loyalty program or use my reward points?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Explain the integration with your store's loyalty system.]
    </ResponseField>

    ### 🤝 Escalation & Reports

    <ResponseField name="Question" type="string">
      I am not satisfied with the AI's answer. Can I speak to a real person?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Human Escalation Protocol: "Absolutely, you can reach our team via **WhatsApp** at: \[INSERT HUMAN SUPPORT WHATSAPP NUMBER] and one of our team members will respond to you immediately."]
    </ResponseField>

    <ResponseField name="Question" type="string">
      Can I get official documentation (Medical reports / Invoices)?
    </ResponseField>

    <ResponseField name="Answer" type="string">
      \[Explain how customers can receive digital or physical reports and receipts.]
    </ResponseField>
  </Tab>
</Tabs>

## Tips for Building a Great Knowledge Base

<Tip>
  Follow these best practices for the best results:
</Tip>

1. **Start with FAQs** — Add the 10-20 most common questions you receive
2. **Upload catalogs** — Give your agent product knowledge
3. **Keep it updated** — Remove outdated information
4. **Be comprehensive** — More knowledge = smarter agent

## Next Steps

<CardGroup cols={2}>
  <Card title="Customize Widget" icon="palette" href="/guide/widget">
    Make your chat widget match your brand
  </Card>

  <Card title="Connect Integrations" icon="plug" href="/guide/integrations">
    Link Calendly, Zid, WhatsApp, and more
  </Card>
</CardGroup>
