Knowledge is what bees use to reply to clients: services, prices, frequent questions, rules and topics that must not be discussed. The fuller and more accurate the knowledge, the less often the bee calls a manager and the fewer edits its drafts need. Knowledge lives on the "Knowledge" tab of the "AI Office" section, and the bee itself helps you add to it by suggesting rules from your replies to clients.
What knowledge consists of
Each entry has a title, a text, a type and a set. The type tells the bee how to use the entry:
| Type | What it is for | Example title |
|---|---|---|
| "Q&A" | A frequent client question and the correct answer to it. | Do you deliver within Almaty |
| "Service" | A description of a service or product: what is included, price, timing, terms. | Manicure with gel polish |
| "Rule" | How the bee should always behave, in any conversation. | Bookings only after prepayment |
| "Restricted topic" | Something the bee does not discuss and passes straight to a manager. | Wholesale discounts |
Sets: who sees which knowledge
| Set | Who reads it |
|---|---|
| "General" | All bees: sales, support and director. |
| "Sales" | Sales and support. |
| "Support" | Support only. |
At the top of the tab there are counters "Sales sees", "Support sees" and "Director sees": how many enabled entries each role can use. If the sales bee has few entries, it will call a manager more often.
How to add an entry
- Open the "AI Office" section and go to the "Knowledge" tab.
- Click "Add entry". The "New knowledge entry" window opens.
- In the "Title" field write briefly what the entry is about, ideally the way a client asks. This field is required.
- In the "Set" field choose "General", "Sales" or "Support".
- In the "Type" field choose "Q&A", "Service", "Rule" or "Restricted topic".
- In the "Text" field write the answer, description or rule itself.
- Click "Save". You will see "Saved", and the entry appears in the list.
📎 Photos, videos and documents: the bee sends them to clients
You can attach a product photo, a video review, a PDF price list or a catalogue to any knowledge entry. When a client asks to see a product or to send a photo, video or price list, the bee picks the right file and sends it right after the text of its reply.
- Open the "Knowledge" tab and click "Edit" on the entry. For a new entry, click "Save" first: the window stays open and the "Photos, videos and documents" block appears in it.
- Click "Add file" and choose one or several files.
- In the "What the file shows" field, describe the file, for example "Milan sofa, grey, front view". The bee decides which file to send based on this description, so keep it clear.
- The description saves automatically when you move to another field or press Enter.
| What | Formats | File size |
|---|---|---|
| Photo | JPG, PNG | up to 5 MB |
| Video | MP4 | up to 16 MB |
| Document | PDF, Word, Excel, PowerPoint, TXT | up to 20 MB |
- Up to 10 files per entry and 500 MB per account. The space used is shown under the file list.
- In the knowledge list, an entry with files shows the "Files: N" label.
- Delete a file with the bin button next to it. If you delete the whole entry, its files are deleted too.
How the bee sends files
- The bee sees the files of the entries it found for the client's question and of the entries it always remembers. It sends no more than three files per reply.
- Auto reply: the files go to the client right after the text.
- Draft: under the draft text you see "These files will be sent with the reply:". The files go when you click "Send" or "Send with edits". If you reject the draft, the files are not sent.
- The bee sends photos and videos to WhatsApp, Telegram, Instagram and Facebook Messenger, and documents to WhatsApp, Telegram and Facebook Messenger. Files are not sent to OLX.
- In the official WhatsApp, files, like text, are sent only while the 24-hour window is open.
How to edit, switch off or delete an entry
- Edit: click "Edit" on the entry, and the "Edit entry" window opens. Make your changes and click "Save".
- Switch off: use the "Entry enabled" switch on the entry. Bees do not see a switched-off entry, but it stays in the list. Handy for seasonal offers and temporary terms.
- Delete: click the trash button and confirm in the "Delete this entry?" window. Deletion cannot be undone.
- Find: the "All sets" and "All types" filters above the list show only the entries you need.
How the bee uses knowledge
- The bee always keeps in mind the "Company brain" from its settings and all entries of the "Rule" and "Restricted topic" types, in every reply.
- The bee searches "Q&A" and "Service" entries for the client's specific question: by meaning and by exact words, so that codes, names and numbers are found. A few of the best-matching pieces go into the reply.
- Long text is split into pieces by paragraph, and each piece gets the entry title. That is why the title should make sense on its own.
- After saving, an entry is prepared for search automatically, usually within a few minutes.
- If the knowledge base has no direct answer, the bee does not make one up but hands the conversation to a manager.
- The bee names only the prices, discounts, amounts and deadlines that are in the knowledge base.
How to write knowledge so the bee answers accurately
- One entry, one topic. Do not mix delivery, payment and warranty in one text.
- Title as a client question: "How much is delivery within Almaty", not just "Delivery".
- Exact figures: write prices, deadlines, addresses and terms in full. The bee repeats them word for word.
- Separate paragraphs with an empty line: one idea per paragraph. That way search brings the bee the right piece rather than the whole text.
- Write what you do not offer too: "We do not deliver to other cities", "No instalments". Otherwise the bee has nothing to say and calls a manager.
- No client personal data: all your bees can see the knowledge.
- Make permanent things a rule: for example, "We do not promise a discount without the manager's approval".
- Keep it up to date: fix or switch off outdated entries right away.
An example of a good "Service" entry:
Title: How long a manicure with gel polish takes and what is included
Text: A manicure with gel polish takes about 1.5 hours. Nail art is paid separately.
Removing the old coating is included if the coating was done at our studio.
How the bee introduces itself and what it calculates
By default the bee writes to clients as a real company employee and does not call itself a bot or AI. If you want clients to know they are talking to an AI assistant, add an entry of the "Rule" type and state exactly how to introduce itself. For example:
- Title: First message: introduce yourself as an AI assistant
- Text: In the first reply of a new conversation, say that the company's AI assistant is here, and add: "If my information is not enough, type the word "manager" and I will invite a manager right away". If the client types "manager", hand the conversation over to a manager.
Calculations by formula
If a rule describes a calculation by formula, the bee follows it. The daily calorie norm by the Mifflin–St Jeor formula is calculated by the service itself, without AI: it takes the client's age, height and weight from the chat, calculates the norm for every activity level and goal, and gives the bee ready numbers. The bee only picks the row for the client's sex, activity and goal. The calculation turns on when the rule text mentions the Mifflin–St Jeor formula. Goal adjustment: weight loss minus 18%, maintaining shape unchanged, muscle gain plus 12%.
To make the bee name the program right away, list the program boundaries in the same rule, each on a separate line, like this:
- до 1150 ккал: Light - 1160–1450 ккал: Slim - 1460–1770 ккал: Balance - от 2460 ккал: Strong
Write these lines in Russian exactly as shown: «до», «от» and «ккал».
"Suggested from chats": the bee learns from your replies
When a person answers a client better than the bee, the bee suggests a rule based on it. This happens in three cases:
| Label on the card | When it appears |
|---|---|
| "You replied instead of the draft" | The bee's draft was waiting, and you wrote your own reply to the client. |
| "You edited the draft" | You sent the draft with edits. |
| "The bee handed the chat to you" | The bee handed the conversation over, and you replied to the client. |
The bee reviews the case itself: it removes the specific client's details (names, phone numbers, order numbers, amounts) and turns the answer into a general rule for similar questions. One-off replies such as "one moment, let me check" or agreements about a call, and short replies like "ok" and "thanks", are discarded. Reviewing each case also uses honey.
- Open the "Knowledge" tab. If there are suggestions, the "Suggested from chats" block is at the top. If there are none, the block is not shown.
- The card shows what "The client asked", what "You replied" and the "Rule for the bee" with a title and text.
- Read the rule. If needed, edit the title and text right on the card and choose the set.
- Click "Accept". The rule goes into the knowledge base straight away as a "Q&A" entry.
- If you do not need the rule, click "Discard". The suggestion is forgotten.
Frequently asked questions
I added an entry, but the bee still answers the old way. Why?
Check three things: the entry is enabled, its set matches the bee's role (the sales bee does not see the "Support" set), and a few minutes have passed since saving while the entry is prepared for search.
How is the "Company brain" different from knowledge?
The "Company brain" is a short description of the business in a particular bee's settings, and the bee always reads it. Knowledge is the detailed base on the "Knowledge" tab, shared by all bees, from which the bee takes what fits the question.
Can I upload knowledge from a file?
The bee answers based on the entry text: copy the text from the file into the "Text" field, and split a long document into several entries by topic. Attach the file itself (price list, catalogue, photo, video) to the entry in the "Photos, videos and documents" block, and the bee will send it to the client on request.
What does a "Restricted topic" do?
If a client asks about a topic from this list, the bee does not answer it but says it will pass the question to a manager, and hands the conversation over.
Where did a suggestion from a chat go?
After "Accept" it becomes an entry in the knowledge list, after "Discard" it disappears for good.
I wrote in knowledge how to greet clients, but the bee doesn't greet that way. Why?
Most likely the entry has the "Q&A" type: the bee takes such an entry only when the client's question is similar to it. Change the type to "Rule", and the bee will keep it in mind in every reply.
A client asked for today's menu. Where does the bee take the dishes from?
From the «Menu» section of your CRM. The bee sees the menu for today and tomorrow for the program in the client's deal and names the dishes word for word. If the client has no deal yet, it checks the menus of all programs and asks which program is meant when needed. If the menu for that day is empty, the bee names no dishes and calls a manager. Fill in «Menu» in advance, there is no need to add it to knowledge separately.
