Fehlerbehebung

Cloud Logging für Ihren Agenten aktivieren

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

Unterhaltungs-IDs erfassen

Wenn ein unerwartetes Verhalten auftritt, erfassen Sie die Dialogflow-Unterhaltungs-IDs. Diese IDs, die im Unterhaltungsverlauf zu finden sind, ermöglichen es, den Ausführungspfad einer Unterhaltung nachzuverfolgen und bestimmte Interaktionen zu untersuchen.

Berechtigung für API-Aufruf wurde verweigert

Vorgang

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

Lösung

Prüfen Sie, ob Sie die Authentifizierung und Rollen für (Dialogflow CX, Dialogflow ES) richtig eingerichtet haben. Achten Sie insbesondere auf Folgendes:

• Ein Dienstkonto wurde erstellt und nicht versehentlich gelöscht.
• Dem Dienstkonto wurde eine Rolle zugewiesen, die die Berechtigung zum Aufrufen der ausgewählten Methode gewährt.
• Die private Schlüsseldatei des Dienstkontos wurde heruntergeladen.
• Legen Sie die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS auf die Datei mit dem privaten Schlüssel fest.

Der API-Aufruf erwähnt ein unbekanntes Projekt

Vorgang

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

Lösung

Achten Sie auf Folgendes:

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

API-Aufruf erhält Fehler „Ungültige Authentifizierungsdaten“

Vorgang

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

Das kann daran liegen, dass Sie Anmeldedaten mit Ihrer Clientbibliothek manuell erstellt und dabei eine nicht standardmäßige Region angegeben haben. Weitere Informationen finden Sie in den folgenden Anleitungen:

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

API-Aufrufantwort fordert einen Wechsel zu einem anderen Host an

Vorgang

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

Lösung

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

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

Fehlende Felder in der Antwort auf den API-Aufruf

Vorgang

In der API-Antwort fehlen einige Felder.

Lösung

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

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

• Protokollzwischenspeicher (Dialogflow CX)
• Protokollzwischenspeicher (Dialogflow ES)

Projekt konnte wegen Sperre nicht gelöscht werden

Vorgang

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 hat. Eine der Sperren bezieht sich auf Dialogflow ES.

Lösung

1. Achten Sie darauf, dass Sie den mit dem Projekt verknüpften Dialogflow ES-Agenten nicht mehr benötigen. Wenn Sie eine Benachrichtigung erhalten, dass der Agent nicht vorhanden ist, wurde er bereits gelöscht.

   Dialogflow ES-Konsole

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

   Dieser Link unterscheidet sich von dem Link im Dialogfeld zum Löschen des Projekts in Google Cloud .

   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 im 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

Vorgang

Ein Webhook, der von Dialogflow CX aufgerufen wurde, kann mit dieser Fehlermeldung fehlschlagen:

Webhook call failed. Error: DEADLINE_EXCEEDED

Dies kann passieren, wenn der Webhook-Aufruf das Webhook-Zeitlimit überschreitet. Mögliche Gründe für die Überschreitung des Zeitlimits beim Webhook-Aufruf:

• Es wird versucht, einen nicht vorhandenen Intent auszulösen.
• Ein Kaltstartproblem mit dem Webhook-Backend (z. B. Cloud Functions).
• Der Webhook ruft andere Dienste auf, was die Antwortzeit erhöht.
• Keine Verbindung zwischen Agent und Webhook-Backend (z. B. falsch konfigurierter Load Balancer).
• Organisationsrichtlinie, die eingehenden Traffic oder die Ausführung von Dialogflow-Methoden verhindert.

Problemumgehung

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

Projekt konnte nicht in der Console eingerichtet werden

Vorgang

Beim Erstellen eines Agenten mit der Console ist der Fehler Failed to set up GCP project aufgetreten.

Lösung

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

In der Antwort angezeigter Verweis auf den Sitzungsparameter

Vorgang

