PE-GPR/9.0.0/Deployment/dataReqs - Revision history

WikiSysop at 12:45, March 31, 2022

2022-03-31T12:45:48Z

Ed.jamer@genesys.com: Text replacement - "Genesys Cloud" to "Genesys Cloud CX"

2021-11-09T21:27:39Z

Text replacement - "Genesys Cloud" to "Genesys Cloud CX"

Ed.jamer@genesys.com: Text replacement - "Genesys Engage [cC]loud" to "Genesys Multicloud CX"

2021-11-09T20:29:31Z

Text replacement - "Genesys Engage [cC]loud" to "Genesys Multicloud CX"

Vivian.hood@genesys.com: Published

2021-01-22T14:49:24Z

Published

Vivian.hood@genesys.com: Published

2020-11-11T14:18:34Z

Published

Show changes

Vivian: Published

2020-09-22T13:25:50Z

Published

WikiSysop: Text replacement - "\|Platform=([^\|])GenesysEngage-onpremises([\|])" to "|Platform=$1GenesysEngage-cloud$2"

2020-07-25T02:32:10Z

Text replacement - "\|Platform=([^\|]*)GenesysEngage-onpremises([\|]*)" to "|Platform=$1GenesysEngage-cloud$2"

WikiSysop: Text replacement - "Genesys Engage Cloud" to "Genesys Engage cloud"

2020-07-15T12:06:38Z

Text replacement - "Genesys Engage Cloud" to "Genesys Engage cloud"

WikiSysop: Text replacement - "PureEngage" to "Genesys Engage"

2020-07-15T12:03:39Z

Text replacement - "PureEngage" to "Genesys Engage"

WikiSysop: Text replacement - "\|Platforms?=([^\|])PureEngage([\|])" to "|Platform=$1GenesysEngage-onpremises$2"

2020-07-15T11:44:19Z

Text replacement - "\|Platforms?=([^\|]*)PureEngage([\|]*)" to "|Platform=$1GenesysEngage-onpremises$2"

@@ Line 18: / Line 18: @@
 ====Agent Profile data====
-*Data Loader automatically extracts Agent data from the Genesys Info Mart Database. You can optionally add agent data from other sources by providing a .csv file for Data Loader to upload.
+*Data Loader automatically extracts agent data from the Genesys Info Mart Database. You can optionally add agent data from other sources by providing a .csv file for Data Loader to upload.
 ====Customer Profile data====
-*To create the Customer Profile, create a .csv file and upload it using Data Loader.
+*To create the customer profile, create a .csv file and upload it using Data Loader.
 ====Outcome and other data====
@@ Line 42: / Line 42: @@
 *The maximum length of a single column name in a .csv file for upload is 127 characters.
 *The maximum length of a single column name that Data Loader will anonymize is 120 characters.
-*The maximum number of rows in the Agent Profile is 20 thousand.
+*The maximum number of rows in the agent profile is 20 thousand.
-*The number of rows in the Customer Profile is 20 million.
+*The number of rows in the customer profile is 20 million.
-*The maximum number of columns (features) in the Agent and Customer Profile datasets is configured for each account. The default limit is 50 features for each Profile dataset. Only a STAFF user can change this value.
+*The maximum number of columns (features) in the agent and customer profile datasets is configured for each account. The default limit is 50 features for each profile dataset. Only a STAFF user can change this value.
 If you try to upload more data than the data size limits allow, GPR generates an error and discards the remaining rows.
@@ Line 57: / Line 57: @@
 |anchor=dataFormat
 |alignment=Vertical
-|structuredtext=*When you create the .csv data file for a dataset, Agent Profile, or Customer Profile, do not include the following in the column name for the ID_FIELD, the Agent ID, or the Customer ID:
+|structuredtext=*When you create the .csv data file for a dataset, agent profile, or customer profile, do not include the following in the column name for the ID_FIELD, the Agent ID, or the Customer ID:
 *ID
 *_id
@@ Line 64: / Line 64: @@
 Using these strings in the column name results in an error when you try to upload your data.
-*When you create the .csv data file for a dataset, Agent Profile, or Customer Profile, do not include the following reserved names in column names:
+*When you create the .csv data file for a dataset, agent profile, or customer profile, do not include the following reserved names in column names:
 **created_at
 **tenant_id
 **updated_at
 **acl
