Knowledge Store

Knowledge Store is the collection of Artifacts available in Luma Knowledge. Every Artifact, created manually or using the predefined Templates, is listed in the Knowledge Store. Once the Semantic Analysis is successfully run on the Artifact and Ontology is generated, the Artifact starts appearing here.

An Artifact in the Knowledge Store undergoes the following phases:

Once an Artifact is successfully curated in Luma Knowledge, it appears in Draft state. The Curator can review and publish the Artifact. The Artifact state is changed to Published and it is available for End Users. It now appears in search results. If the Artifact is not used or the knowledge is obsolete, Curator can Retire the Artifact. Once the Artifact is marked as Retired, it does not appear in search results for end-users. The curator can Check out and update the artifact content or can permanently Delete the Artifact if the details are incorrect. For more details, refer Edit and Publish Artifact section below.

  • Drafts represent Artifacts curated in your tenant that are pending for review and Publish. These Artifacts are not available for End Users.

  • Published represents all Published Artifacts available for your tenant.

  • Retired represents all Artifacts that have been retired by the Curator. These Artifacts are temporarily unavailable for End Users. The curator can update and Publish the artifact.

  • Deleted represents the Artifacts permanently deleted by the Curator.

A Curator is responsible for managing and Publishing Knowledge Artifacts in Luma Knowledge. Knowledge Store is used to review and manage Artifacts, FAQs, Source information, Metadata, and Ontology details.

Navigate to the Knowledge Store tab to view the knowledge base available in your Tenant.

The Artifacts in the Knowledge store are available in two views:

List View: This is the default view in the Knowledge Store. In addition to the graph view, all the Artifacts curated for your tenant are listed here. Use the Navigation button to view the full grid or graph view.

You can filter and sort the list on the available columns. Following are the details available in the view:

  • Artifact ID: The unique sequence number assigned to the Artifact, once it is created in Luma Knowledge.

  • Artifact Name: The Artifact name assigned during Artifact creation

  • Modified Date: The last Artifact modified date

  • Source: This is the base document, URL, or Template used to create the Artifact in Luma Knowledge. If the Artifact created using a Document or Web URL, you can click on the Source link and view the source document.

  • State: Indicates the current Artifact status.

You may also double-click on any of the nodes in the graph to filter the list accordingly.

Card View: Click on the Card View to view the Artifacts in card format. Scroll through the page to find and view the artifacts. You may double click on any of the nodes in the graph to filter the view accordingly.

Filter and Search Artifact

Luma Knowledge allows Curators to create Simple Filters and search for the required Artifacts. These filters can be configured and saved for future use. To create a filter, follow the below steps:

  1. Click on Filter.

  2. The Simple filter section lists the already saved filters. You may select and apply one of the existing filters or create a new filter.

  3. Click on New.

  4. Add the required criteria such as Domain, Topic, Creation date, or State.

  5. To save the filter for future use, add the Filter name and click Save.

  6. Click Apply filter.

  7. The Artifact list is filtered based on the applied filter criteria. You may also search for an Artifact by Title or Summary.

  8. Select the required Artifact to view the details such as Summary, Content, QnA pairs (FAQs), and Artifact Metadata in Quick View.

  9. Click on Artifact ID to view the Artifact Detailed view. Here you can review and update the Artifact as required. The screen is divided into below sections:

View Artifact

As a Curator in Luma Knowledge, you can use the Artifact Detailed view to manage Artifacts available in the system. The screen is divided into below sections:

General Details:

This section holds general information regarding Artifact creation. The details are captured when the Artifact is created in Luma Knowledge.

The below details are available on the screen:

  • Artifact ID: The unique sequence number assigned to the Artifact once it is created in Luma Knowledge.

  • Artifact Name: The Artifact name assigned during Artifact creation

  • Status: Indicates the current Artifact status.

  • Summary: Summary added to the Artifact during Artifact creation or created by Luma automatically. Information, in Summary, is used to identify the Ontology of the Artifact

  • Source: This is the base document, URL, or Template used to create the Artifact in Luma Knowledge. If the Artifact is created using a Document or Web URL, you can click on the Source link and view the source document.

  • Domain: This is the Domain that is manually assigned to the Artifact when it is created in Luma Knowledge.

  • Added by: Details of the users who created the Artifact.

  • Added On: Date and Time when the Artifact was created in the system.

  • Upvotes: This indicates the Positive feedback received for the Artifact by the end-user

  • Downvotes: This indicates the Negative feedback received from the end-user for the Artifact.

  • Version History: This is the list of the historical versions of the artifact created over time. The Version history is available inside the menu. Click on 'View all Versions' to view the list of all the versions created to date.