Die von Dialogflow zurückgegebenen Antworten enthalten die Parameterreferenzen anstelle der Werte der Parameter. 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 wenn der Parameter 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 Typ hat.

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

Vorgang

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 das Organisationskonto auf die Console zuzugreifen, ist ein Dienstfehler aufgetreten

Vorgang

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

Lösung

Wenden Sie sich an den Systemadministrator Ihrer Organisation und prüfen Sie, ob die Einstellungen Ihrer Organisation Zugriff auf die Console gewähren. Andernfalls sollten Sie prüfen, ob Ihr migriertes Konto von einer anderen Organisation von Google als eingeschränkt gekennzeichnet wurde. Das ist wahrscheinlich das Problem, wenn andere Nutzer in Ihrer Organisation auf die Console zugreifen können, Sie aber nicht.

Alternativ können Sie sich an den Support wenden, um Unterstützung zu erhalten.

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

Vorgang

Der Export des Agenten als Roh-Bytes wird erfolgreich abgeschlossen, aber der Export des Agenten im JSON-Format schlägt mit einer Fehlermeldung wie der folgenden fehl:

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

Dieses Problem kann auftreten, wenn ein Testlauf auf einen gelöschten Ablauf verweist.

Lösung

Um dieses Problem zu beheben, prüfen Sie, ob der in der Fehlermeldung genannte Ablauf in Testfällen verwendet wird, und löschen Sie die entsprechenden Testfälle.

Telefonie-Gateway-Konnektivität

Vorgang

Wenn Sie ein Telefon-Gateway verwenden, hören Sie ein Besetztzeichen oder der Anruf wird abgebrochen.

Lösung

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

Fehler „RESOURCE_EXHAUSTED“ beim Erstellen einer neuen Telefonnummer

Vorgang

Wenn Sie versuchen, eine neue Telefonnummer in 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 Limit sind.

Wenn Sie Telefonnummern im Dialogflow CX Phone Gateway oder Dialogflow ES Phone Gateway erstellt haben, können Sie sie in der Console löschen. Wenn Sie den Agenten löschen, ohne die Telefonnummer zu löschen, wird die zugehörige Telefonnummer nicht gelöscht.

Alternativ können Sie die API mit den folgenden Schritten verwenden.

Schritt 1: Alle mit Ihrem Projekt verknüpften Telefonnummern identifizieren

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
  

• Für andere 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) Mit den Konversationsprofilen verknüpfte Agenten identifizieren

Wenn Sie die mit der Telefonnummer verknüpfte Dialogflow CX-Agenten-ID über das Konversationsprofil abrufen, können Sie feststellen, ob der Agent noch verwendet wird und ob die Telefonnummer noch benötigt wird. Dazu können Sie die API-Methode projects.conversationProfiles/get verwenden. Sie finden die Konversationsprofil-IDs 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 anhand seiner ID in der Dialogflow CX-Konsole finden, indem Sie auf der Seite Alle Agenten ansehen die Option Suchen verwenden.

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

Wenn kein Agent 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

Wenn Sie Telefonnummern löschen möchten, die nicht mehr benötigt werden, verwenden Sie die API-Methode projects.phoneNumbers/delete oder projects.locations.phoneNumbers.delete. Die Telefonnummer-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

Vorgang

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

Lösung

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

Der Parameterwert wurde abgeglichen, ist aber kein Entitätssynonym

Vorgang

• Allgemeiner Fall: Ein Parameterwert wird zur Laufzeit extrahiert, obwohl die dem Parameter entsprechende Entität den übereinstimmenden Wert nicht als Synonym enthält.
• Ein spezifischerer Fall: Nachdem ein Synonym aus einer Entität gelöscht und der Agent neu trainiert 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 (Dialogflow CX, Dialogflow ES). Suchen Sie alle Intents, die Annotationen mit diesem Parameter und dieser Entität haben.
2. Korrigieren Sie die Annotationen, indem Sie dafür sorgen, dass keine dieser Annotationen auf den Text angewendet wird, der den unerwünschten übereinstimmenden Wert darstellt.
3. Testen Sie den Agenten zur Laufzeit, um zu prüfen, ob das Problem behoben wurde.
4. Wenn das Problem weiterhin besteht, prüfen Sie, ob die Optionen Automatische Erweiterung und Fuzzy-Abgleich in den erweiterten Entitätseinstellungen deaktiviert sind, und testen Sie den Agenten noch einmal.

