Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Another general best practice is to think of questions that include the topic and relationship. In situations where you have a question that does not contain the topic and relationship in the question, there may be an opportunity to include words from the question into the synonyms for the topic or relationship.

...

Organizing your Knowledge Base

Using a spreadsheet will make it easier to build and organize your knowledge base.

...

  1. For each topic, define a set of synonyms capturing the various ways someone might refer to the topic (e.g. Anaphylaxis → “severe allergic reaction,” “anaphylactic shock,” etc.)

  2. For each relationship, define a set of synonyms for the same purpose (e.g. Treatment → “remedy,” “therapy,” etc.)

Best

...

Practices for

...

Naming Topics

  • A topic is a word or phrase (most likely be a noun, noun phrase, proper noun, or compound noun).
    Example: Sunburn

  • A topic name doesn’t necessarily need to be a word in a dictionary. It could be a business name, brand name, product name, etc.

  • A topic name should be the singular form of the noun (e.g. Chemical Burn vs Chemical Burns). Orbita handles lexemes (burns, burning, burned, etc.)

  • There are cases where a topic might be a verb (e.g. Eat) and should be the dictionary form of the word (e.g. Eat, rather than eats, eating, ate. This form is also called the lemma form).

  • A topic can be an acronym (e.g. COPD). When specifying an acronym, use single letters with no spaces.

  • A topic may contain multiple concepts (e.g. Cancer and Hunger) but generally should focus on a single concept (e.g. Cancer, Hunger). A best practice is to think about the questions people will ask – if someone is likely to ask about each concept separately, make it two topics. If they’ll ask about two concepts in the question (e.g. Will I lose my appetite during cancer treatments?), it’s okay to have a topic with two concepts.

Best

...

Practices for

...

Naming Synonyms

  • A synonym is a word or phrase that means exactly or nearly the same as the topic (most likely be a noun, noun phrase, proper noun, or compound noun).

  • A synonym should be the singular form of the noun (e.g. Chemical Burn vs Chemical Burns). Orbita handles lexemes (burns, burning, burned, etc.)

  • A synonym should reflect the way people express topics conversationally and will not necessarily be a synonym that exists in a dictionary for your topic (e.g. severe allergic reaction or covered in hives may be synonyms for the topic anaphylaxis). Research ways people refer to concepts conversationally by looking at web search logs, call center logs, talking with customer support, etc.

  • A synonym should consider the question someone might ask about the topic. E.g. Assume a knowledge base of First Aid content, where a topic/relationship is Anaphylaxis/Causes. Consider the question What causes severe hives? ”severe hives” would be a synonym for Anaphylaxis

  • A synonym name doesn’t necessarily need to be a word in a dictionary. It could be a business name, brand name, product name, etc.

  • A synonym name can be an acronym. When specifying an acronym, use single letters with no spaces (e.g. COPD)

  • A good synonym reflects ways people refer to the concept conversationally.

...

Defining a Knowledge Base in Orbita

With Using your spreadsheet as a guide, you’re now ready to create your Knowledge Base in Orbita.

Create a New Knowledge Base

In Experience Manager, select your project, then:

...

From the list of Knowledge Bases, click and open your newly created Knowledge Base.

...

Create Your First Fact

To add a fact, click click on the (+) icon.

If you have many facts referencing the location and hours for the cafeteria, you can use tokens in the facts to save time and energy. If the information changes, you need only change the value of the token in the Content area. For more information, see How to use Tokens?

The UI that you see below is defined by the schema that you select while creating a Knowledge base.

...

  • Say Text. Enter the content that answers the question.

  • Reprompt. Enter a follow-up comment.

  • Description. Enter a description that Google will index for search engine optimization (SEO).

  • Flow Selector. Click the field and select an item from the list.

  • Thumbnail. Enter the URL to the image you want displayed with the answer.

  • Feature image. Enter the URL to the image you want displayed with the answer.

  • Topics. Enter a topic name of an existing topic, or enter a new topic name to create it.

  • Relationships. Enter a topic name of an existing topic., or enter a new relationship name to create it.

Defining synonyms

If someone can refer to any of your topics by other names, you should list them in the Topic Synonyms tab.

  1. Open the Topic Synonyms tab. The following image shows that Cafe and Restaurant are already defined synonyms for Cafeteria.

    Image Removed
  2. Click Add topic Synonym and enter Bistro (or Grill, Eatery, Lunchroom, a place to eat or other synonyms) to the list. Make your synonym list robust to ensure the best natural voice recognition and responses.

    Image Removed

Defining a related topic

  1. Open the Related Topics tab.

  2. Click Add (+) to add a related topic. For example, enter Vending Machine as a related topic to Cafeteria.

    Image Removed

    Vending Machines appear on the list.

    Image Removed

Your database topic list grows as you add and define the topics, relationships, interrogation, and Facts.

See also How do I set up and use Answers?

Defining a topic

  1. After you log in, select your project from the Recent Projects list. If you do not see your project click See All Projects.

  2. In the left menu, select Create > Agents > Answers.

    Image Removed
  3. Select the database from the Knowledge Bases list. This example uses the Demo database. The Demo database shows Facts, Interrogative, Topics, and Relationships tabs that list each. The following image shows the Topics tab with a list of topics and their relationships. and any related topics.

    Image Removed
  4. To create a new topic, click on the "Topics" tab and click Add (+). The following image shows how to add a Gift shop to the list of topics.

    Image Removed

Defining a relationship

...

The Relationships tab shows the relationships (Proximity, Location, Hours).

...

To create a new relationship, click Add (+).

The following image shows a list of relationships.

...

Adding an Article

  1. On the Answer tab, enter the article content into the Multi-modal Content Editor

...

Adding a Topic

2. Enter the name of the topic in the Topics field. You’ll be able to select existing topics once they have been created.

3. Click “OK” when prompted. For example, if you create a topic for Sunburn, the following prompt will appear.

...

4. Click the Synonyms icon to specify alternative names for your topic. For example, “sunburn” might be referred to as “sun poisoning.” (e.g. What are the signs of sun poisoning?)

...

Adding a Relationship

5. Enter the name of the relationship in the Relationships field. You’ll be able to select existing relationships once they have been created.

6. Click “OK when prompted. For example, if you create a relationship for Treatment, the following prompt will appear.

...

7. Click the Synonyms icon to specify alternative names for your relationship. For example, “treatment” might be alternatively referred to as “remedies” or “home remedies” (e.g. What are home remedies for the flu?)

Info

Repeat this process for all the facts in your spreadsheet

Managing a Knowledge Base in Orbita

Viewing a List of All Topics

  1. From the list of knowledge bases, find the desired knowledge base and click its action menu icon (three dots on the right of the row)

...

2. From the action menu, select Settings

...

3. From the Settings screen, you can click the “Topics” to see a list of topics or relationships.

...

Info

To see a list of relationships, click on the “Relationships” tab from the same screen

Adding a Related Topic

Topics can be related to one another. For example, you might have a topics for Asthma, Bronchitis, Pneumonia, and COPD. Because these topics all deal with lung disease, you might want to relate them to one another.

  1. Follow the steps above for “Viewing a List of All Topics”

  2. Find the desired topic from the list

  3. Click the topic’s action menu icon

  4. Choose Edit from the menu

...

5. Open the Related Topics tab.

6. Click Add (+) to add a related topic. You must select an existing topic from the list.

...

Your related topic now appears on the list of related topics

...

See also How do I set up and use Answers?

Related Articles

Filter by label (Content by label)
showLabelsfalse
max5
showSpacefalse
cqllabel = "answers"