Version History list displays all Major and Minor Artifact versions. If Tenant configuration → Create artifact minor version flag is set to False, Minor versions are not displayed in the list.

Question and Answer Pairs (FAQ):

All QnA pairs (FAQs) for the Artifact, generated by Open AI, Semantic Analysis, or created manually by the Curator, are listed here. Below are the details available in the section:

  1. Question and Answer pairs were created for the Artifact.

  2. Metadata identified for each QnA pair- Topic, Action, Subjects, Motivation, Keywords, and Key phrases.

  3. Effectiveness of the QnA, derived from user’s feedback - Upvotes, Downvotes. This is available for the QnA pairs created by the Semantic Analysis process.

  4. Source Information used to create the Artifact. This section is available only for Artifacts created using a document. You can select a Q&A and view the segment on the document used to create the Q&A.

Knowledge Graph

In the section, you can find the graphical illustration of the Topic-Artifact relationship in the Knowledge Graph. It represents the hierarchy path where the Artifact is available in Knowledge Graph. You may click on View in Knowledge Graph to view the Artifact and its Topic Hierarchy in Knowledge Graph.

Metadata

This section lists the Metadata identified for the Artifact by the Open AI and Semantic Analysis process. It represents the key information (terms or phrases) that describes the Artifact. It enhances the best response for Artifact searches.

If Open AI is enabled, the tab shows the Key phrases created via Open AI. Click on ‘Show More’ to show the Keywords generated by the Semantic Analysis.

Permissions

The Permissions section contains the Groups and Users who have access to the Artifact. When searching for information in Luma Knowledge, the Artifact is visible and accessible only to users with View permission on the artifact. When an Artifact is created and Published, it is available to all users by default. The OOTB Public group is automatically assigned to the Artifact. You can update the Groups, and Users list as required. Refer Manage group for more information.

Contents

The Contents section is displayed when the artifact is created manually using a template or by uploading a document with the template. The section displays the Artifact fields from the selected template and the added information.

Edit and Publish Artifacts

A Curator periodically reviews and updates the information available in an Artifact, as required. Below are the functionalities available in the Knowledge Store that enables information management in the system.

Edit an Artifact

As a Curator, you can update Metadata or add new QnA pairs to an Artifact. This helps in ensuring that the Knowledge in the system, is up to date, improved, and is accessible to users.

An Artifact cannot be edited simultaneously by more than one curator. The artifact is locked once it is checked out of Edit, to prohibit others from editing. The lock is released once the changes are saved.

Follow the below steps to Edit an Artifact.

  1. Select the Artifact and navigate to the Artifact details screen.

  2. In the option, select Checkout. The Artifact is moved to Draft status and opens in Edit mode.

  3. Click on Edit to edit Artifact details.

  4. If the Tenant configuration is set to create minor versions on Edit, i.e., Create artifact minor version flag is set to True, a minor version of the Artifact is created.

  5. You may now update the Artifact Name and Summary.

  6. In case the Artifact source type is Document, you may update the Source document.

    1. Click on Change Source.

    2. Browse the new source document.

  7. You can update the Artifact details in the content section. The section is available for artifacts created manually using a template or by uploading a document with the template.

  8. Any update to the Artifact details triggers Ontology regeneration. Verify the changes and click on Confirm to continue with the update.

  9. Updates are saved.

    1. The Artifact is added to the parsing queue for Ontology generated based on the updated summary.

    2. If Open AI is enabled, a request is sent to regenerate the Summary, FAQs, and Keywords based on the updated content. The new content generated is added to existing content.

    3. If the Source document is updated, QnA pairs are updated based on the new source document. Luma Knowledge creates new QnA pairs and removes the Obsolete QnA pairs. QnA pairs manually created or updated by the curator are retained.

  • The Artifact can only be edited in Draft status. Once Checked out for edit, the Artifact status changes to Draft and is not available for End Users. It must be Published again to be available for users, even if no changes have been made.

  • The source document can be updated only for Artifacts with Source Type ‘Document’. For other source types (Web URL or Template), the Change Source button is disabled.

  • When an existing artifact is updated and added to the parsing queue, it can be accessed in read-only mode.

  • Once created, Domain is not editable on Knowledge Store, however, it can be updated on Knowledge Graph. For more information, refer to the Knowledge Graph.

When the Artifact is Checkout for edit by a curator, the artifact is locked and is not available for other curators to edit. The lock is released once the changes are saved or discarded by the curator.

