Fehlerbehebung

Filtern Sie den Inhalt dieses Dokuments nach dem Agent-Typ-Tag:

Alle Conversational Agents (Dialogflow CX) Dialogflow ES

Filtern Sie den Inhalt dieses Dokuments nach dem Kategorie-Tag:

Alle API Console Auth Projekt Integration NLU Regex Speech-to-Text Text-to-Speech Laufzeit Generative AI

Cloud Logging für Ihren Kundenservicemitarbeiter aktivieren

Aktivieren Sie Cloud Logging für Ihren Kundenservicemitarbeiter. Das ist wichtig, um Daten zu erfassen und Probleme in echten Unterhaltungen zu diagnostizieren.

Unterhaltungs-IDs erfassen

Wenn unerwartetes Verhalten auftritt, erfassen Sie die Dialogflow-Unterhaltungs-IDs. Diese IDs, die im Unterhaltungsverlauf zu finden sind, bieten die Möglichkeit, den Ausführungspfad einer Unterhaltung nachzuvollziehen und bestimmte Interaktionen zu untersuchen.

Berechtigung für API-Aufruf wurde verweigert

Agent-Typ-Tags: Conversational Agents (Dialogflow CX), Dialogflow ES
Kategorie-Tags: API, Auth

Problem

PERMISSION_DENIED-Antwort für den API-Aufruf erhalten.

Lösung

Prüfen Sie, ob die Authentifizierung und die Rollen (Conversational Agents (Dialogflow CX), Dialogflow ES) richtig eingerichtet sind. Achten Sie insbesondere auf Folgendes:

• Ein Dienstkonto wurde erstellt und nicht versehentlich gelöscht.
• Das Dienstkonto hat eine Rolle erhalten, die die Berechtigung zum Aufrufen der gewünschten Methode gewährt.
• Die private Schlüsseldatei des Dienstkontos wurde heruntergeladen.
• Legen Sie die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS auf die private Schlüsseldatei fest.

Der API-Aufruf erwähnt ein unbekanntes Projekt

Agent-Typ-Tags: Conversational Agents (Dialogflow CX), Dialogflow ES
Kategorie-Tags: API, Projekt

Problem

Dialogflow API has not been used in project 32555940559-Fehler für API-Aufruf erhalten.

Lösung

Achten Sie auf Folgendes:

• Die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS wurde festgelegt (siehe PERMISSION_DENIED).
• Für den API-Aufruf wurde die richtige Projekt-ID bereitgestellt.

Fehler beim Abrufen des Anmeldedaten für die Authentifizierung für einen API-Aufruf

Agent-Typ-Tags: Conversational Agents (Dialogflow CX), Dialogflow ES
Kategorie-Tags: API, Auth

Problem

Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential.-Antwort für den API-Aufruf erhalten.

Lösung

Dies kann daran liegen, dass Anmeldedaten manuell mit Ihrer Clientbibliothek erstellt werden, während eine nicht standardmäßige Region angegeben wurde. Weitere Informationen finden Sie in den folgenden Anleitungen:

• Region mit der API (Konversations-Agents (Dialogflow CX)) auswählen
• Region mit der API (Dialogflow ES) auswählen

Die API-Aufrufantwort fordert einen Wechsel zu einem anderen Host an.

Agent-Typ-Tags: Conversational Agents (Dialogflow CX), Dialogflow ES
Kategorie-Tags: API, Auth

Problem

Please switch to 'REGION-dialogflow.googleapis.com' to access resources located in 'REGION'-Antwort für den API-Aufruf erhalten, wobei REGION eine bestimmte Regions-ID ist.

Lösung

Das passiert, wenn Sie in der Anfrage die Region, aber nicht den Endpunkt angeben. Weitere Informationen finden Sie in den folgenden Anleitungen:

• Region mit der API (Konversations-Agents (Dialogflow CX)) auswählen
• Region mit der API (Dialogflow ES) auswählen

Fehlende Felder in der API-Aufrufantwort

Agent-Typ-Tags: Conversational Agents (Dialogflow CX), Dialogflow ES
Kategorie-Tags: API

Problem

In der API-Antwort fehlen einige Felder.

Lösung

Wenn Sie für ein bestimmtes Feld in der API-Antwort einen numerischen Wert erwarten, ist das Feld möglicherweise nicht in der Antwort enthalten, wenn der zurückgegebene Wert 0 ist.

