{"id":22666,"date":"2019-11-01T10:16:46","date_gmt":"2019-11-01T10:16:46","guid":{"rendered":"https:\/\/developer.kore.ai\/v10-1\/?p=22666"},"modified":"2023-04-19T10:26:26","modified_gmt":"2023-04-19T09:26:26","slug":"knowledge-ontology-analysis","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v10-1\/docs\/bots\/bot-builder-tool\/knowledge-task\/knowledge-ontology-analysis\/","title":{"rendered":"Knowledge Graph Analysis"},"content":{"rendered":"<section class=\"l-section wpb_row height_auto\"><div class=\"l-section-h i-cf\"><div class=\"g-cols vc_row type_default valign_top\"><div class=\"vc_col-sm-12 wpb_column vc_column_container\"><div class=\"vc_column-inner\"><div class=\"wpb_wrapper\">\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<p><span style=\"font-weight: 400\">A careful analysis of the Knowledge Graph helps in detecting errors in your questions and the path associated with them that hamper the user experience.<\/span><\/p>\n<p><span style=\"font-weight: 400\">The Knowledge Graph (KG) Diagnosis tool helps you identify any inefficiencies in your KGs and suggests possible corrective actions. These are just guidelines and you need to further analyze the recommendations before going ahead with any changes.<\/span><\/p>\n<p><span style=\"font-weight: 400\">The KG provides an option to initiate an inspection, as follows:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">This option is available only for the in-development version of the KG where there are one or more FAQs added.<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">The analysis considers the thresholds and other configurations of the KG.<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">The analysis issues a warning if any node contains more than 25 questions and an advisory to the effect that the training fails if there are more than 100 questions in any node.<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">You can invoke the diagnosis, by clicking <\/span><strong>Inspect<\/strong><span style=\"font-weight: 400\"> on the KG screen.<\/span><span style=\"font-weight: 400\"><br \/><\/span><\/li>\n<p><a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20221128060959\/KG_Inspect_First.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20221128060959\/KG_Inspect_First.png\" alt=\"\" width=\"1200\" height=\"577\" class=\"alignnone size-medium wp-image-49156\" \/><\/a><\/li>\n<div class=\"alert alert-info\">You can also add patterns as alternate questions for an FAQ to provide better coverage, which helps in detecting the right FAQs for a user question. KG Inspect helps in identifying any syntax errors that occur  knowingly or unknowingly while defining patterns. The platform analyzes the KG and provides a report of the analysis. The identified incorrect patterns in KG are displayed in the report.<\/div>\n<li>You have an option to <strong>Re-run<\/strong> the analysis or\u00a0<strong>Export<\/strong> the report. The export option downloads the report in JSON format.<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20221128061638\/KG_In_1.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20221128061638\/KG_In_1.png\" alt=\"\" width=\"1100\" height=\"403\" class=\"alignnone size-medium wp-image-49162\" \/><\/a><\/li>\n<li>The inspect report shows an overview of the number of issues found under various categories. Please read below to learn more.<\/li>\n<li>The various categories are grouped as:\n<ul>\n<li><strong>Error<\/strong> &#8211; Errors are incorrect graph definitions that need an immediate fix.<\/li>\n<li><strong>Warnings<\/strong> &#8211; When rectified, it help improves intent detection. A maximum of 50 warnings are displayed.<\/li>\n<li><strong>Suggestions<\/strong> &#8211; When implemented, it helps in the better organization of your KG. A maximum of 10 suggestions are displayed.<\/li>\n<\/ul>\n<\/li>\n<li>Click each category to view the detailed report<\/li>\n<p>In this example you see the details of all the patterns with invalid syntaxes.<br \/>\n<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20221128061816\/KG-In_2.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20221128061816\/KG-In_2.png\" alt=\"\" width=\"1200\" height=\"462\" class=\"alignnone size-medium wp-image-49165\" \/><\/a><\/li>\n<div class=\"alert alert-info\"><strong>Note:<\/strong> There can be more than 50 warnings or 10 suggestions, but only the first 50\/10 occurrences of the issue are listed. You must fix the same and re-run the analysis to view the next set.<\/div>\n<\/ul>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h3><span class=\"ez-toc-section\" id=\"Report_Fields_for_Ontology_Knowledge_Graphs\">Report Fields for Ontology Knowledge Graphs<\/span><\/h3>\n<p>The following table details the fields that are displayed in the report:<\/p>\n<table class=\"confluenceTable\">\n<tbody>\n<tr>\n<th>Issue Type<\/th>\n<th>Category<\/th>\n<th>Details<\/th>\n<th>Suggestion<\/th>\n<\/tr>\n<tr>\n<td>Patterns with Invalid Syntax<\/td>\n<td bgcolor=\"dd7e6b\">Error<\/td>\n<td>\n<ul>\n<li>Current Path<\/li>\n<li>Pattern<\/li>\n<li>Error<\/li>\n<li>Question<\/li>\n<\/ul>\n<\/td>\n<td>Rectify the incorrect patterns for better FAQ detection.<\/td>\n<\/tr>\n<tr>\n<td>Questions added to incorrect paths<\/td>\n<td bgcolor=\"dd7e6b\">Error<\/td>\n<td>\n<ul>\n<li>Question<\/li>\n<li>Path<\/li>\n<\/ul>\n<\/td>\n<td>Modify the path to include the terms in the question.<\/td>\n<\/tr>\n<tr>\n<td>Long-chain of terms with the questions present only at the last term in the chain<\/td>\n<td bgcolor=\"ffd966\">Suggestion<\/td>\n<td>\n<ul>\n<li>Question<\/li>\n<li>Path<\/li>\n<\/ul>\n<\/td>\n<td>Reduce the path by avoiding unimportant terms or merge relevant terms.<\/td>\n<\/tr>\n<tr>\n<td>Identical terms with a common ancestor<\/td>\n<td bgcolor=\"ffd966\">Suggestion<\/td>\n<td>\n<ul>\n<li>Common Parent<\/li>\n<li>Child Paths (only for the largest repeated child trees)<\/li>\n<\/ul>\n<\/td>\n<td>Move the child terms above their parent terms to avoid duplication<\/td>\n<\/tr>\n<tr>\n<td>Paths without any questions<\/td>\n<td bgcolor=\"ffd966\">Suggestion<\/td>\n<td>\n<ul>\n<li>Path<\/li>\n<\/ul>\n<\/td>\n<td>Remove the path if you do not intend to add any questions to this path<\/td>\n<\/tr>\n<tr>\n<td>Redundant alternate questions<\/td>\n<td bgcolor=\"ffd966\">Suggestion<\/td>\n<td>\n<ul>\n<li>Question<\/li>\n<li>Alternate Question (multiple)<\/li>\n<li>Path<\/li>\n<\/ul>\n<\/td>\n<td>Rephrase alternate questions to include wider coverage<\/td>\n<\/tr>\n<tr>\n<td>A large number of questions added to the root term<\/td>\n<td bgcolor=\"ffd966\">Suggestion<\/td>\n<td>\n<ul>\n<li>Question<\/li>\n<li>Path<\/li>\n<\/ul>\n<\/td>\n<td>Move the questions to the appropriate paths<\/td>\n<\/tr>\n<tr>\n<td>Unusually long paths<\/td>\n<td bgcolor=\"cfe2f3\">Warning<\/td>\n<td>\n<ul>\n<li>Path<\/li>\n<\/ul>\n<\/td>\n<td>Reduce the path by avoiding unnecessary terms or merging relevant terms.<\/td>\n<\/tr>\n<tr>\n<td>Questions at the root node that can be moved to better paths<\/td>\n<td bgcolor=\"cfe2f3\">Warning<\/td>\n<td>\n<ul>\n<li>Question<\/li>\n<li>Current Path<\/li>\n<li>Suggested Path<\/li>\n<\/ul>\n<\/td>\n<td>Move the question to the suggested path<\/td>\n<\/tr>\n<tr>\n<td>Questions with common words that are not used as terms<\/td>\n<td bgcolor=\"cfe2f3\">Warning<\/td>\n<td>\n<ul>\n<li>Question (multiple)<\/li>\n<li>Path<\/li>\n<li>Suggested Extension<\/li>\n<\/ul>\n<\/td>\n<td>Extend the current path using the suggested extension<\/td>\n<\/tr>\n<tr>\n<td>Questions that match multiple paths<\/td>\n<td bgcolor=\"cfe2f3\">Warning<\/td>\n<td>\n<ul>\n<li>Question<\/li>\n<li>Current path<\/li>\n<li>Other Paths (multiple)<\/li>\n<\/ul>\n<\/td>\n<td>Review the paths to avoid possible ambiguity scenarios<\/td>\n<\/tr>\n<tr>\n<td>Identical sibling nodes<\/td>\n<td bgcolor=\"cfe2f3\">Warning<\/td>\n<td>\n<ul>\n<li>Path<\/li>\n<li>Identical Term<\/li>\n<\/ul>\n<\/td>\n<td>Merge the identical terms<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\n<h2><span class=\"ez-toc-section\" id=\"Report_Fields_for_Few-Shot_Knowledge_Graphs\"><span style=\"font-weight: 400\">Report Fields for Few-Shot Knowledge Graphs<\/span><\/span><\/h2>\n<p><span style=\"font-weight: 400\">For Few-Shot Knowledge Graphs, nothing regarding paths and keywords requires analysis; since these are not used by the model to detect intent. The only report fields you will see when inspecting such a graph are the following:&nbsp;<\/span><\/p>\n<table>\n<tbody>\n<tr>\n<th>\n<p><strong>Issue Type<\/strong><\/p>\n<\/th>\n<th>\n<p><strong>Category&nbsp;<\/strong><\/p>\n<\/th>\n<th>\n<p><strong>Details<\/strong><\/p>\n<\/th>\n<th>\n<p><strong>Suggestion<\/strong><\/p>\n<\/th>\n<\/tr>\n<tr>\n<td>\n<p><span style=\"font-weight: 400\">Patterns with Invalid Syntax<\/span><\/p>\n<\/td>\n<td bgcolor=\"dd7e6b\">\n<p>Error<\/p>\n<\/td>\n<td>\n<ul>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Current Path<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Pattern<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Error<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Question<\/span><\/li>\n<\/ul>\n<\/td>\n<td>\n<p><span style=\"font-weight: 400\">Rectify the incorrect patterns for better FAQ detection.<\/span><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p><span style=\"font-weight: 400\">Paths without any questions<\/span><\/p>\n<\/td>\n<td bgcolor=\"ffd966\">\n<p>Suggestion<\/p>\n<\/td>\n<td>\n<ul>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Path<\/span><\/li>\n<\/ul>\n<\/td>\n<td>\n<p><span style=\"font-weight: 400\">Remove the path if you do not intend to add any questions to this path.<\/span><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td>\n<p><span style=\"font-weight: 400\">Redundant alternate questions<\/span><\/p>\n<\/td>\n<td bgcolor=\"ffd966\">\n<p>Suggestion<\/p>\n<\/td>\n<td>\n<ul>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Question<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Alternate Question (multiple)<\/span><\/li>\n<li style=\"font-weight: 400\"><span style=\"font-weight: 400\">Path<\/span><\/li>\n<\/ul>\n<\/td>\n<td>\n<p><span style=\"font-weight: 400\">Rephrase alternate questions to include wider coverage.<\/span><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div class=\"alert alert-info\"><strong>Note:<\/strong> Every time a KG is inspected, the following details get updated in a scenario where any FAQs are modified or any new FAQs are added:<\/p>\n<ul>\n<li>Total checks<\/li>\n<li>Count of errors, warnings, suggestions<\/li>\n<li>Count and the list of various checkpoints<\/li>\n<\/ul>\n<\/div>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>[vc_raw_html]JTNDZGl2JTIwY2xhc3MlM0QlMjJ3LXBvc3QtZWxtJTIwcG9zdF9uYXZpZ2F0aW9uJTIwbGF5b3V0X3NpbXBsZSUyMGludl9mYWxzZSUyMiUzRSUwQSUzQ2ElMjBjbGFzcyUzRCUyMnBvc3RfbmF2aWdhdGlvbi1pdGVtJTIwb3JkZXJfZmlyc3QlMjB0b19wcmV2JTIyJTIwaHJlZiUzRCUyMiUyRmRvY3MlMkZib3RzJTJGYm90LWJ1aWxkZXItdG9vbCUyRmtub3dsZWRnZS10YXNrJTJGaW1wb3J0aW5nLXRoZS1ib3Qtb250b2xvZ3ktZnJvbS1jc3Ytb3ItanNvbiUyRiUyMiUzRSUzQyUyRnAlM0UlMEElM0NkaXYlMjBjbGFzcyUzRCUyMnBvc3RfbmF2aWdhdGlvbi1pdGVtLWFycm93JTIyJTNFJTNDJTJGZGl2JTNFJTBBJTNDZGl2JTIwY2xhc3MlM0QlMjJwb3N0X25hdmlnYXRpb24taXRlbS1tZXRhJTIyJTNFUHJldmlvdXMlMjBQb3N0JTNDJTJGZGl2JTNFJTBBJTNDZGl2JTIwY2xhc3MlM0QlMjJwb3N0X25hdmlnYXRpb24taXRlbS10aXRsZSUyMiUzRSUzQ3NwYW4lM0VLRyUyMC0lMjBJbXBvcnQlMkZFeHBvcnQlM0MlMkZzcGFuJTNFJTNDJTJGZGl2JTNFJTBBJTNDcCUzRSUzQyUyRmElM0UlM0NiciUyMCUyRiUzRSUwQSUzQ2ElMjBjbGFzcyUzRCUyMnBvc3RfbmF2aWdhdGlvbi1pdGVtJTIwb3JkZXJfc2Vjb25kJTIwdG9fbmV4dCUyMiUyMGhyZWYlM0QlMjIlMkZkb2NzJTJGYm90cyUyRmJvdC1idWlsZGVyLXRvb2wlMkZrbm93bGVkZ2UtdGFzayUyRmtub3dsZWRnZS1leHRyYWN0aW9uLXNlcnZpY2UlMkYlMjIlM0UlM0MlMkZwJTNFJTBBJTNDZGl2JTIwY2xhc3MlM0QlMjJwb3N0X25hdmlnYXRpb24taXRlbS1hcnJvdyUyMiUzRSUzQyUyRmRpdiUzRSUwQSUzQ2RpdiUyMGNsYXNzJTNEJTIycG9zdF9uYXZpZ2F0aW9uLWl0ZW0tbWV0YSUyMiUzRU5leHQlMjBQb3N0JTNDJTJGZGl2JTNFJTBBJTNDZGl2JTIwY2xhc3MlM0QlMjJwb3N0X25hdmlnYXRpb24taXRlbS10aXRsZSUyMiUzRSUzQ3NwYW4lM0VLRyUyMC0lMjBFeHRyYWN0aW9uJTNDJTJGc3BhbiUzRSUzQyUyRmRpdiUzRSUwQSUzQ3AlM0UlM0MlMkZhJTNFJTNDJTJGZGl2JTNF[\/vc_raw_html]<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div><\/div><\/div><\/div><\/div><\/div><\/section>\n","protected":false},"excerpt":{"rendered":"A careful analysis of the Knowledge Graph helps in detecting errors in your questions and the path associated with them that hamper the user experience. The Knowledge Graph (KG) Diagnosis tool helps you identify any inefficiencies in your KGs and suggests possible corrective actions. These are just guidelines and you need to further analyze the...","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[33],"tags":[],"class_list":["post-22666","post","type-post","status-publish","format-standard","hentry","category-knowledge-task"],"_links":{"self":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/22666","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/comments?post=22666"}],"version-history":[{"count":24,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/22666\/revisions"}],"predecessor-version":[{"id":56753,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/22666\/revisions\/56753"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/media?parent=22666"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/categories?post=22666"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/tags?post=22666"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}