{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":22725,"path":"intelligent-experiences/ai-control-tower/ai-eval-components.md","title":"Components installed with the Evaluation dashboard","bundle":null,"doc_type":null,"release":"australia","body":"\n# Components installed with the Evaluation dashboard\n\nSeveral types of components are part of the Evaluation tab, including scheduled jobs, tables, system properties, and flows.\n\n## Scheduled jobs installed\n\n<table id=\"table_bps_dyg_ngc\"><thead><tr><th>\n\nScheduled job\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nCE Populate Value Aggregates Chats – Daily\n\n</td><td>\n\nThis scheduled script runs daily and randomly selects 1000 conversations from yesterday's conversations. After that, for each conversation, this job extracts the chat duration and classifies them as small, medium, or large. It also classifies the chats in which a Knowledge article or catalog item was invoked. For the evaluated chat, it also classifies the conversations based on the chat performance and populates that data into the Evaluation Value Aggregates table.\n\n</td></tr><tr><td>\n\nEvaluation Value Calcuation - Runs Only once after install\n\n</td><td>\n\nDeletes all the records on the Evaluation Value Aggregates tables, runs the calculations again and stores the aggregated value in the Evaluation Value Aggregates table. The data is from the first evaluation date.\n\n</td></tr></tbody>\n</table>## Tables installed\n\n<table id=\"table_xmn_qj4_hgc\"><thead><tr><th>\n\nLabel\n\n</th><th>\n\nName\n\n</th></tr></thead><tbody><tr><td>\n\nEvaluation\n\n</td><td>\n\n\\[sn\\_na\\_conv\\_eval\\_evaluation\\]\n\n</td></tr><tr><td>\n\nEvaluation configurations\n\n</td><td>\n\n\\[sn\\_na\\_conv\\_eval\\_evaluation\\_configurations\\]\n\n</td></tr><tr><td>\n\nEvaluation Metrics\n\n</td><td>\n\n\\[sn\\_na\\_conv\\_eval\\_evaluation\\_metrics\\]\n\n</td></tr><tr><td>\n\nEvaluation Set\n\n</td><td>\n\n\\[sn\\_na\\_conv\\_eval\\_evaluation\\_set\\]\n\n</td></tr><tr><td>\n\nEvaluation Value Aggregates\n\n</td><td>\n\n\\[sn\\_na\\_conv\\_eval\\_evaluation\\_value\\_aggregates\\]\n\n</td></tr></tbody>\n</table>## Remote tables installed\n\n<table id=\"table_ctm_hpp_hgc\"><thead><tr><th>\n\nTable\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nConversation Evaluator Value Calculations\n\n \\[sn\\_na\\_conv\\_eval\\_st\\_value\\_calcs\\]\n\n</td><td>\n\nFor the given query, the definition for this remote table calculates the time savings and efficiency percentage for small, medium, and large chats. Also, it returns the time savings and efficiency when a Knowledge article or catalog item was invoked.\n\n</td></tr><tr><td>\n\nConversation weekly calculations\\[sn\\_na\\_conv\\_eval\\_weekly\\_cals\\]\n\n</td><td>\n\nFor the given query, the definition for this remote table calculates the time savings and efficiency percentage for small, medium, and large chats for different weeks of the selected date range. Also, it returns the time savings and efficiency when aKnowledge article or catalog item was invoked for all the different weeks of the selected date range.\n\n</td></tr></tbody>\n</table>## System properties installed\n\n<table id=\"table_nby_14p_hgc\"><thead><tr><th>\n\nProperty\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nsn\\_na\\_conv\\_eval.errorBandMinRecords\n\n</td><td>\n\nMinimum number of records required to calculate the error band for upper and lower deviation. By default, the value is 30.\n\n</td></tr><tr><td>\n\nsn\\_na\\_conv\\_eval.evalWeights\n\n</td><td>\n\nContains weights to each evaluation metric for chat evaluation. This property is used to compute total or composite scores for evaluation records.\n\n</td></tr><tr><td>\n\nsn\\_na\\_conv\\_eval.maxEvaluateCount\n\n</td><td>\n\nMaximum number of records to evaluate in a day. By default, the value is 200.\n\n</td></tr><tr><td>\n\nsn\\_na\\_conv\\_eval.total\\_sampled\\_conv\\_count\n\n</td><td>\n\nEdit this property to control the total number of conversations that can be sampled for value calculations. By default, the value is 1000.\n\n</td></tr><tr><td>\n\nsn\\_na\\_conv\\_eval.value\\_chat\\_classifier\n\n</td><td>\n\nEdit this property to change the definition of small, medium, and large conversations. By default, the value it stores is 4, 10.\n\n Here, 4 and 10 signify the total number of inbound messages. Fewer than or equal to 4 inbound messages in the sys\\_cs\\_message table for a conversation means that it’s a small conversation. More than 4 inbound messages and fewer than or equal to 10 inbound messages means that it’s a medium conversation, and more than 10 inbound messages means that it’s a large conversation.\n\n</td></tr><tr><td>\n\nsn\\_na\\_conv\\_eval.ce\\_value\\_calculation\\_weights\n\n</td><td>\n\nValue calculation weight values for each type of evaluated chat.\n\n</td></tr><tr><td>\n\nsn\\_na\\_conv\\_eval.eval\\_value\\_rerun\\_status\n\n</td><td>\n\nReruns the value calculations once after the installation. This property will check the status of the Conversation Evaluator Value Rerun status. If it has run, then the script will change the value of this system property to false.\n\n</td></tr></tbody>\n</table>## Business rules installed\n\n|Name|When|Insert|Update|Filter Conditions|\n|----|----|------|------|-----------------|\n|Add info message for Evaluation set|after|TRUE|TRUE|stateCHANGESTOIn Progress^evaluation\\_type=conversation^EQ|\n|Scale Up labeling metric|before|TRUE|TRUE|metric\\_type=Labeling^metric\\_nameINhelpfulness\\_chat\\_eval,intent\\_recognition\\_chat\\_eval,slot\\_filling\\_chat\\_eval,forgetfulness\\_chat\\_eval,hallucination\\_chat\\_eval,redundancy\\_chat\\_eval,deadlock\\_chat\\_eval,coherence\\_chat\\_eval^raw\\_scoreVALCHANGES^EQ|\n|updateLabelingScoresOnEvaluation|after|TRUE|TRUE|metric\\_type=Labeling^raw\\_scoreVALCHANGES^metric\\_nameINhelpfulness\\_chat\\_eval,intent\\_recognition\\_chat\\_eval,slot\\_filling\\_chat\\_eval,forgetfulness\\_chat\\_eval,hallucination\\_chat\\_eval,redundancy\\_chat\\_eval,deadlock\\_chat\\_eval,coherence\\_chat\\_eval^EQ|\n|Update deviation scores|before|TRUE|TRUE|metric\\_type=LLM Generated^scoreVALCHANGES^EQ|\n|getAutoEvalCompositeScore|after|FALSE|TRUE|stateCHANGESTOComplete^total\\_scoreISEMPTY^EQ|\n\n## Flows installed\n\n<table id=\"table_bcl_3sx_hgc\"><thead><tr><th>\n\nFlow\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nExecute Evaluation\n\n</td><td>\n\nPerforms evaluations when conversations are completed.\n\n By default, the Execute Evaluation flow is deactivated. You can use the nightly scheduled job Execute Evaluations to evaluate the chats. If you want to evaluate the chats on chat completion, activate the Execute Evaluation flow.\n\n</td></tr><tr><td>\n\nExecute Batch Evaluation\n\n</td><td>\n\nPerforms batch evaluations, evaluating up to 100 completed virtual agent conversations. Flow is triggered when the Evaluation set is created or updated and the Evaluation Type is Conversation.\n\n</td></tr></tbody>\n</table>## Flow actions installed\n\n<table id=\"table_q3c_tsx_hgc\"><thead><tr><th>\n\nFlow action\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nRandomize conversations\n\n</td><td>\n\nPerforms randomization of conversations and returns 100 conversations randomly from a given query.\n\n</td></tr><tr><td>\n\ninvokeApiDefinition\n\n</td><td>\n\nInvokes OneExtend Capability in the large language model \\(LLM\\).\n\n</td></tr><tr><td>\n\nChat Classifier Eval\n\n</td><td>\n\nGives the title, category, and whether the evaluation should be executed.\n\n</td></tr><tr><td>\n\nbuildTranscript\n\n</td><td>\n\nBuilds the transcript from a conversation.\n\n</td></tr><tr><td>\n\nevalExecuteCondition\n\n</td><td>\n\nChecks if the transcript is good enough to be evaluated.\n\n</td></tr></tbody>\n</table>## Script includes installed\n\n<table id=\"table_atn_2tx_hgc\"><thead><tr><th>\n\nScript includes\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nevalExecuteCondition\n\n</td><td>\n\nUse this script include to update the evaluation condition.\n\n</td></tr><tr><td>\n\nevalUtils\n\n</td><td>\n\nPrimary Utility function for the Evaluator.\n\n</td></tr></tbody>\n</table>**Related topics**  \n\n\n[Remote tables](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/servicenow-platform/remote-tables.md)\n\n"}}