Weitere Informationen zum Verhalten von Standardwerten (einschließlich nicht numerischer Werte) finden Sie unter:

• Protocol Buffers (Conversational Agents (Dialogflow CX))
• Protocol Buffers (Dialogflow ES)

Projekt konnte wegen Sperre nicht gelöscht werden

Agent-Typ-Tags: Dialogflow ES
Kategorie-Tags: Projekt

Problem

Wenn Sie versuchen, ein Google Cloud-Projekt zu löschen, erhalten Sie eine Benachrichtigung, dass das Projekt nicht gelöscht werden kann, da es Sperren enthält und eine der Sperren Dialogflow ES betrifft.

Lösung

1. Prüfen Sie, ob Sie den mit dem Projekt verknüpften Dialogflow ES-Agenten nicht mehr benötigen. Falls Sie eine Benachrichtigung erhalten, dass der Agent nicht existiert, wurde er bereits gelöscht.

   Dialogflow ES-Konsole

   Öffnen Sie https://dialogflow.cloud.google.com/#/agent/project-id/intents.

   Dieser Link unterscheidet sich vom Link im Dialogfeld zum Löschen des Google Cloud-Projekts.

   Dialogflow API

   Verwenden Sie die Methode search des Typs agent.

2. Rufen Sie den Namen der Sperre ab.

   gcloud

   Verwenden Sie den Befehl gcloud alpha resource-manager liens list, wie in der Dokumentation Sperren für Projekte auflisten beschrieben.

   API Explorer

   Verwenden Sie das Feld Diese API testen auf der Seite Methode: liens.list:

   • Füllen Sie das Feld parent aus, wie in der Parameterbeschreibung vorgeschlagen.
   • Klicken Sie auf Ausführen.

3. Löschen Sie die Sperre.

   gcloud

   Verwenden Sie den Befehl gcloud alpha resource-liens delete LIEN_NAME, wie in der Dokumentation Sperren aus einem Projekt entfernen beschrieben.

   API Explorer

   Verwenden Sie das Feld Diese API testen auf der Seite Methode: liens.delete:

   • Geben Sie in das Feld name den Namen der Sperre ein, den Sie in Schritt 2 erhalten haben:
   • Klicken Sie auf Ausführen.

4. Beenden Sie das Projekt.

Dialogflow CX-Webhook schlägt mit dem Fehler „Frist überschritten“ fehl

Agent-Typ-Tags: Conversational Agents (Dialogflow CX)
Kategorie-Tags: Laufzeit

Problem

Ein Webhook, der von Dialogflow CX aufgerufen wurde, schlägt möglicherweise mit der folgenden Fehlermeldung fehl:

Webhook call failed. Error: DEADLINE_EXCEEDED

Das kann daran liegen, dass der Webhook-Aufruf das Timeout-Limit für Webhooks überschreitet. Folgende Gründe können dazu führen, dass das Zeitlimit für den Webhook-Aufruf überschritten wird:

1. Es wird versucht, eine nicht vorhandene Absicht auszulösen.

2. Ein Problem beim Kaltstart des Webhook-Backends (z. B. Cloud Functions).

3. Der Webhook ruft andere Dienste auf, was die Antwortzeit erhöht.

4. Keine Verbindung zwischen Kundenservicemitarbeiter und Webhook-Back-End (z. B. falsch konfigurierter Load Balancer)

5. Eine Organisationsrichtlinie verhindert, dass eingehender Traffic oder Dialogflow-Methoden ausgeführt werden.

Problemumgehung

Für einen Webhook gilt standardmäßig ein Zeitlimit von 5 Sekunden. Sie können das Webhook-Zeitlimit erhöhen, wenn Sie die Webhook-Ressource erstellen oder bearbeiten. Dadurch hat der Webhook mehr Zeit, um zu reagieren.

Projekt konnte nicht in der Console eingerichtet werden

Agent-Typ-Tags: Dialogflow ES
Kategorie-Tags: Konsole, Projekt

Problem

Beim Erstellen eines Agents mit der Konsole wurde der Fehler Failed to set up GCP project empfangen.

Lösung

