Übersicht
Benutzerdefinierte Highlights funktionieren ähnlich wie die Smart Highlights. Ein Highlight enthält Keywords, Formulierungen oder Sätze, die von CX Insights als wichtig für die Ermittlung der Nutzerabsicht erkannt werden. Falls Highlights vorhanden sind, werden sie im zurückgegebenen Transkript gekennzeichnet. Bei „Smarte Highlights“ werden Highlights automatisch anhand einer Reihe voreingestellter Szenarien erkannt. Bei „Benutzerdefinierte Highlights“ können Sie benutzerdefinierte Kriterien festlegen, die als Highlights erkannt werden sollen.
Ein benutzerdefiniertes Highlight kann aus einer oder mehreren Regelgruppen für passende Wortgruppen bestehen. Eine Gruppe mit Regeln für Wortgruppenübereinstimmung enthält eine oder mehrere Regeln. Mit den folgenden Parametern können Sie das Verhalten Ihrer Regeln anpassen.
Regeln zur Bestimmung einer Übereinstimmung
Sie können angeben, ob ein Highlight erkannt werden soll, wenn nur eine der Regelgruppen in true aufgelöst wird oder wenn alle Regelgruppen in true aufgelöst werden.
Sie können auch festlegen, dass für eine Regelgruppe true zurückgegeben werden soll, wenn nur eine ihrer Regeln erfüllt ist oder wenn die Bedingungen für alle Regeln in der Regelgruppe erfüllt sein müssen.
Benutzerdefiniertes Highlight mit der CX Insights API erstellen
„Beliebige“ Elemente einer Liste angegebener Suchanfragen erkennen
Im folgenden Beispiel wird ein PhraseMatcher-Objekt erstellt, mit dem CX Insights angewiesen wird, Hervorhebungs-Labels für eine von zwei Formulierungen hinzuzufügen, wenn sie in einer Unterhaltung vorkommen. Beide Formulierungen müssen nicht vorkommen, damit sie als Highlight erkannt werden.
REST
Ausführliche Informationen finden Sie in der Referenzdokumentation zu PhraseMatcherType und PhraseMatchRuleGroupType. Wenn Sie PHONE und CELLPHONE durch die beiden query-Felder ersetzen, sollte die Beispielausgabe angezeigt werden.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: Projekt-ID in Google Cloud .
- DISPLAY_NAME: Der für Menschen lesbare Name des Phrase-Matchers.
- QUERY: Das Wort oder die Wortgruppe, die abgeglichen werden soll.
HTTP-Methode und URL:
POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/phraseMatchers
JSON-Text anfordern:
{
"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": {}
}
}
}
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"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
Richten Sie zur Authentifizierung bei CX Insights die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Richten Sie zur Authentifizierung bei CX Insights die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Richten Sie zur Authentifizierung bei CX Insights die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Alle Elemente einer Liste angegebener Abfragestrings erkennen
Im folgenden Beispiel wird ein PhraseMatcher-Objekt erstellt, mit dem CX Insights angewiesen wird, Konversationen, die die Suchbegriffe im ersten phraseMatchRuleGroups enthalten, aber die Suchbegriffe im zweiten 'phraseMatchRuleGroups` nicht enthalten, Highlight-Labels hinzuzufügen.
REST
Ausführliche Informationen finden Sie in der Referenzdokumentation zu PhraseMatcherType und PhraseMatchRuleGroupType. Wenn Sie PHONE und CELLPHONE für die ersten beiden query-Felder und SHIPPING und DELIVERY für die zweiten beiden query-Felder einsetzen, sollte die Beispielausgabe angezeigt werden. Im Beispiel wird CX Insights angewiesen, Konversationen, die „Smartphone“ und „Mobiltelefon“ enthalten, aber nicht „Versand“ oder „Lieferung“, mit Highlight-Labels zu versehen.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: Projekt-ID in Google Cloud .
- DISPLAY_NAME: Der für Menschen lesbare Name des Phrase-Matchers.
- QUERY: Das Wort oder die Wortgruppe, die abgeglichen werden soll.
HTTP-Methode und URL:
POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/phraseMatchers
JSON-Text anfordern:
{
"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": {}
}
}
}
}
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"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
Richten Sie zur Authentifizierung bei CX Insights die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Richten Sie zur Authentifizierung bei CX Insights die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Richten Sie zur Authentifizierung bei CX Insights die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.