What you are looking for
Some questions will always come back unanswered — a topic nobody wrote up, a detail that changes too often for an article, a way of phrasing something your content never uses. Those are knowledge gaps, and they are the cheapest improvements available to you: each one you close removes a whole category of unanswered questions, not just the one that was asked.
Where to look
Two screens, both under your brand:
- Brand → AI agent → Reports — the figures, plus a browsable list of every individual answer the agent has given, with filters and per-answer detail. If you remember a separate "AI Responses" screen, this is where it went; it is now the bottom half of this one page.
- Brand → AI agent → Suggestions — the pattern analysis, where the AI reads through the failures and tells you what keeps coming up.
Reading the figures on Reports
Pick a date range (top right) and you get three tiles, each with its share in large type and the count underneath, such as 12 of 40 questions:
- Successful — of the real questions asked, the share Yaplet handled: answered from your content, connected a person who was asked for, or ran a workflow. Small talk is not counted.
- Failed — real questions Yaplet could not answer: missing knowledge, a hand-off it chose itself, or an error.
- Small talk — messages that asked nothing at all: greetings, thanks, acknowledgments. They are shown as a share of all messages and are left out of the other two rates.
Below them is Conversations handled by Yaplet — the ones that needed no one from your team — and below that Answers, the full list of every answer, with a Question and an Answer search and an Outcome filter.
Because small talk is kept out, the success rate reflects real questions only: a friendly bot that gets a lot of "hi" and "thanks" is not marked down for it.
Getting the pattern analysis
Open Brand → AI agent → Suggestions and press Generate suggestions (once a report exists, the button reads Generate new report). It reads the latest unanswered or escalated questions since your previous analysis, groups them by theme and writes up the ones that recur most. It needs at least 10 new ones since last time, so there is genuinely something to find. Questions where the visitor simply asked for a person are left out on purpose — that is routing, not a gap in what you know. Generating a report is paid like other AI work; reading reports you already generated is free.
Each past analysis stays on the page as a card titled Suggestions report, with the date it was produced, so you can see whether a gap you closed has actually stopped coming up.
What to do with a suggestion
- A missing topic → write the article and publish it. Publishing indexes it immediately — no chatbot to sync, no widget involved, nothing to re-import. It is answerable from the moment you press publish.
- A topic that exists but is too thin → deepen the article. These show up as questions where Yaplet cited the right page and the visitor still escalated.
- A question about live data → add an API tool. Order status, stock, an account balance: no article can stay accurate. API tools live on Brand → Knowledge, in the API tools group (add one with Add knowledge → API tool), and the Description you write is what the AI reads to decide when to call the tool, so describe the situation rather than the endpoint.
Then leave it a week or two and run the analysis again. A category that disappears is a category you fixed.
The short version at the top of Brand → AI agent
You do not have to go looking. The top of every section of Brand → AI agent shows how Yaplet did over the Last 30 days: Questions, Answer rate and Handed to a person. If the answer rate drops or the number handed to a person climbs, a new gap is probably opening up — open Suggestions or Reports to see which questions it is.
This history belongs to the agent
Conversation starters, suggestions and report history all belong to the AI agent, so deleting the agent removes them. Your knowledge is untouched — knowledge bases, documentation, files, website pages, question-and-answer entries and products belong to the brand and stay exactly as they are.
Next step
Once you have written new articles, check that Yaplet is pointing people at them properly: Yaplet citations — how it points users to source articles.