Sie sind möglicherweise nicht berechtigt, Google Cloud-Projekte zu erstellen. Prüfen Sie, ob Sie ein Google Cloud-Projekt erstellen können, und zwar direkt in der Google Cloud Console. Wenn Sie kein Projekt erstellen können, folgen Sie den Empfehlungen in der Fehlermeldung.

In der Antwort angezeigte Sitzungsparameterreferenz

Agent-Typ-Tags: Conversational Agents (Dialogflow CX)
Kategorie-Tags: Konsole

Problem

Von Dialogflow zurückgegebene Antworten enthalten die Parameterverweise anstelle der Parameterwerte. Beispiel:
Hello, $session.params.customer_name

Die Parameter werden nicht aufgelöst und die Parameterreferenz wird angezeigt, wenn der Parameter in der aktuellen Sitzung nicht gefunden wird oder nicht gemäß seinem Typ verwendet wird.

Lösung

Dieses Problem kann auftreten, wenn der verwendete Parameter nicht in der Unterhaltung enthalten ist, einen Tippfehler enthält oder einen anderen Typ als den verwendeten hat.

Konsole schlägt fehl, wenn die API nicht aktiviert wurde

Agent-Typ-Tags: Conversational Agents (Dialogflow CX)
Kategorie-Tags: Konsole

Problem

Beim Erstellen eines Agents mit der Konsole wurde der Fehler Dialogflow API has not been enabled for the project. Code: FAILED_PRECONDITION empfangen.

Lösung

Folgen Sie den Einrichtungsschritten, um die Dialogflow API zu aktivieren.

Beim Versuch, über ein Organisationskonto auf die Console zuzugreifen, wird ein Dienstfehler angezeigt

Agent-Typ-Tags: Conversational Agents (Dialogflow CX), Dialogflow ES
Kategorie-Tags: Konsole

Problem

Beim Versuch, über Ihr Organisationskonto auf die Console zuzugreifen, wurde der Fehler You don't have access to this service empfangen.

Lösung

Wenden Sie sich an den Systemadministrator Ihrer Organisation und prüfen Sie, ob die Einstellungen Ihrer Organisation Zugriff auf die Konsole gewähren.

Wenn die Einstellungen Ihrer Organisation den Zugriff zulassen sollten und Sie Ihr Konto von einer anderen Organisation migriert haben, wurde Ihr Konto möglicherweise von Google als eingeschränkt gekennzeichnet. Das ist wahrscheinlich der Fall, wenn andere Nutzer in Ihrer Organisation auf die Konsole zugreifen können, Sie aber nicht. Wenden Sie sich an den Support, um Hilfe zu erhalten.

Agent kann aufgrund fehlenden Ablaufs nicht im JSON-Format exportiert werden

Agent-Typ-Tags: Conversational Agents (Dialogflow CX)
Kategorie-Tags: Konsole

Problem

Der Export des Kundenservicemitarbeiters als Rohbytes wird erfolgreich abgeschlossen, der Export des Kundenservicemitarbeiters im JSON-Format schlägt jedoch mit einer ähnlichen Fehlermeldung fehl:

Flow 'projects/PROJECT_ID/locations/LOCATION_ID/agents/AGENT_ID/flows/FLOW_ID' does not exist
in the agent

Dieses Problem kann durch einen Testfall verursacht werden, der auf einen gelöschten Ablauf verweist.

Lösung

Prüfen Sie zur Behebung dieses Problems nicht verwendete Testfälle, um festzustellen, ob der in der Fehlermeldung erwähnte Ablauf in einem Testfall verwendet wird. Löschen Sie dann die bestätigten Testfälle.

Telefonie-Gateway-Konnektivität

Agent-Typ-Tags: Dialogflow ES
Kategorie-Tags: Integration

Problem

Bei Verwendung des Telefon-Gateways erhalten Sie ein Besetztzeichen oder der Anruf bricht ab.

Lösung

Für dieses Feature gibt es Kontingente und Limits. Wenn Sie ein Besetztzeichen erhalten oder der Anruf unterbrochen wird, haben Sie möglicherweise Ihr Kontingent überschritten.

RESOURCE_EXHAUSTED-Fehler beim Erstellen einer neuen Telefonnummer

Agent-Typ-Tags: Conversational Agents (Dialogflow CX), Dialogflow ES
Kategorie-Tags: Integration

Problem

