Knowledge Search

Once a Curator publishes an Artifact, it is available for the End User. This Knowledge in the system can be accessed through the Knowledge Search widget, Luma-supported Channel, or through a custom application that uses Luma Knowledge APIs. End-users can search for information using simple phrases or browse through the domains to find Knowledge. The search engine provides an Ontology-based knowledge search based on the user’s question or query.

Luma Knowledge facilitates information search in the following ways:

  • Search Knowledge

  • Explore Knowledge

  • APIs

Search Knowledge

Search Knowledge enables the end-users to find Knowledge efficiently.  An end-user can search for information using a phrase or a question. It is referred to as User Inquiry.

An inquiry is a one or two-sentence natural language description describing the information the user is looking for. It can be a manual search by the user or a request from a supported application driven by the user’s action, such as reporting an issue or submitting a service request.

Luma Knowledge generates ontology from the user’s inquiry, which is compared against the metadata of the Artifacts available in the Knowledge Store. The set of matching Artifacts identified is called the Best Response. The Best Response could contain matching Question- Answer pairs, presented as Precise Answers or a List of Knowledge Articles. If multiple Artifacts associated with different Topics are identified, Luma Knowledge presents the end-user with a series of questions or Topics to help them find the most relevant information. Browsing through the topics, users can view the exact content that answers the query. This is called a Guided Conversation.

In addition to finding Knowledge, the Search Widget is also used to gather feedback on artifacts and content from end-users. This feedback is used to determine the effectiveness of the available Knowledge in the system.

Search Widget can be embedded into your ITSM tools like ISM or any other 3rd party application. It can be added to the application as a Widget to search Knowledge available in the Luma Knowledge database.

Information found in the Luma Knowledge can deflect a support ticket or prevent the transfer to an agent performed in real-time.

When an Inquiry is made, the system performs a Knowledge Search on the available artifacts and returns the Best Response. Luma Knowledge executes the below steps to search for the information:

  1. Parse the inquiry and normalize terms to determine action words, nouns, and subjects to understand the user’s intent. Metadata Topic, Subject, Action, and Motivation are identified from the user’s request.

  2. Perform an ontology search in Luma Knowledge databases

  3. Determine and return the best response

  • The search queries should be well-structured so that Luma Knowledge can extract appropriate metadata from the query and identify matching Artifacts.

  • Knowledge search in the system is performed based on the preferred search algorithm, configured for your tenant. For more information, refer to Tenant Configurations | Search.

Identifying Matching Artifacts

Luma Knowledge uses various search algorithms to identify relevant artifacts. As an administrator, you can configure how the search is performed for your tenant:

Metadata Search (Dynamic):

The Metadata search in Luma Knowledge uses ontology to perform the search. This method is also referred to as Dynamic Search.
When using the Metadata search algorithm, the system generates metadata or ontology from the user phrase, which is then used to compare and find the Artifacts with the matching metadata. The system looks for Artifacts (Question-Answer pair and Artifacts) with similar Topics, Subjects, Actions, and Motivation and calculates Relevancy and Confidence scores for each matching Artifact.

The relevancy Score determines how relevant is the Knowledge Artifact to the user’s question. This is a relative score and is calculated based on the best-matching Artifact. All the matching Artifacts that fall in a specific Relevancy score range are considered the Best Response or result for the user’s request. The Relevancy score range is derived from the Tenant configuration, Score Range percentage.

Description

Default value

Description

Description

Default value

Description

Score Range Percentage

60

Represents the relevance score range for the best response. The system uses the set percentage to calculate the relevance range. All artifacts that fall within the range are considered as Best Response.

For example, If the Score Range percentage for your tenant is set to 60 and the highest Relevancy score of an Artifact for your search is 100, the system calculates the lowest permissible Relevancy score as 60 (that is 60% of 100). This means the artifacts that fall between the range of 90 and 150 are considered relevant and presented as search results.
Increase the percentage to increase the artifacts in the result set.

Confidence Score is calculated based on the matching metadata found in the artifact. It indicates how confident the system is that the Knowledge Artifact answers the user’s query. In Luma Knowledge, each metadata type is assigned a pre-defined confidence weightage. As matching metadata is found, the respective score is awarded to the artifact. More the number of matching metadata, the higher the confidence score. For more information, refer to Calculating Confidence score

The Topic identified from the user’s query is used to filter Artifacts with matching Topic as well as Subject. This ensures that the end-user is presented with all matching Artifacts.

Advanced Search:

Advanced Search in Luma Knowledge uses the trilateral approach to identify the results for a user query. In addition to the Metadata search, the results are enhanced using the Key phrase search and Full-text search.