Voicebot überspringt einige Antworten

Vorgang

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

Lösung

Wenn für eine bestimmte Unterhaltungsrunde mindestens eine Audioausgabetext-Antwort definiert ist, muss die Option für den Audioausgabetext in allen Schritten dieser Unterhaltungsrunde in den Antworten des Agenten und des Webhooks konsistent vorhanden sein.

SSML-Tags werden nicht wirksam

Vorgang

SSML-Tags sind im Agent-Fulfillment definiert, aber der Voice-Bot liest den synthetisierten Text ohne SSML-Effekte.

Lösung

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

Der Sprach-KI-Agent spricht die Null als Buchstabe O aus.

Vorgang

Bei einem KI-Agenten, der für Sprache entwickelt wurde, liest der Sprach-KI-Agent Nullen als Buchstabe O statt als Null.

Lösung

1. Ändern Sie Agent sagt, um die Dialogoption „Audioausgabe“ zu verwenden.
2. Aktivieren Sie das Kästchen „SSML“.
3. Fügen Sie ein SSML-Tag um Ihren Text ein:

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

4. Speichern.

Beispiel: Nullen in Kreditkartennummern werden als Nullen buchstabiert:

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

Unerwartete synthetisierte Aussprache

Vorgang

Die synthetisierte Aussprache von Agent-Antworten (z.B. Eigennamen, Akronyme) entspricht nicht den Erwartungen.

Lösung

Wenn Sie bestimmte Aussprachen für nicht allgemein bekannte Wörter garantieren möchten, verwenden Sie in den Antworten des Agents das SSML-Tag say-as oder phoneme.

Die maximal zulässige Anzahl von Ausführungsschritten der Zustandsmaschine wurde erreicht

Vorgang

In der Dialogflow CX-Konsole oder in den Logs wurde die folgende Fehlermeldung angezeigt, wenn Laufzeitanfragen an den Agent gesendet wurden:

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ächsbeitrag zu groß ist. Ein häufiges Beispiel ist der Übergang zur selben Seite, wodurch eine Endlosschleife entsteht.

So beheben Sie das Problem:

1. Kopieren Sie das JSON-Array aus der Fehlermeldung.
2. (Optional) Formatieren Sie das kopierte Array als Pretty JSON, um die Lesbarkeit zu verbessern. Wenn die Fehlermeldung abgeschnitten ist, suchen Sie nach dem letzten „Step“-Objekt, löschen Sie das unvollständige Schrittobjekt und das vorangehende Komma und fügen Sie eine schließende Array-Klammer hinzu, bevor Sie das JSON-Objekt validieren und formatieren.
3. Sehen Sie sich die Werte "TriggeredTransitionRouteId" und "TargetPage" für jeden Schritt an. Im Fall einer Endlosschleife haben die Felder "TriggeredTransitionRouteId" und "TargetPage" für die meisten Schritte sich wiederholende Werte.
4. Ändern Sie das Design Ihres KI-Agenten, um die Übergänge in Endlosschleifen zu entfernen oder die Anzahl der Übergänge für einen einzelnen Gesprächsbeitrag zu reduzieren.

Übereinstimmung mit regulärem Ausdruck ist zu allgemein

Vorgang

Beim Erstellen einer RegEx-Entität ist der Fehler Regular expression match is too broad aufgetreten (Dialogflow CX, Dialogflow ES).

Lösung