Beim Versuch, eine neue Telefonnummer in Conversational Agents (Dialogflow CX), Dialogflow ES oder Agent Assist zu erstellen, wird der Fehler RESOURCE_EXHAUSTED zurückgegeben.

Lösung

Dieser Fehler bedeutet, dass Sie das Limit für Telefonnummern pro Projekt überschritten haben. Wenn Sie eine neue Telefonnummer erstellen möchten, löschen Sie nicht verwendete Telefonnummern, die mit Ihrem Projekt verknüpft sind, bis Sie unter dem Grenzwert liegen.

Wenn Sie Telefonnummern im Telefonie-Gateway für konversationelle Kundenservicemitarbeiter (Dialogflow CX) oder im Telefonie-Gateway für Dialogflow ES erstellt haben, können Sie sie in der Konsole löschen. Wenn Sie den Kundenservicemitarbeiter löschen, ohne die Telefonnummer zu löschen, wird die zugehörige Telefonnummer nicht gelöscht.

Alternativ können Sie die API verwenden. Führen Sie dazu die folgenden Schritte aus.

Schritt 1: Ermitteln Sie alle Telefonnummern, die mit Ihrem Projekt verknüpft sind.

Verwenden Sie die API-Methode projects.phoneNumbers/list oder projects.locations.phoneNumbers.list für alle Regionen, in denen Sie Telefonnummern erstellt haben, um die mit Ihrem Projekt verknüpften Telefonnummern zu ermitteln.

• Verwenden Sie für die Region global den folgenden Befehl:

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/global/phoneNumbers
  

• Bei anderen Regionen müssen Sie die Region an zwei Stellen angeben:

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://REGION_ID-dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/REGION_ID/phoneNumbers
  

Schritt 2: Optional: Agents identifizieren, die mit den Konversationsprofilen verknüpft sind

Wenn Sie die Kundenservicemitarbeiter-ID von Conversational Agents (Dialogflow CX), die mit der Telefonnummer verknüpft ist, über das Konversationsprofil abrufen, können Sie feststellen, ob der Kundenservicemitarbeiter noch verwendet wird und ob die Telefonnummer noch benötigt wird. Verwenden Sie dazu die API-Methode projects.conversationProfiles/get. Sie finden die IDs der Unterhaltungsprofile in den Antworten auf die Befehle, die Sie in Schritt 1 ausgeführt haben.

• Verwenden Sie für die Region global den folgenden Befehl:

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/global/conversationProfiles/CONVERSATION_PROFILE_ID
  

• Geben Sie für andere Regionen die Region an zwei Stellen an:

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://REGION_ID-dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/REGION_ID/conversationProfiles/CONVERSATION_PROFILE_ID
  

Sie können den Agenten in der Konsole für Conversational Agents (Dialogflow CX) anhand seiner ID finden. Verwenden Sie dazu auf der Seite Alle Kundenservicemitarbeiter ansehen die Option Suchen.

Bei Dialogflow ES kann ein Projekt maximal mit fünf Kundenservicemitarbeitern verknüpft werden und ein Dialogflow ES-Kundenservicemitarbeiter kann mit einer Telefonnummer verknüpft werden. Sie können den Agent also über https://dialogflow.cloud.google.com/#/editAgent/PROJECT_ID/intents in der Dialogflow ES-Konsole öffnen.

Wenn kein Kundenservicemitarbeiter gefunden wird, können Sie die Telefonnummer trotzdem löschen, wenn Sie sicher sind, dass sie nicht mehr benötigt wird.

Schritt 3: Nicht verwendete Telefonnummern löschen

Verwenden Sie die API-Methode projects.phoneNumbers/delete oder projects.locations.phoneNumbers.delete, um nicht mehr benötigte Telefonnummern zu löschen. Die Telefonnummern-IDs finden Sie in der Antwort auf die Befehle, die Sie in Schritt 1 ausgeführt haben.

• Verwenden Sie für die Region global den folgenden Befehl:

  curl -X DELETE \
      -H "Authorization: Bearer "$(gcloud auth print-access-token) \
      -H "X-Goog-User-Project: PROJECT_ID" \
      -H "Content-Type: application/json; charset=utf-8" \
      https://dialogflow.googleapis.com/v2beta1/PHONE_NUMBER_ID
  