-*In the Agent Profile, if you are using skill names that include a dot (period) or a space in them, use double quotation mark characters to enclose the skill name. For example, enter a skill named <nowiki>''fluent spanish.8''</nowiki> as "fluent spanish.8".
+*In the agent profile, if you are using skill names that include a dot (period) or a space in them, use double quotation mark characters to enclose the skill name. For example, enter a skill named <nowiki>''fluent spanish.8''</nowiki> as "fluent spanish.8".
 *GPR supports UTF-8 encoding. All responses and returned data arrives in UTF-8 encoding.
 *If you use a Microsoft editor to create your .csv file, remove the carriage return (^M) character before uploading. Microsoft editors such as Excel, WordPad, and NotePad automatically insert this character. For tips on removing the character from Excel files, refer to [https://www.ablebits.com/office-addins-blog/2013/12/03/remove-carriage-returns-excel/ How to remove carriage returns (line breaks) from cells in Excel 2016, 2013, 2010].
 *GPR supports only one-dimensional dictionaries, with up to 200 key-value pairs where the key is a string and the value is int, float, or Boolean. GPR does not support nested dictionaries and lists.
 *If you have dictionary-type fields that use comma separators, use tab separators for your .csv file.
-*Fields of the dictionary (DICT) type are discovered correctly only if the quotes appear as in the following example, with double quotation marks outside a dictionary entry and single quotation marks for the values within it. This requirement applies to DICT fields in all datasets, including the Agent and Customer Profile datasets.
+*Fields of the dictionary (DICT) type are discovered correctly only if the quotes appear as in the following example, with double quotation marks outside a dictionary entry and single quotation marks for the values within it. This requirement applies to DICT fields in all datasets, including the agent and customer profile datasets.
 **"{'vq_1':0.54,'vq_2':6.43}"
 *GPR does not support use of angle brackets (&lt;&gt;) to signify "not" in SQL queries. Genesys recommends that you use the following symbols instead: '''!='''.
 |Status=No
 }}{{Section
-|sectionHeading=Data size for Models and scoring
+|sectionHeading=Data size for models and scoring
 |anchor=ModelData
 |alignment=Vertical
-|structuredtext=The following size limits apply to Model creation:
+|structuredtext=The following size limits apply to model creation:
-*Minimum number of records required train a DISJOINT model for an agent - 10
+*Maximum number of active models per Tenant - 50
-*Maximum number of active Models per Tenant - 50
+*Total cardinality limit for model training: no specific column count; has been tested up to 250 columns.
 **Total cardinality must be less than 2 to the power of 29.
-**''Total Cardinality'' = the number of numeric columns plus the sum of the number of unique values across all string columns within a specified Dataset.
+**''Total Cardinality'' = the number of numeric columns plus the sum of the number of unique values across all string columns within a specified dataset.
-*Record count limit for GLOBAL Model training - not applicable; from a Model-training perspective there is virtually no limit on the number of columns. The constraining issue is the possibility of compromising the Global Model quality by ending up with a reduced number of samples for training.
+*Record count limit for model training - not applicable; from a model-training perspective there is virtually no limit on the number of columns. The constraining issue is the possibility of compromising the model quality by ending up with a reduced number of samples for training.
 **The total number of records must be less than 2 to power of 29 (that is, 536870912) divided by total cardinality as defined above.
-**'''Example 1:''' You must to use ALL of the data for training the GLOBAL Model (note that the GLOBAL Model is trained even if you select DISJOINT, so that the scoring engine can rank agents who do not yet have data). If the Dataset contains 1 million records, the maximum total cardinality is 536 (536870912 divided by 1 million).
+**'''Example 1:''' You must to use ALL of the data for training the model . If the dataset contains 1 million records, the maximum total cardinality is 536 (536870912 divided by 1 million).
-**'''Example 2:''' You can ''undersample'' the data for training the GLOBAL Model—that is, use fewer than the ideal number of records for training. You might take 10,000 as the total cardinality, but only 53,687 of your total of 1 million records will be used for training. The calculation to determine this is 10,000 * 53,687 = 536870912 (the maximum cardinality).
+**'''Example 2:''' You can ''undersample'' the data for training the model—that is, use fewer than the ideal number of records for training. You might take 10,000 as the total cardinality, but only 53,687 of your total of 1 million records will be used for training. The calculation to determine this is 10,000 * 53,687 = 536870912 (the maximum cardinality).
 The following limitation applies to scoring requests:
@@ Line 114: / Line 113: @@
 *Each Tenant has its own unique salt for anonymization.
-'''NOTE:''' If you anonymize a field, you must anonymize it in every dataset in which it appears. For example, if you anonymize a customer phone number in the Customer Profile, you must also anonymize it in any dataset in which it appears. If there is an inconsistency, GPR cannot correctly map agents and, as a result, cannot build models for them.
+'''NOTE:''' If you anonymize a field, you must anonymize it in every dataset in which it appears. For example, if you anonymize a customer phone number in the customer profile, you must also anonymize it in any dataset in which it appears. If there is an inconsistency, GPR cannot correctly map agents and, as a result, cannot build models for them.
 GPR uses the following steps to ensure secure data handling:
@@ Line 120: / Line 119: @@
 #When Data Loader starts up, it generates a unique 64-character salt string that will be used for anonymization. It stores this string in the '''anon-salt''' option in the '''[default]''' section on the '''Annex''' tab of the primary and backup Data Loader <tt>Application</tt> objects and the Predictive_Route_DataCfg <tt>Transaction List</tt> object.
 #*When you open these options in GAX, or any other configuration manager application you use, you cannot see the salt value itself. What you see is an obfuscated version of the salt string.
-#*'''WARNING!''' Do not edit or delete the value Data Loader sets for the '''anon-salt''' options. If you try to modify a salt value, GPR generates an alarm message and Data Loader restores the original salt value. ''If for some reason, Data Loader cannot restore the original salt value, your predictors become unusable for scoring and routing.'' To rectify this situation you must recreate the Agent and Customer Profiles, reload all interaction datasets, and retrain your models. If you do not recreate the Agent and Customer Profiles and datasets exactly, you must also create and train new predictors and models. Therefore, Genesys strongly recommends that you do not modify or delete the salt values.
+#*'''WARNING!''' Do not edit or delete the value Data Loader sets for the '''anon-salt''' options. If you try to modify a salt value, GPR generates an alarm message and Data Loader restores the original salt value. ''If for some reason, Data Loader cannot restore the original salt value, your predictors become unusable for scoring and routing.'' To rectify this situation you must recreate the agent and customer profiles, reload all interaction datasets, and retrain your models. If you do not recreate the agent and customer profiles and datasets exactly, you must also create and train new predictors and models. Therefore, Genesys strongly recommends that you do not modify or delete the salt values.
 #Before uploading the dataset to the GPR Core Platform, Data Loader uses this salt to anonymize the fields you specified as sensitive or PII data when you configured the schema.
 #The anonymized data is uploaded to the GPR Core Platform using TLS for secure data transport. The uploaded data is used for creating predictors and models.
@@ Line 153: / Line 152: @@
 Most objects and data are deleted automatically after 90 days during which they are inactive. These include the following:
-*Dataset data and the Dataset object - Deleted after 90 days of idle time, which means no new files were appended and the Dataset was not used to generate any data for Predictors in that period.
+*Dataset data and the dataset object - Deleted after 90 days of idle time, which means no new files were appended and the dataset was not used to generate any data for predictors in that period.
-*File upload object - Deleted after 90 days of idle time. Here idle time means this file was not used to generate any data for Predictors in that period.
+*File upload object - Deleted after 90 days of idle time. Here idle time means this file was not used to generate any data for predictors in that period.
-*Agent / Customer Profiles - Deleted after 90 days of idle time, which means the Profile was not updated in the last 90 days.
+*Agent / Customer Profiles - Deleted after 90 days of idle time, which means the profile was not updated in the last 90 days.
-*Model - Deleted after 90 days of idle time, which means the Model was not used for any score requests in last 90 days.
+*Model - Deleted after 90 days of idle time, which means the model was not used for any score requests in last 90 days.
-*Predictor generated data and the Predictor object - Deleted after 90 days of idle time, which means that no associated Model was used for a score request in last 90 days.
+*Predictor generated data and the predictor object - Deleted after 90 days of idle time, which means that no associated model was used for a score request in last 90 days.
 The following data uses different retention policies:

@@ Line 149: / Line 149: @@
 |anchor=retainData
 |alignment=Vertical
-|structuredtext=GPR follows standard Genesys data retention guidelines for Genesys Multicloud CX as outlined in Section 14 of the {{RepositoryTemp|Genesys Cloud User Guide.pdf|278978137742|Genesys Multicloud CX User Guide}}.
+|structuredtext=GPR follows standard Genesys data retention guidelines for Genesys Multicloud CX as outlined in Section 14 of the {{RepositoryTemp|Genesys Cloud CX User Guide.pdf|278978137742|Genesys Multicloud CX User Guide}}.
 Most objects and data are deleted automatically after 90 days during which they are inactive. These include the following:

@@ Line 149: / Line 149: @@
 |anchor=retainData
 |alignment=Vertical
-|structuredtext=GPR follows standard Genesys data retention guidelines for Genesys Engage cloud as outlined in Section 14 of the {{RepositoryTemp|Genesys Cloud User Guide.pdf|278978137742|Genesys Engage cloud User Guide}}.
+|structuredtext=GPR follows standard Genesys data retention guidelines for Genesys Multicloud CX as outlined in Section 14 of the {{RepositoryTemp|Genesys Cloud User Guide.pdf|278978137742|Genesys Multicloud CX User Guide}}.
 Most objects and data are deleted automatically after 90 days during which they are inactive. These include the following:

@@ Line 125: / Line 125: @@
 #After you create a predictor and one or more models, and begin using them to route interactions, the GPR subroutines retrieve the list of sensitive or PII features that are included in the active predictor. This list of features is stored in the URS Global Map.
 #The GPR Subroutines access the on-premises instance of your data to use in scoring requests. As a result, the Subroutines anonymize all sensitive fields included in the predictor you are using for scoring, based on the salt value stored in the Predictive_Route_DataCfg <tt>Transaction List</tt> object.
-#If one of the anonymized fields is the employeeId, after the ActivatePredictiveRouting subroutine receives the response to the score request, it maps the agent scores back to the non-anonymized versions of the employee IDs so that routing can proceed.
+#If one of the anonymized fields is the EMPLOYEE_ID, after the ActivatePredictiveRouting subroutine receives the response to the score request, it maps the agent scores back to the non-anonymized versions of the employee IDs so that routing can proceed.
 #Before the GPRIxnCleanup subroutine reports the routing outcome to the GPR Core Platform, it anonymizes all fields marked as PII that are included in the score outcome report. It then sends the results to the score log, which is stored in the cloud.
 |FAQHeading=How does Predictive Routing handle sensitive data and PII?

@@ Line 5: / Line 5: @@
 |Context=Certain requirements and limitations apply to the data that you upload to GPR. This topic explains these requirements, and also presents data security and anonymization.
 |Dimension=GPRDataUpload
 |ComingSoon=No
-|Platform=GenesysEngage-cloud
+|Platform=GenesysEngage-onpremises
 |Section={{Section
 |sectionHeading=Supported types of data
 |anchor=SupportedTypesofData
 |alignment=Vertical
 |structuredtext=In general, you need the following types of data:
 ====Interaction data====
@@ Line 37: / Line 31: @@
 See {{Link-SomewhereInThisVersion|manual=Help|topic=dataUpload|display text=the relevant portion of the Help}} for how to use the GPR application to view your uploaded data and append data to existing datasets.
 |Status=No
 }}{{Section
@@ Line 44: / Line 36: @@
 |anchor=csvSetup
 |alignment=Vertical
 |structuredtext=Use the following guidelines to construct CSV files for data uploads:
@@ Line 61: / Line 51: @@
 To add records, you must remove some uploaded records using the GPR API <tt>*/purge</tt> endpoints.
 |FAQHeading=How should I configure a CSV file for data upload?
 |Status=No
@@ Line 68: / Line 57: @@
 |anchor=dataFormat
 |alignment=Vertical
 |structuredtext=*When you create the CSV data file for a dataset, Agent Profile, or Customer Profile, do not include the following in the column name for the field to be used as the ID_FIELD, the Agent ID, or the Customer ID:
 *ID
@@ Line 90: / Line 77: @@
 **"{'vq_1':0.54,'vq_2':6.43}"
 *In SQL queries, use of angle brackets (&lt;&gt;) to signify "not" is not supported. Genesys recommends that you use the following symbols instead: '''!='''.
 |Status=No
 }}{{Section
@@ Line 97: / Line 82: @@
 |anchor=ModelData
 |alignment=Vertical
 |structuredtext=The following size limits apply to Model creation:
@@ Line 114: / Line 97: @@
 *Maximum number of agents that can be scored in one scoring request - 1,000.
 |Status=No
 }}{{Section
@@ Line 121: / Line 102: @@
 |anchor=anonymize
 |alignment=Vertical
 |structuredtext=PII, or personally identifiable information, and sensitive data, such as passwords, must be hidden when you upload it to the GPR Core platform. To ensure that sensitive data is secured, instruct GPR to anonymize the fields containing such data.
@@ Line 151: / Line 130: @@
 #If one of the anonymized fields is the employeeId, after the ActivatePredictiveRouting subroutine receives the response to the score request, it maps the agent scores back to the non-anonymized versions of the employee IDs so that routing can proceed.
 #Before the GPRIxnCleanup subroutine reports the routing outcome to the GPR Core Platform, it anonymizes all fields marked as PII that are included in the score outcome report. It then sends the results to the score log, which is stored in the cloud.
 |FAQHeading=How does Predictive Routing handle sensitive data and PII?
 |Status=No
@@ Line 158: / Line 136: @@
 |anchor=unsupported
 |alignment=Vertical
 |structuredtext=The following characters are not supported for column names. If GPR encounters these characters in a CSV file, it reads them as column delimiters and parses the data accordingly.
@@ Line 171: / Line 147: @@
 *If you have a TAB-delimited CSV file, add double quotations marks around TAB characters within column names; you do ''not'' need quotations for the , (comma) character.
 *You must ''always'' use double quotations for the pipe character.
 |Status=No
 }}{{Section
@@ Line 178: / Line 152: @@
 |anchor=retainData
 |alignment=Vertical
 |structuredtext=GPR follows standard Genesys data retention guidelines for Genesys Engage cloud as outlined in Section 14 of the {{RepositoryTemp|Genesys Cloud User Guide.pdf|278978137742|Genesys Engage cloud User Guide}}.
@@ Line 194: / Line 166: @@
 *Uploaded anonymized files - Deleted 7 days after upload.
 *Files stored for billing purposes - Deleted 60 days after creation.
 |Status=No
 }}
 }}