Ziehen Sie den folgenden Ansatz in Betracht:

• Verwenden Sie ^ und $ im regulären Ausdruck, um den Anfang bzw. das Ende des Textes anzugeben.
• Verwenden Sie die RegEx-Entität mit einem erforderlichen Parameter (Dialogflow CX, Dialogflow ES).
• Definieren Sie die erforderlichen Parameteraufforderungen, um den Endnutzer aufzufordern, nur den Entitätswert ohne umgebende Wörter anzugeben.

Unerwünschte nicht alphanumerische Zeichen, die durch die Spracherkennung eingefügt wurden

Vorgang

Beim Abgleich von alphanumerischen Zeichen werden von der Spracherkennung 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 für den Abgleich von Zahlen verwenden, sollten Sie stattdessen RegEx-Entitäten (Dialogflow CX, Dialogflow ES) verwenden.
2. Folgen Sie allen Empfehlungen im Abschnitt Ungenauigkeiten bei der Spracherkennung von alphanumerischen Zeichen durch RegEx-Entitäten.
3. Für den Abgleich von Zahlen mithilfe von Telefonie-Integrationen sollten Sie zusätzlich zur Spracherkennung eine DTMF-Option in Betracht ziehen.

Leere Transkripte für Spracheingaben

Vorgang

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.

Achten Sie darauf, dass die Sprachanpassung in den Agent-Einstellungen aktiviert ist (Dialogflow CX, Dialogflow ES).

Wenn das Aktivieren der Sprachanpassung nicht hilft, experimentieren Sie mit den folgenden Sprachmodellen in einer Nicht-Produktionsumgebung und verwenden Sie das Modell, das die besten Ergebnisse liefert:

• latest_short
• phone_call
• command_and_search

Informationen zu anderen Sprachen als Englisch finden Sie in der Dokumentation zu den von Speech-to-Text unterstützten Sprachen.

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

• Geben Sie bei API-Anfragen den Modellnamen im Feld model in InputAudioConfig an (Dialogflow CX, Dialogflow ES).

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

  1. Rufen Sie die Konversationsprofil-ID ab:

     • Verwenden Sie die Methode conversationProfiles.list, um alle mit Ihrem Projekt verknüpften Konversationsprofile abzurufen.
     • Suchen Sie das Konversationsprofil, das Sie aktualisieren möchten, und kopieren Sie den Feldwert name.

     Für das Dialogflow CX Phone Gateway finden Sie den Anzeigenamen des Konversationsprofils in den Integrationseinstellungen. Beim Dialogflow ES-Telefon-Gateway entspricht der Anzeigename des Konversationsprofils dem Namen des KI-Agenten, für den die Integration aktiviert wurde.

     Wenn Sie mehrere Konversationsprofile mit demselben Anzeigenamen haben, prüfen Sie die Agenten-ID im Feld automatedAgentConfig aus 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 sollten Sie sich bei Ihrem Telefonie-Integrator erkundigen, wie Sie das Sprachmodell für die Integration oder für einzelne Anfragen aktualisieren können.

Playbook-Schleifenfehler verstehen

Vorgang

Beim Verknüpfen von Playbooks tritt der Fehler Playbook <playbookID> caused loop in playbook routes auf.

Lösung

Eine Schleife kann auftreten, wenn Sie versuchen, zu einem „übergeordneten“ Playbook weiterzuleiten, das das aktuelle Playbook direkt oder indirekt aufgerufen hat. Prüfen Sie, ob das Playbook-Routing unidirektional ist und nicht zu einem übergeordneten Playbook im selben Konversationspfad zurückführt.

Fehler „Dateigröße überschreitet 2 MB“ beim Vergleichen von Agent-Versionen

Vorgang

Wenn Sie versuchen, zwei verschiedene Agent-Versionen zu vergleichen, wird der Bildschirm leer und die folgende Fehlermeldung wird angezeigt:

File size exceeds 2MB