• Geben Sie für andere Regionen die Region an:

  curl -X DELETE \
      -H "Authorization: Bearer "$(gcloud auth print-access-token) \
      -H "X-Goog-User-Project: PROJECT_ID" \
      -H "Content-Type: application/json; charset=utf-8" \
      https://REGION_ID-dialogflow.googleapis.com/v2beta1/PHONE_NUMBER_ID
  

Dialogflow CX Messenger antwortet nicht

Agent-Typ-Tags: Conversational Agents (Dialogflow CX)
Kategorie-Tags: Integration

Problem

Keine Agent-Antwort für Dialogflow CX Messenger-Interaktionen.

Lösung

Wenn Sie keine Antworten von Dialogflow CX Messenger sehen, prüfen Sie, ob die Abrechnung für das Projekt aktiviert ist und die Dialogflow API für das Projekt aktiviert ist. Einrichtungsanleitung aufrufen.

Parameterwert stimmt überein, ist aber kein Entitätssynonym

Agent-Typ-Tags: Conversational Agents (Dialogflow CX), Dialogflow ES
Kategorie-Tags: NLU

Problem

Allgemeiner Fall: Ein Parameterwert wird zur Laufzeit extrahiert, obwohl die dem Parameter entsprechende Entität den übereinstimmenden Wert nicht als Synonym enthält.

Ein konkreterer Fall: Nachdem ein Synonym aus einer Entität gelöscht und der Kundenservicemitarbeiter neu geschult wurde, wird dieses Synonym weiterhin als Parameterwert für diese Entität extrahiert.

Lösung

1. Verwenden Sie die Option Suchen, um zu prüfen, ob der übereinstimmende Wert im Agenten als implizite Entität vorhanden ist (Conversational Agents (Dialogflow CX), Dialogflow ES). Alle Intents mit Anmerkungen zu diesem Parameter und dieser Entität finden

2. Korrigieren Sie die Anmerkungen, indem Sie dafür sorgen, dass keine dieser Anmerkungen auf den Text angewendet wird, der den unerwünschten übereinstimmenden Wert darstellt.

3. Testen Sie den Bot zur Laufzeit, um zu prüfen, ob das Problem behoben ist.

4. Wenn das Problem weiterhin besteht, prüfen Sie, ob die Optionen Automatische Erweiterung und Inklusive Übereinstimmung in den erweiterten Entitätseinstellungen deaktiviert sind. Testen Sie den Agenten dann noch einmal.

Der Sprachbot überspringt einige Antworten

Agent-Typ-Tags: Conversational Agents (Dialogflow CX)
Kategorie-Tags: Text-to-Speech

Problem

Bei einem Agenten, der sowohl für Text als auch für Sprache entwickelt wurde, liest der Voicebot einige der Antworten nicht vor.

Lösung

Wenn für eine bestimmte Unterhaltungsrunde mindestens eine Audiotextausgabe-Antwort definiert ist, muss die Option „Audiotextausgabe“ in allen Schritten für diese Unterhaltungsrunde in den Erfüllungs- und Webhook-Antworten des Kundenservicemitarbeiters vorhanden sein.

SSML-Tags werden nicht angewendet

Agent-Typ-Tags: Conversational Agents (Dialogflow CX), Dialogflow ES
Kategorie-Tags: Text-to-Speech

Problem

SSML-Tags sind in der Agent-Ausführung definiert, der Voicebot liest den synthetisierten Text jedoch ohne SSML-Effekte vor.

Lösung

Achten Sie darauf, dass pro Antwortkarte in der Dialogflow-Konsole oder pro Antwortnachrichtenobjekt nur ein <speak></speak>-Paar vorhanden ist, wenn Antworten über die API oder den Webhook bereitgestellt werden.

Der Sprach-Agent spricht die Null als Buchstaben O aus

Agent-Typ-Tags: Conversational Agents (Dialogflow CX)
Kategorie-Tags: Text-to-Speech

Problem

Bei einem für Sprache entwickelten Agenten liest der Voice-Agent Nullen als Buchstaben „O“ anstelle von „Null“ vor.

Lösung

1. Ändern Sie Agent says in Output audio text dialogue option.
2. Setzen Sie ein Häkchen bei „SSML“.
3. Setzen Sie den Text in ein SSML-Tag:

     <speak>
       <say-as interpret-as='verbatim'>YOUR_TEXT</say-as>
     </speak>

4. Speichern.