Add QnA pair

You may add new QnA pairs to the Artifact in the Draft state.

  1. Scroll to Question and Answer Pairs and click on the Add Q&A Pair button.

  2. Add the new Question and Answer and Click on Add Q&A Pair.

Luma Knowledge generates metadata for the new Q&A pair, and it starts appearing in the Q&A pair list.

Update Metadata

Follow the below steps to update the metadata of an Artifact in the Draft state:

  1. Select the Artifact and navigate to the Metadata tab.

  2. Click on Edit to update the metadata.

    1. To update Topics, you may search and select a topic from the existing topics available in the Knowledge Graph or click on Create to create a new Topic.

    2. Select the Parent topic, add new Topic details and click Create. The Topic is created in Knowledge Graph and the Artifact is linked to the Topic.

    3. For Action, Subjects, Motivations, and Key values update metadata phrases.

    4. Update data as required and click on Save Changes.

Edit a QnA Pair

You can update the contents and metadata of a QnA pair linked to an Artifact in the Draft state. Follow the below steps to edit an existing QnA pair.

  1. Select the Artifact and navigate to the Artifact details screen.

  2. Scroll to Question and Answer Pairs and click on the Edit button.

  3. You may now update the Question, Answer, or the metadata fields- Action, Subjects, Motivation, and Key Values.

     

  4. Update data as required and click on Save Changes. A confirmation message appears confirming the update.

Restore Artifact version

You can restore a previous version of an artifact. Follow the below steps to restore a previous version:

  1. Select the required Artifact to view the details.

  2. In the version history, select the required version. For an older version, click on See all versions and select the required version from the list.

  3. Click on the Restore version.

  4. On the Confirmation message, select Confirm.

  5. The older version of the artifact will be restored. A new version of the artifact is created with information from the restored version and The artifact state is set to the status of the restored version.

Publish an Artifact

Once the contents of the Artifact are reviewed, it is ready to Publish. Follow the below steps to Publish:

  1. Select the required Artifact to view the details

  2. On the details screen, click on Publish.

  3. On the confirmation message, click Yes if the Artifact has been updated as per the end-user feedback recommendations received for the artifact.

  4. A new (major) version of Artifact is created and is available for End Users. If Yes is clicked, the recommendation count is reset.

  5. In case mandatory metadata, Topic, Subject, and Actions are missing, an error symbol appears next to the Artifact name. In such a case, the Artifact cannot be published. Add the required metadata and retry Publishing.

Retire an Artifact

Based on feedback from End Users and accessibility, the Curator can retire an Artifact. A retired artifact does not appear in End-user search results. However, it is available in the Knowledge Store, and the curator can update the Artifact as required in the future and make it available for users.

To retire an Artifact, do the following.

  1. Select the Artifact and open the Artifact details screen

  2. In the option, select Retire.

  3. The Artifact status is now changed to Retire. The Artifact will not appear in any future search results for End Users.

Delete an Artifact

Once the Artifact is Retired and is no longer needed, the Curator can delete the Artifact from the system. Follow the below steps to delete the Artifact:

  1. Select the Artifact and open the Artifact details screen

  2. Select Delete.

  3. The Artifact is now deleted from the system and does not appear in search results for the End Users.

Assign Permission on an Artifact

Artifacts in Luma Knowledge are visible and accessible only to users with View permission on the artifact. The permission can be assigned either to individual users or to the User Group(s) created in the tenant. For more information on user groups, refer to Manage Groups.

When an Artifact is created and Published, it is available to all users by default. The OOTB Public group is automatically assigned to the Artifact. You can update the Groups and Users list as required. Refer Manage group for more information.

To assign permission on an Artifact, follow the below steps:

  1. Navigate to Knowledge Store and open the required Artifact.

  2. On the Artifact details screen, scroll down to the Permissions tab.

  3. To assign a Group:

    1. On the Groups section, click on Add Group.

    2. On the Groups list, select the required group (s).

    3. Click Add.

  4. To assign a User:

    1. On the Users section, click on Add User.

    2. On the User’s list, select the required users(s).

    3. Click Add.

Selected users and users associated with the selected group can now search and view the artifact.

Export Artifact Report

You can generate a quick report on the artifacts available in the Knowledge Store. This generates a report (CSV or Excel) with select artifact details.

To generate the report, follow the below steps:

  1. On the Knowledge store, select the artifacts to be exported. You may skip the step if you want to generate a report on all artifacts available in Knowledge Store.

  2. Select Export Artifacts in the options menu.

  3. A Report is downloaded on your local machine.