Training AI
Overview
Zaapi’s AI Agent can handle customer messages, allowing your team to focus on inquiries that require human attention. To ensure accurate and helpful responses, training the AI is essential. The AI uses Knowledge Sources and Scenarios to generate responses:
Knowledge Sources – Reference materials such as FAQ documentation, product descriptions, or help center articles that the AI uses to answer customer inquiries.
Scenarios – Step-by-step instructions for handling specific customer situations in a predictable and consistent manner. These can also define when the AI should escalate an issue to a human agent.

How to structure training documentation
Structure Content with AI Agents in Mind
When building a knowledge base for AI, the goal is to make it easy for the model to understand, categorize, and retrieve relevant information. This means optimizing your content’s structure, formatting, and language to align with how AI ingests and interprets data.
Use Clear, Consistent Headings
AI relies heavily on headings to understand the structure and context of your knowledge base.
Use larger text for headings
Every heading should accurately describe the content beneath it. Avoid generic or misleading titles.
Group related content together, and avoid overlapping topics under a single heading.
The AI agent uses these headings as context when chunking content. The more accurate and descriptive your headings, the more likely the AI will surface relevant information during a conversation.
Organize from General to Specific
Structure your content hierarchically:
Start with broad categories, then narrow down to specific actions or scenarios.
This helps the AI understand relationships between topics and retrieve the right level of detail based on the question.
Use Task-Based, Action-Oriented Language
AI performs better when articles are clearly tied to specific user intents.
Use verbs in titles (e.g., Connect your Instagram account, Update business hours).
Front-load keywords—put the most important words at the beginning of the heading or sentence.
This improves match relevance between user questions and content.
Avoid Assumed Knowledge
LLMs don’t inherently understand dependencies between articles unless context is made explicit.
Don’t assume the AI has seen previous content. Link to prerequisite articles or include a brief summary if needed.
Avoid internal jargon or product-specific terms without explanation, especially early in an article or heading.
One Topic per Section
Keep each chunk of content focused.
Avoid combining multiple topics in one section. AI works best when each chunk maps to a single intent or question.
Split complex workflows into separate, clearly labeled steps or articles.
How to use AI across multiple brands
In some cases the knowledge/scenarios might be different between multiple brands. In this case, you will need to tie the specific knowledge source to the relevant messaging channels
For example:
Brand knowledge source 1 = FB page 1, IG account 1
Brand knowledge source 2 = FB page 2, IG account 2
The AI agent will only use the relevant knowledge source that it has been trained on for each specific channel
How to train your AI
Using Knowledge Sources
Access the AI Agent Section – Go to the AI Agent section in the side navigation.
Click on "Knowledge Sources" – This is where you manage AI reference materials.
Fill in the Template – Add all relevant information, ensuring correct heading sizes, no empty cells, and no images (AI cannot process images).
Upload the Knowledge Source – Click "Add Knowledge Source" and give it a recognizable name (e.g., “FAQs”).
Wait for Upload Completion – This may take up to 20 minutes.
Successful – The entire knowledge source was uploaded.
Partial – Only part of the content was added due to character limits.
Failed – The upload was unsuccessful. Review the document format and try again.
Using Scenarios
Go to the AI Agent Section – Navigate to the Scenario Training section.
Click "Add Scenario" – This allows you to create a new AI response pattern.
Define the Scenario Title – Example: "If customer asks for a refund."
Add Trigger Phrases – List variations of customer inquiries that should trigger this scenario, such as:
"I want a refund"
"Can I get my money back?"
"My order didn’t arrive"
Set the AI Response – Choose between:
Following a set of instructions (clear step-by-step guidance).
Escalating to a human agent immediately.
Provide Clear Instructions – Example for a refund request:
Ask the customer when they ordered the product.
Inform them that if the order is over two weeks old, refunds are not possible.
If under two weeks, request a video of the unboxing to verify product condition.
Click "Create Scenario" – The AI will now use this scenario when responding to similar inquiries.
AI Training Limitations
PDF files cannot be uploaded.
Marketplace websites (Shopee, Lazada, TikTok Shop) cannot be scraped as a knowledge source.
AI does not use images in responses.
Regularly refining training content ensures the AI delivers accurate and effective customer support.
Last updated
Was this helpful?