Bei Kreditkartennummern werden Nullen beispielsweise als Nullen geschrieben.

      <speak>
        <say-as interpret-as='verbatim'>5177 7702 8500 4578</say-as>
      </speak>
   

Unerwartete synthetische Aussprache

Agent-Typ-Tags: Conversational Agents (Dialogflow CX), Dialogflow ES
Kategorie-Tags: Text-to-Speech

Problem

Die synthetische Aussprache von Antworten von Kundenservicemitarbeitern (z. B. Eigennamen, Akronyme) ist nicht wie erwartet.

Lösung

Wenn Sie eine bestimmte Aussprache für nicht allgemein bekannte Wörter gewährleisten möchten, verwenden Sie in den Antworten des Kundenservicemitarbeiters das SSML-Tag say-as oder phoneme.

Die maximal zulässige Anzahl von Ausführungsschritten für den Zustandsautomaten wurde erreicht

Agent-Typ-Tags: Conversational Agents (Dialogflow CX)
Kategorie-Tags: Laufzeit

Problem

Beim Senden von Laufzeitanfragen an den Agenten wird in der Konsole für Conversational Agents (Dialogflow CX) oder in den Protokollen die folgende Fehlermeldung angezeigt:

You have reached the maximum allowed state machine execution steps. You may consider simplifying your agent/flow design. Current execution steps are: [<array_of_objects>]

Das Array in der Fehlermeldung enthält eine Liste der Ausführungsschritte für die Anfrage. Die Liste ist möglicherweise unvollständig, wenn die Anzahl der Schritte zu groß ist.

Lösung

Diese Fehlermeldung weist in der Regel darauf hin, dass die Anzahl der Übergänge für einen einzelnen Gesprächsschritt zu groß ist. Ein häufiges Beispiel ist die Weiterleitung zurselben Seite, was zu einem endlosen Loop führt.

So beheben Sie das Problem:

1. Kopieren Sie das JSON-Array aus der Fehlermeldung.
2. Optional: Formatieren Sie das kopierte Array für eine bessere Lesbarkeit als „Pretty JSON“. Wenn die Fehlermeldung abgeschnitten ist, suchen Sie nach dem letzten „Step“-Objekt, löschen Sie das unvollständige Schrittobjekt und das vorangestellte Komma und fügen Sie einen abschließenden Array-Schlußstrich hinzu, bevor Sie die JSON-Datei validieren und formatieren.
3. Sehen Sie sich die Werte für "TriggeredTransitionRouteId" und "TargetPage" für jeden Schritt an. Bei einem unendlichen Loop enthalten die Felder "TriggeredTransitionRouteId" und "TargetPage" für die meisten Schritte sich wiederholende Werte.
4. Ändern Sie das Design des Kundenservicemitarbeiters, um die Übergänge in einer Endlosschleife zu entfernen oder die Anzahl der Übergänge für einen einzelnen Gesprächsschritt zu reduzieren.

Übereinstimmung mit regulärem Ausdruck zu allgemein

Agent-Typ-Tags: Conversational Agents (Dialogflow CX), Dialogflow ES
Kategorie-Tags: Regex

Problem

Beim Erstellen einer regulären Ausdrucks-Entität wurde der Fehler Regular expression match is too broad ausgegeben (Conversational Agents (Dialogflow CX), Dialogflow ES).

Lösung

Betrachten Sie den folgenden Ansatz:

• Verwenden Sie ^ und $ im regulären Ausdruck, um den Anfang bzw. das Ende des Textes anzugeben.
• Verwenden Sie das Regex-Objekt mit einem erforderlichen Parameter (Konversations-Agents (Dialogflow CX), Dialogflow ES)
• Definieren Sie die Aufforderungen für erforderliche Parameter, damit der Endnutzer nur den Entitätswert ohne umgebende Wörter angeben muss.

Von der Spracherkennung eingefügte unerwünschte nicht alphanumerische Zeichen

Agent-Typ-Tags: Conversational Agents (Dialogflow CX), Dialogflow ES
Kategorie-Tags: Spracherkennung

Problem

Beim Abgleich alphanumerischer Zeichen werden vom Spracherkennungssystem unerwünschte nicht alphanumerische Zeichen (Leerzeichen, Bindestriche usw.) eingefügt, was dazu führt, dass die Entität nicht abgeglichen wird.

Lösung

