Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Wenn Sie keine Integrationsoption verwenden, müssen Sie Code schreiben, der direkt mit dem Endnutzer interagiert.
Sie müssen auch direkt mit der Dialogflow API interagieren, damit für jede Unterhaltungsrunde Endnutzerausdrücke gesendet und Intent-Abgleiche empfangen werden.
Das folgende Diagramm zeigt den Verarbeitungsablauf bei der Interaktion mit der API.
Der Endnutzer gibt einen Ausdruck ein oder spricht ihn aus.
Der Dienst sendet diesen Endnutzerausdruck in einer Anfragenachricht zur Intent-Erkennung an Dialogflow.
Dialogflow sendet eine Antwortnachricht für die Intent-Erkennung an den Dienst.
Diese Nachricht enthält Informationen zum zugeordneten Intent, zur Aktion, zu den Parametern und der für den Intent definierten Antwort.
Ihr Dienst führt die geeigneten Aktionen aus, z. B. Datenbankabfragen oder externe API-Aufrufe.
Ihr Dienst sendet eine Antwort an den Endnutzer.
Der Endnutzer sieht oder hört die Antwort.
Projekt einrichten und authentifizieren
Bevor Sie die API aufrufen, müssen Sie ein GCP-Projekt und eine Authentifizierungsmethode einrichten.
Sie können dabei der Kurzanleitung zur Einrichtung folgen.
Agent erstellen
In den meisten Fällen sollten Sie zum Erstellen von Agents die Dialogflow ES-Konsole (Dokumentation ansehen, Konsole öffnen) verwenden.
Beim Erstellen eines Agents können Sie der Kurzanleitung zur Konsole folgen.
Agents für komplexere Szenarien können Sie auch mit der Dialogflow API erstellen.
Auf vielen Konzeptseiten wird hauptsächlich das Erstellen von Agents mithilfe der Konsole behandelt, doch sie enthalten auch Links zu relevanten API-Typen.
REST, gRPC und Clientbibliotheken
Auf die Dialogflow API können Sie über REST, gRPC oder eine der bereitgestellten Clientbibliotheken zugreifen.
Weitere Informationen zu diesen Optionen finden Sie in der Übersicht zur API-Nutzung.
Sitzungen
Der Begriff Sitzung steht für eine Unterhaltung zwischen einem Dialogflow-Agent und einem Endnutzer.
Zu Beginn einer Unterhaltung erstellen Sie eine Sitzung und verwenden diese für jede Unterhaltungsrunde.
Sobald die Unterhaltung zu Ende ist, beenden Sie die Sitzung.
Für gleichzeitige Unterhaltungen mit verschiedenen Endnutzern sollten Sie nicht dieselbe Sitzung verwenden.
Dialogflow erhält für jede aktive Sitzung die aktuell aktiven Kontexte aufrecht.
Sitzungsdaten speichert Dialogflow 20 Minuten lang.
Jeder Sitzung wird von Ihrem System eine eindeutige Sitzungs-ID zugewiesen.
Sie erstellen eine neue Sitzung, indem Sie in einer Anfrage zur Intent-Erkennung eine neue Sitzungs-ID bereitstellen.
Eine Sitzungs-ID besteht aus einem String mit höchstens 36 Byte.
Die Verantwortung für die Generierung eindeutiger Sitzungs-IDs liegt bei Ihrem System.
Dabei kann es sich um Zufallszahlen, um gehashte Endnutzer-IDs oder um alle erdenklichen anderen Werte handeln, die Sie bequem generieren können.
Intent erkennen
Wenn Sie die API für Interaktionen verwenden, interagiert der Dienst direkt mit dem Endnutzer.
Für jede Unterhaltungsrunde ruft der Dienst die Methode detectIntent oder streamingDetectIntent des Sessions-Typs auf und sendet so Endnutzerausdrücke an Dialogflow.
Dialogflow antwortet mit Informationen zum zugeordneten Intent, zur Aktion, zu den Parametern und zu der für den Intent definierten Antwort.
Bei Bedarf führt Ihr Dienst Aktionen aus (z. B. Datenbankabfragen oder Aufrufe an externe APIs) und sendet eine Nachricht an den Endnutzer.
Dieser Vorgang wird fortgesetzt, bis die Unterhaltung beendet ist.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-18 (UTC)."],[[["\u003cp\u003eWhen not using pre-built integrations, direct interaction with Dialogflow's API is required for each conversational turn to process end-user input and receive intent matches.\u003c/p\u003e\n"],["\u003cp\u003eInteractions with the Dialogflow API follow a process where the service sends user expressions, Dialogflow returns intent data, and the service then performs actions and replies to the user.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, users need to set up a GCP project and authentication, which can be done through the provided setup quickstart.\u003c/p\u003e\n"],["\u003cp\u003eA session represents a conversation with an end-user, initiated with a unique session ID, and this ID should not be used for multiple concurrent conversations.\u003c/p\u003e\n"],["\u003cp\u003eTo interact, the service calls the \u003ccode\u003edetectIntent\u003c/code\u003e method to send the user's expressions to Dialogflow, which will respond with data about matched intents.\u003c/p\u003e\n"]]],[],null,["# API interactions\n\nIf you are not using one of the\n[integration](/dialogflow/docs/integrations)\noptions,\nyou must write code that directly interacts with the end-user.\nYou must also directly\n\ninteract with Dialogflow's API\n\nfor each conversational turn\nto send end-user expressions and receive intent matches.\nThe following diagram shows the processing flow when interacting with the API.\n\n1. The end-user types or speaks an expression.\n2. Your service sends this end-user expression to Dialogflow in a detect intent request message.\n3. Dialogflow sends a detect intent response message to your service. This message contains information about the matched intent, the action, the parameters, and the response defined for the intent.\n4. Your service performs actions as needed, like database queries or external API calls.\n5. Your service sends a response to the end-user.\n6. The end-user sees or hears the response.\n\nProject setup and authentication\n--------------------------------\n\nBefore calling the API,\nyou need to set up a GCP project and authentication.\nYou can follow the steps in the\n[Setup quickstart](/dialogflow/docs/quick/setup).\n\nAgent building\n--------------\n\nIn most cases you should use the Dialogflow ES console ([visit documentation](/dialogflow/docs/console), [open console](https://dialogflow.cloud.google.com)) to build agents.\nYou can follow the steps in the\n[console quickstart page](/dialogflow/docs/quick/build-agent)\nto create an agent.\nYou can also use the Dialogflow API to build agents for advanced scenarios.\nMany\n[concept pages](/dialogflow/docs/concepts)\nfocus on using the console to build agents,\nbut they also provide links to relevant API types.\n\nREST, gRPC, and client libraries\n--------------------------------\n\nYou can access the Dialogflow API via REST, gRPC,\nor one of the provided client libraries.\nFor the details on these options,\nsee the\n[API usage overview](/dialogflow/docs/reference/api-overview).\n\nSessions\n--------\n\n\nA *session* represents a conversation between a Dialogflow agent and an end-user.\nYou create a session at the beginning of a conversation\nand use it for each turn of the conversation.\nOnce the conversation has ended, you discontinue using the session.\n\n\nYou should not use the same session for\nconcurrent conversations with different end-users.\nDialogflow maintains the currently active contexts for each active session.\nSession data is stored by Dialogflow for 20 minutes.\n\n\nEach session is determined unique by a session ID generated by your system.\nYou create a new session by providing a new session ID in a\n[detect intent request](/dialogflow/docs/api-overview#detect-intent).\nA session ID is a string of at most 36 bytes in size.\nYour system is responsible for generating unique session IDs.\nThey can be random numbers, hashed end-user identifiers,\nor any other values that are convenient for you to generate.\n\nDetect intent\n-------------\n\n\nWhen you use the API for interactions,\nyour service interacts directly with the end-user.\nFor each conversational turn,\nyour service sends end-user expressions to Dialogflow by calling the\n`detectIntent` or `streamingDetectIntent` method of the\n[`Sessions`](/dialogflow/docs/reference/common-types#sessions)\ntype.\nDialogflow responds with information about the matched intent,\nthe action, the parameters, and the response defined for the intent.\nYour service performs actions as needed\n(for example, database queries or external API calls)\nand sends a message to the end-user.\nThis process continues until the conversation has ended.\n\nYou can find examples of calling detect intent in the\n[API quickstart page](/dialogflow/docs/quick/api)\nand the\n[how-to pages](/dialogflow/docs/how)."]]