@@ Line 180: / Line 180: @@
 |Media=
 |image=
-|structuredtext=GPR follows standard Genesys data retention guidelines for PureEngage Cloud as outlined in Section 14 of the {{RepositoryTemp|Genesys Cloud User Guide.pdf|278978137742|Genesys Engage Cloud User Guide}}.
+|structuredtext=GPR follows standard Genesys data retention guidelines for Genesys Engage Cloud as outlined in Section 14 of the {{RepositoryTemp|Genesys Cloud User Guide.pdf|278978137742|Genesys Engage Cloud User Guide}}.
 Most objects and data are deleted automatically after 90 days during which they are inactive. These include the following:

@@ Line 7: / Line 7: @@
 |UseCase=
 |ComingSoon=No
-|Platform=PureEngage
+|Platform=GenesysEngage-onpremises
 |Role=
 |Application=

PE-GPR/9.0.0/Deployment/dataReqs - Revision history

WikiSysop at 12:45, March 31, 2022

Ed.jamer@genesys.com: Text replacement - "Genesys Cloud" to "Genesys Cloud CX"

Ed.jamer@genesys.com: Text replacement - "Genesys Engage [cC]loud" to "Genesys Multicloud CX"

Vivian.hood@genesys.com: Published

Vivian.hood@genesys.com: Published

Vivian: Published

WikiSysop: Text replacement - "\|Platform=([^\|]*)GenesysEngage-onpremises([\|]*)" to "|Platform=$1GenesysEngage-cloud$2"

WikiSysop: Text replacement - "Genesys Engage Cloud" to "Genesys Engage cloud"

WikiSysop: Text replacement - "PureEngage" to "Genesys Engage"

WikiSysop: Text replacement - "\|Platforms?=([^\|]*)PureEngage([\|]*)" to "|Platform=$1GenesysEngage-onpremises$2"

WikiSysop: Text replacement - "\|Platform=([^\|])GenesysEngage-onpremises([\|])" to "|Platform=$1GenesysEngage-cloud$2"

WikiSysop: Text replacement - "\|Platforms?=([^\|])PureEngage([\|])" to "|Platform=$1GenesysEngage-onpremises$2"