1. Wenn Sie Systementitäten zum Abgleichen von Zahlen verwenden, sollten Sie stattdessen reguläre Ausdrucksentitäten verwenden (Conversational Agents (Dialogflow CX), Dialogflow ES).
2. Folgen Sie allen Empfehlungen im Abschnitt Falsche alphanumerische Spracherkennung durch Regex-Entitäten.
3. Wenn Sie Nummern über Telefonieintegrationen abgleichen möchten, sollten Sie zusätzlich zur Spracherkennung eine DTMF-Option verwenden.

Leere Transkripte für Spracheingaben

Agent-Typ-Tags: Conversational Agents (Dialogflow CX), Dialogflow ES
Kategorie-Tags: Spracherkennung

Problem

Dialogflow-Antworten für Spracheingaben geben leere Transkripte zurück. Die Anfragen werden als keine Eingabe oder keine Übereinstimmung behandelt.

Lösung

Hören Sie sich die Audioaufnahme an, um zu prüfen, ob sie Sprache enthält.

Die Sprachanpassung muss in den Agenteneinstellungen aktiviert sein (Conversational Agents (Dialogflow CX), Dialogflow ES).

Wenn die Sprachadaption nicht hilft, testen Sie die folgenden Sprachmodelle in einer nicht produktionsnahen Umgebung und verwenden Sie das Modell mit den besten Ergebnissen:

• latest_short
• phone_call
• command_and_search

Informationen zu den unterstützten Sprachmodellen für andere Sprachen als Englisch finden Sie in der Dokumentation Von Speech-to-Text unterstützte Sprachen.

Wie Sie ein Sprachmodell angeben, hängt davon ab, wie Sie Interaktionen mit Dialogflow einrichten.

• Geben Sie für API-Anfragen den Modellnamen im Feld model in InputAudioConfig an (Conversational Agents (Dialogflow CX), Dialogflow ES).

• Wenn Sie das Telefon-Gateway verwenden (Conversational Agents (Dialogflow CX), Dialogflow ES), können Sie das Sprachmodell im Konversationsprofil aktualisieren, das von Dialogflow erstellt wurde, als Sie die Integration aktiviert haben:

  1. Rufen Sie die ID des Unterhaltungsprofils ab:

     • Mit der Methode conversationProfiles.list können Sie alle Unterhaltungsprofile abrufen, die mit Ihrem Projekt verknüpft sind.
     • Suchen Sie das Unterhaltungsprofil, das Sie aktualisieren möchten, und kopieren Sie den Wert des Felds name.

     Beim Dialogflow CX-Telefonie-Gateway finden Sie den Anzeigenamen des Unterhaltungsprofils in den Integrationseinstellungen. Beim Dialogflow ES-Telefonie-Gateway entspricht der Anzeigename des Unterhaltungsprofils dem Namen des Kundenservicemitarbeiters, für den die Integration aktiviert wurde.

     Wenn Sie mehrere Konversationsprofile mit demselben Anzeigenamen haben, überprüfen Sie die Kundenservicemitarbeiter-ID im Feld automatedAgentConfig in der Antwort der Methode conversationProfiles.list.

  2. Verwenden Sie die API-Methode conversationProfiles.patch, um das Feld model in SpeechToTextConfig zu aktualisieren.

• Bei Contact Center AI-Integrationen wenden Sie sich an Ihren Telefonie-Integrator, um zu erfahren, wie Sie das Sprachmodell für die Integration oder für einzelne Anfragen aktualisieren.

Leere Seite mit dem Fehler „Dateigröße überschreitet 2 MB“ beim Vergleichen von Kundenservicemitarbeiterversionen

Agent-Typ-Tags: Conversational Agents (Dialogflow CX)
Kategorie-Tags: Konsole

Problem

Beim Vergleichen von zwei verschiedenen Agentenversionen wird der Bildschirm leer und die folgende Fehlermeldung wird angezeigt:

File size exceeds 2MB

Dieses Problem tritt auf, wenn eine der Dateien eine Größe von 2 MB überschreitet.

Lösung

Wenn Sie Agentversionen vergleichen möchten, bei denen eine der Dateien größer als 2 MB ist, wird die API-Methode compareVersion empfohlen.

Falsche Spracherkennung alphanumerischer Zeichen durch RegExp-Entitäten

