As mentioned in the previous post, we will be building an FAQ bot which will answer questions about API.AI. So the first thing we need is a resource from where we can get answers about API.AI – and we have one ready: the API.AI documentation.
Preparing the FAQ list
We will look at the different sections in the API.AI documentation, and generate a list of questions that users may have about that section. Since this is for learning purposes and not meant to be exhaustive, we will only consider the high level ideas. We can easily gleam the key concepts by looking at the structure of the API.AI documentation. Here is what the documentation looks like:
For each section under Key Concepts, we will have atleast one FAQ answer. Our goal here is to anticipate what questions should direct users to which answers (sections) on the documentation.
So we will collect each section that can be a standalone answer, and make a list of links in a table. This is what this list looks like for me:
|Link||Ideas for FAQ questions|
|https://docs.api.ai/docs/concept-agents#agents-overview||What are agents in API.AI?
What are API.AI agents?
What is an agent in API.AI?
|https://docs.api.ai/docs/concept-agents#agent-settings||How to change agent settings in API.AI?
How to change bot settings in API.AI?
How can I change the settings for an API.AI agent?
|https://docs.api.ai/docs/concept-agents#export-and-import||How to export data out of API.AI?
Can I export my API.AI agent?
How to import an API.AI agent?
How can I import a bot into API.AI?
|https://docs.api.ai/docs/concept-agents#export-and-import-to-integrate-with-some-known-app||Can I integrate API.AI bot with Cortana?
Can I integrate API.AI bot with Alexa?
How to get API.AI to talk to Alexa?
|https://docs.api.ai/docs/machine-learning||What is machine learning in chatbots?
How does machine learning work in chatbot agents?
What is the role of ML in chatbots?
|https://docs.api.ai/docs/concept-entities#overview||What are API.AI entities?
What do entities mean in API.AI?
API.AI definition of entities
Define entities in API.AI
As you can see, the list of links and FAQ questions is not comprehensive. But the idea is straightforward: for each resource (i.e. a link on the left column of the table) you will be anticipating possible questions and adding them into the corresponding FAQ questions in the right column of the table.
In the next post, we will look at understanding intents based on the FAQ list we prepared.