Key Phrase search in Luma knowledge is based on the KeyBERT algorithm. It is a keyword extraction technique that leverages BERT embeddings to create keywords and key phrases that are most similar to a document. Luma Knowledge uses the keyword extraction technique to match the available Knowledge to the user query. Whenever an Artifact is curated, the system automatically generates Keywords for the artifact based on the Knowledge content. Similarly, Keywords are identified from the user’s search queries. These keywords are matched against the Knowledge Articles, and relevant data is identified.

Full-Text Search is ideally the fallback option taken by the system in case either Metadata Search or Key Phrase generates appropriate results. In this case, Luma Knowledge searches for the requested information in the complete artifact. Any Artifact with information similar to the user query appears in the search result. This type of search ensures that Luma Knowledge can find search results even if the Metadata or Keywords are not correctly created. You may update the tenant configuration to filter the results presented in the case of a Full-text search.

Displaying Search Results

Once the Best Response is identified, information is presented to the end user. The Best Response may contain matching Precise Answers or a List of Knowledge Articles. The identified results are presented based on the following Tenant level configurations. These configurations determine which Artifacts are presented and how the Artifacts are presented, in a list or a guided conversation. For information, refer to Tenant Configurations.

Description

Default value

Description

Description

Default value

Description

Maximum Artifacts per Query

30

Indicates the maximum number of the artifacts that can be returned as Best Response.

Maximum decision levels

3

Indicates the number of the decision levels or questions Luma Knowledge may ask to locate the Artifact, in case the Best Response is a guided conversation with various Artifacts and Topics.
Increase the count to increase the decision levels in the result set.

Maximum Topics per Decision Level

12

Indicates the number of topics that can be listed per decision levels in the Guided Conversation . The count determines the options that can be presented at each decision level in a guided search.
Increase the count to reduce the decision levels in the result set.

Maximum Artifacts per Topic

10

Indicates the number of artifacts that can be listed under a topic in the result. The count impacts the decision levels presented in a Guided conversation. Increase the count to reduce the decision levels in the result set.

How to Search for an Artifact

To search for an Artifact,

  1. Click on the Knowledge Search.

  2. On the Search tab, type the phrase or query in the search box and press Enter.
    For example: “How to apply for Credit Card”, “SLA”, “How to setup a network file system?”, etc.

    A curator can search for Published or Latest versions of artifacts.

    1. Select Published to search and view the last Published version of Artifacts.

    2. Select Latest to search and view the latest version of the Artifacts. The latest version of an artifact may not be the same as the Published version. When a Published Artifact is checked out by a curator for editing, the latest version refers to the checked-out version and not the last published version.

  3. Based on the metadata identified from the phrase, the system generates the Best response. The query may result in:

    1. The query returns only Artifacts.

      • If the system identifies one or more artifacts as the Best Response for the user’s inquiry and the number of Artifacts returned is lesser than (or equal to) the ‘Maximum number of artifacts per topic’ set for your tenant.

      • The system represents the result as a linear list of artifacts.

      • End-User can navigate through the list to locate the Artifact.

      • Select the required Artifact or FAQ to view content.

    2. The query returns multiple Artifacts and Topics.

      • When the Best Response to a query:

        1. returns multiple artifacts under different topics

        2. count of artifacts returned is lesser than or equal to the ‘Maximum number of artifacts per topic’

      • Luma Knowledge generates a decision tree with the Artifacts and the hierarchy of topics. Artifacts are listed in a Linear tree and are grouped by topics.

      • End-Users can browse through topics to locate the required Knowledge. The system aims at creating a Linear tree structure that provides the user with a simple and clear view of Artifacts and related Topics.

        In the below example, the user search ‘How to setup network file system’ returns multiple artifacts related to various topics. Luma Knowledge generates a list of artifacts, grouped under related topics. Click on the relevant articles to view details.

    3. The query returns User guidance.

      • When the Best Response to a query :

        1. returns multiple Artifacts under different topics

        2. count of Artifacts returned is greater than or equal to the ‘Maximum number of artifacts per topic.’

        3. count of topics that contain the artifacts is greater than the ‘Maximum number of topics per decision level.’

      • Luma Knowledge generates user guidance that allows users to navigate the decision tree to locate the required Artifact. This is called Guided Search.

        For Example: In the below example, for user request ‘How to reset my password?’ Luma Knowledge returns multiple Artifacts related to various topics under domains ‘Software’ and ‘Finance’. In such a case, the system generates a guided search.

      • Select the relevant topic to view the list of related Artifacts.

      • Click on the required Artifact to view the details.

         

    4. Too many artifacts were found: A message indicating that “Too many answers! Please refine the query for better results. “.

      • When identified Artifacts, are more than the ‘Maximum number of artifacts to be returned’ set for your tenant.

      • In such a case, the system presents the allowed number of artifacts set in ‘Maximum number of artifacts to be returned.’

      • Users are encouraged to rephrase the query to narrow down the search.

    5. No Result: A message indicating that “No artifacts were found. “

      • When Luma Knowledge cannot generate metadata from the user search phrase or cannot find a matching artifact, the system generates no result.

      • In such a case, the system does not present any result.

      • Users should rephrase the query to narrow down the search or identify matching artifacts.