Dieses Problem tritt auf, weil eine der Dateien größer als 2 MB ist.

Lösung

Wenn Sie Agent-Versionen vergleichen möchten, bei denen eine der Dateien größer als 2 MB ist, sollten Sie die API-Methode compareVersion verwenden.

Ungenauigkeiten bei der Spracherkennung von alphanumerischen Zeichen durch RegEx-Entitäten

Vorgang

Es wurden ungenaue Transkripte für Spracheingaben von alphanumerischen Zeichen empfangen, die mit einer RegEx-Entität übereinstimmen sollen (Dialogflow CX, Dialogflow ES).

Lösung

1. Achten Sie darauf, dass die Sprachanpassung in den Agent-Einstellungen aktiviert ist (Dialogflow CX, Dialogflow ES).
2. Achten Sie darauf, dass mindestens ein Entitätseintrag alle Anforderungen für Regex-Einträge erfüllt (Dialogflow CX, Dialogflow ES).
3. Verwenden Sie für bestimmte Muster die spezifischsten regulären Ausdrücke. Verwenden Sie beispielsweise für einen alphanumerischen Wert, der mit zwei Buchstaben beginnt, gefolgt von fünf Ziffern, [a-zA-Z]{2}\d{5} anstelle von [a-zA-Z0-9]{7}.
4. Achten Sie darauf, dass Ihre Regex-Entität den Abgleich von nicht alphanumerischen Zeichen (Leerzeichen, Bindestriche usw.) zulässt, die von der Spracherkennung eingefügt werden können. Um die Anforderung 2 aus dieser Liste zu erfüllen, erstellen Sie mehrere Entitätseinträge: einen Eintrag, um die Anforderung 2 dieser Liste zu erfüllen, und einen weiteren, um nicht alphanumerische Zeichen zu berücksichtigen. Beispiel: So können Sie fünf Ziffern abgleichen und 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 (Dialogflow CX, Dialogflow ES).

   Beispiel für Dialogflow CX

   

   Beispiel für Dialogflow ES

   
6. Achten Sie darauf, dass Ihr Agent die Anforderungen für die Annotation von Trainingsformulierungen erfüllt (Dialogflow CX, Dialogflow ES).

   Beispiel für Dialogflow ES

   
7. Achten Sie darauf, dass Ihre Tests den Testrichtlinien entsprechen (Dialogflow CX, Dialogflow ES).
8. Wenn Sie nicht alphanumerische Zeichen entfernen möchten, die möglicherweise von der Spracherkennung eingefügt wurden, verwenden Sie Folgendes:
   • Für Dialogflow CX: Systemfunktion SUBSTITUTE oder Webhook
   • Für Dialogflow ES: Webhook
9. Einschränkungen der Sprachanpassung prüfen (Dialogflow CX, Dialogflow ES)

Für kontrollierte Unterhaltungen entwickeln

Erstellen Sie Ihren KI-Agenten mit klar definierten Gesprächspfaden. Achten Sie darauf, dass der Agent die Informationen anfordern kann, die zum Erfüllen der Nutzeranforderungen erforderlich sind. Vermeiden Sie einen zu breiten Gesprächsumfang, da dies zu unvorhersehbarem Verhalten führen kann.

Logs analysieren

Die Ein- und Ausgaben von Playbooks, Tools und Datenspeichern werden in den Logs erfasst. Verwenden Sie die erfassten Unterhaltungs-IDs, um die Kette von Aufrufen zu verfolgen und festzustellen, wo die Ausführung fehlgeschlagen ist.

Mit Prompts experimentieren

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

Vollständige Informationen für den Support bereitstellen

Wenn Sie eine Supportanfrage beim Cloud-Support stellen, geben Sie die relevanten Unterhaltungs-IDs und Logs an, die Sie während Ihrer Untersuchung erfasst haben. Diese Informationen sind für die effiziente Fehlerbehebung entscheidend.