概览
自定义亮点功能的工作方式与智能亮点功能类似。亮点包含 CX Insights 认为对于确定用户意图至关重要的关键字、短语或句子。如果存在精彩集锦,系统会在返回的转写内容中为其添加标签。 智能亮点功能会根据一系列预设场景自动检测亮点,而自定义亮点功能则允许您指定应被识别为亮点的自定义条件。
自定义亮点可以由一个或多个词组匹配规则组构成。词组匹配规则组包含一条或多条规则。您可以使用以下参数来自定义规则的行为。
确定匹配的规则
您可以指定是仅当其中一个规则组解析为 true 时,还是当所有规则组都解析为 true 时,才应检测到精彩片段。同样,您可以指定,如果仅满足规则组中的一条规则,或者必须满足规则组中所有规则的条件,则规则组应解析为 true。
使用 Contact Center AI Insights API 创建自定义亮点
检测指定查询字符串列表中的“任何”字符串
以下示例会创建一个 PhraseMatcher 对象,该对象会指示 CX Insights 在对话中出现两个短语中的任意一个时,为该短语添加亮点标签。这两个短语无需同时出现,即可被检测为精彩片段。
REST
如需了解完整详情,请参阅 PhraseMatcherType 和 PhraseMatchRuleGroupType 参考文档。将 PHONE 和 CELLPHONE 替换为两个 query 字段后,应会生成示例输出。
在使用任何请求数据之前,请先进行以下替换:
- PROJECT_ID:您的 Google Cloud 项目 ID。
- DISPLAY_NAME:短语匹配器的直观易懂名称。
- QUERY:要匹配的字词或短语。
HTTP 方法和网址:
POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/phraseMatchers
请求 JSON 正文:
{
"display_name": DISPLAY_NAME,
"type": "ANY_OF",
"active": true,
"phrase_match_rule_groups": {
"type": "ANY_OF",
"phrase_match_rules": {
"query": QUERY
"config": {
"exact_match_config": {}
}
},
"phrase_match_rules": {
"query": QUERY
"config": {
"exact_match_config": {}
}
}
}
}
如需发送您的请求,请展开以下选项之一:
您应该收到类似以下内容的 JSON 响应:
{
"name": "projects/PROJECT_ID/locations/us-central1/phraseMatchers/PHRASE_MATCHER_ID",
"revisionId": "REVISION_ID",
"revisionCreateTime": "2021-01-20T10:10:10.123000Z",
"displayName": "PHONE_SERVICE",
"type": "ANY_OF",
"active": true,
"phraseMatchRuleGroups": [
{
"type": "ANY_OF",
"phraseMatchRules": [
{
"query": "PHONE",
"config": {
"exactMatchConfig": {}
}
},
{
"query": "CELLPHONE",
"config": {
"exactMatchConfig": {}
}
}
]
}
],
"activationUpdateTime": "2021-01-20T10:10:10.123000Z"
}
Python
如需向 CX Insights 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
Java
如需向 CX Insights 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
Node.js
如需向 CX Insights 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
检测指定查询字符串列表中的“所有”字符串
以下示例创建了一个 PhraseMatcher 对象,该对象指示 CX Insights 为确实包含第一个 phraseMatchRuleGroups 中的查询字词,但不包含第二个 'phraseMatchRuleGroups` 中的查询字词的对话添加突出显示标签。
REST
如需了解完整详情,请参阅 PhraseMatcherType 和 PhraseMatchRuleGroupType 参考文档。将 PHONE 和 CELLPHONE 替换为两个 query 字段,将 SHIPPING 和 DELIVERY 替换为后两个 query 字段,应该会生成示例输出。该示例指示 CX Insights 为包含“手机”和“cellphone”但不包含“shipping”或“delivery”的对话添加突出显示标签。
在使用任何请求数据之前,请先进行以下替换:
- PROJECT_ID:您的 Google Cloud 项目 ID。
- DISPLAY_NAME:短语匹配器的直观易懂名称。
- QUERY:要匹配的字词或短语。
HTTP 方法和网址:
POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/phraseMatchers
请求 JSON 正文:
{
"display_name": DISPLAY_NAME,
"type": "ALL_OF",
"active": true,
"phrase_match_rule_groups": {
"type": "ANY_OF",
"phrase_match_rules": {
"query": QUERY
"config": {
"exact_match_config": {}
}
},
"phrase_match_rules": {
"query": QUERY
"config": {
"exact_match_config": {}
}
},
"phrase_match_rule_groups": {
"type": "ALL_OF",
"phrase_match_rules": {
"query": QUERY
"negated": "true"
"config": {
"exact_match_config": {}
}
},
"phrase_match_rules": {
"query": QUERY
"negated": "true"
"config": {
"exact_match_config": {}
}
}
}
}
}
如需发送您的请求,请展开以下选项之一:
您应该收到类似以下内容的 JSON 响应:
{
"name": "projects/PROJECT_ID/locations/us-central1/phraseMatchers/PHRASE_MATCHER_ID",
"revisionId": "456456456",
"revisionCreateTime": "2021-01-20T10:10:10.123000Z",
"displayName": "NON_SHIPPING_PHONE_SERVICE",
"type": "ALL_OF",
"active": true,
"phraseMatchRuleGroups": [
{
"type": "ANY_OF",
"phraseMatchRules": [
{
"query": "PHONE",
"config": {
"exactMatchConfig": {}
}
},
{
"query": "CELLPHONE",
"config": {
"exactMatchConfig": {}
}
}
]
},
{
"type": "ALL_OF",
"phraseMatchRules": [
{
"query": "SHIPPING",
"negated": true,
"config": {
"exactMatchConfig": {}
}
},
{
"query": "DELIVERY",
"negated": true,
"config": {
"exactMatchConfig": {}
}
}
]
}
],
"activationUpdateTime": "2021-01-20T10:10:10.123000Z"
}
Python
如需向 CX Insights 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
Java
如需向 CX Insights 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
Node.js
如需向 CX Insights 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。