Explore Knowledge

Explore Knowledge enables the end-users to view the information available in the system when they do not have adequate data or specific query in mind. This functionality gives the end-user ability to explore any domain and topic to locate the required Knowledge Artifact.

Explore Knowledge can be used when:

  • The end-user wants to explore the available Knowledge in the system.

  • Luma Knowledge identifies too many results, and the end-user does not have information to refine the query.

  • Luma Knowledge is unable to identify the required Artifact based on the user’s question.

  • The user query is incomplete and does not generate enough metadata for Luma Knowledge to search for Artifacts.

  • The end-user is unsure about the related Domain or topic.

In any of the above scenarios, you can use the Explore Knowledge option to browse through the domains and related topics in the Knowledge Graph to view the available Knowledge artifacts. To use Explore Knowledge,

  1. Click on the Knowledge Search.

  2. Click on the Explore tab on the Knowledge Search Widget. All the domains available in the system are listed here as Tiles. This is referred to as Level 1 (L1).

     

  3. Each domain tile provides the Domain summary i.e., a quick view of:

    1. Domain name

    2. Domain Description

    3. Count of Topics under the Domain

    4. Count of total artifacts related to the Domain. The count includes the artifacts related to every topic in the Domain.

    5. Count of QnAs related to the Domain. The count includes the QnAs related to every Artifact under the Domain.

  4. You may now click on the required Domain and view the related topics and Artifacts in the next level. Alternatively, you can type a ‘Domain’ name in the search box and view the details.

  5. The next level lists the sub-topics directly related to the Domain. This is denoted as Level 2 (L2). As you traverse through the Knowledge graph, the level increases. At each level, you can see the summary of the previous levels.

  6. Click on the required domain tile to view the Articles or Subtopics underneath. You can also type an artifact or sub-topic name in the Search box to view the related details. This is a contextual search i.e., Luma Knowledge will search for the requested subtopic or Artifact only under the selected Domain (selected in step 4).

  7. Select the topic to view the related subtopics or artifacts.

  8. You may continue to browse through the subtopics underneath (if available) or select one of the available artifacts to view the contents.
    Select the required Artifact to view details and related QnA pairs in the widget.

  9. Click on the back button to go back to the Artifact list. You can continue exploring the Knowledge Graph and view as many Artifacts as required.

  10. Similarly, you can go back to the previous levels in the Domain by clicking on the domain or topic name.

Feedback

A key feature in Luma Knowledge is the continuous artifact improvement process, which is achieved through Users’ Feedback. Feedback is obtained directly from End-users. The information gathered is used to derive the effectiveness and usefulness of the content available in the system.

The system collects two types of feedback from users:

  • Explicit Feedback

  • Implicit Feedback

Explicit Feedback:

Feedback provided by the end-user through the options available on the Search Widget is called Explicit Feedback. Luma Knowledge collects the feedback in the below scenarios:

  • Best Response Feedback: This is the user’s feedback on the Best Response identified for an inquiry. If the end-user finds the results are not useful, the system allows users to register their feedback using the “Recommend New Content “option. Luma Knowledge uses this feedback and the tenant configurations to derive the User Feedback - Ineffective Best Response KPI metric.

  • Artifact Response Feedback: This is the user’s feedback received on the Knowledge accessed by the user from the Result set of a user inquiry. When a user opens an Artifact or FAQ, the system presents a feedback option in the form of simple feedback questions to validate the suitability of the content in the Artifact

    Question 1: Did the Artifact answer the user’s question/problem (Yes or No)?

    if the response is “No
    Question 2: Was the Artifact understandable (Yes or No)?
    Question 3: Did the Artifact’s topic match the original knowledge request (Yes or No)?

The feedback, along with the tenant configurations, is used to derive the User Feedback - Ineffective Artifact KPI metric.

Implicit Feedback:

Implicit feedback is formulated by the system based on users’ actions (or inactions) against the search results for a user inquiry. The system derives the feedback based on the user’s interaction with Luma Knowledge. For example,

  • Luma Knowledge does not return a result for the user inquiry.

  • If the user does not view or access Artifacts identified as the Best response for a user inquiry.

This information gathered by the system is used to derive various KPIs metrics on the dashboard. For more information, refer to the Luma Knowledge Dashboard.