Agent-Typ-Tags: Conversational Agents (Dialogflow CX), Dialogflow ES
Kategorie-Tags: Spracherkennung, Regex

Problem

Es wurden ungenaue Transkripte für Spracheingaben mit alphanumerischen Zeichen empfangen, die mit einer regulären Ausdrucks-Entität abgeglichen werden sollen (Conversational Agents (Dialogflow CX), Dialogflow ES).

Lösung

1. Die Sprachanpassung muss in den Agenteneinstellungen aktiviert sein (Conversational Agents (Dialogflow CX), Dialogflow ES).
2. Achten Sie darauf, dass mindestens ein Entitätseintrag alle Anforderungen an reguläre Ausdrücke erfüllt (Conversational Agents (Dialogflow CX), Dialogflow ES).
3. Verwenden Sie für bestimmte Muster die möglichst spezifischen regulären Ausdrücke. Verwenden Sie beispielsweise [a-zA-Z]{2}\d{5} anstelle von [a-zA-Z0-9]{7} für eine alphanumerische Zeichenfolge, die mit zwei Buchstaben beginnt und von fünf Ziffern gefolgt wird.
4. Achten Sie darauf, dass Ihr regulärer Ausdruck auch nicht alphanumerische Zeichen (Leerzeichen, Bindestriche usw.) abgleicht, die vom Spracherkennungssystem eingefügt werden können. Um die Anforderung 2 dieser Liste zu erfüllen, erstellen Sie mehrere Entitätseinträge: einen Eintrag, der die Anforderung 2 dieser Liste erfüllt, und einen weiteren, der nicht alphanumerische Zeichen berücksichtigt. So können Sie beispielsweise fünf Ziffern angeben und auch nicht alphanumerische Zeichen zulassen:

    \d{5}
    (\d[^a-zA-Z0-9]*){5}
   

5. Achten Sie darauf, dass Ihr Agent die Anforderungen an die Parameterdefinition erfüllt (Conversational Agents (Dialogflow CX), Dialogflow ES).

   Beispiel für Conversational Agents (Dialogflow CX)

   

   Beispiel für Dialogflow ES

   
6. Achten Sie darauf, dass Ihr Agent die Anmerkungsanforderungen für Trainingsphrasen erfüllt (Conversational Agents (Dialogflow CX), Dialogflow ES).

   Beispiel für Dialogflow ES

   
7. Achten Sie darauf, dass Ihre Tests den Testrichtlinien entsprechen (Konversations-KI-Agents (Dialogflow CX), Dialogflow ES).
8. So entfernen Sie nicht alphanumerische Zeichen, die möglicherweise vom Spracherkennungssystem eingefügt wurden:
   • Für Conversational Agents (Dialogflow CX): SUBSTITUTE-Systemfunktion oder Webhook
   • Für Dialogflow ES: webhook
9. Einschränkungen der Sprachanpassung prüfen (Konversations-KI-Agents (Dialogflow CX), Dialogflow ES)

Für kontrollierte Unterhaltungen entwerfen

Erstellen Sie Ihren Agenten mit klar definierten Unterhaltungspfade. Der Kundenservicemitarbeiter muss die Informationen anfordern können, die erforderlich sind, um die Anforderungen der Nutzer zu erfüllen. Vermeiden Sie zu weit gefasste Unterhaltungen, da dies zu unvorhersehbarem Verhalten führen kann.

Protokolle analysieren

Die Eingaben und Ausgaben von Playbooks, Tools und Datenspeichern werden in den Protokollen erfasst. Anhand der erfassten Konversations-IDs können Sie die Aufrufabfolge nachvollziehen und ermitteln, wo die Ausführung fehlgeschlagen ist.

Mit Prompts experimentieren

Wenn eine bestimmte Anleitung nicht wie erwartet funktioniert, versuchen Sie, sie umzuformulieren. Alternativ können Sie mit Gemini Prompts generieren (Meta-Prompting). Mit diesem iterativen Ansatz können Sie die optimale Formulierung für Ihren Anwendungsfall finden.

Vollständige Informationen an den Support senden

Wenn Sie eine Supportanfrage beim Cloud-Support stellen, fügen Sie die relevanten Unterhaltungs-IDs und Protokolle hinzu, die Sie während der Untersuchung erfasst haben. Diese Informationen sind entscheidend für eine effiziente Fehlerbehebung.