Intents bestimmen, welche Nutzeranfragen verstanden werden und welche Aktion ausgeführt werden soll. In den meisten Fällen verwenden Sie die Dialogflow ES-Konsole, um Intents zu verwalten. In komplexeren Szenarien können Sie die API verwenden, um Intents zu verwalten. In diesem Dokument wird beschrieben, wie Sie Intents mithilfe der API erstellen, auflisten und löschen.
Hinweis
Führen Sie zuerst die folgenden Schritte aus:
Agent erstellen
- Rufen Sie die Dialogflow ES-Konsole auf.
- Melden Sie sich in der Console an, wenn Sie dazu aufgefordert werden. Weitere Informationen finden Sie in der Übersicht über die Dialogflow-Konsole.
- Maximieren Sie im Menü der Seitenleiste Lade-Agents.
- Klicken Sie auf Neuen Agent erstellen.
- Geben Sie den Namen des KI-Agenten, die Standardsprache und die Standardzeitzone ein.
- Geben Sie ein vorhandenes Projekt ein. Wenn Sie ein Projekt über die Dialogflow-Konsole erstellen möchten, wählen Sie Neues Google-Projekt erstellen aus.
- Klicken Sie auf Erstellen.
Mit IntentView alle Intent-Daten zurückgeben
Standardmäßig gibt die API abgekürzte Intent-Daten zurück, wenn Sie einen Intent erstellen, auflisten oder abrufen. In den folgenden Beispielen wird dieser Standardwert verwendet.
Wenn Sie alle Intent-Daten abrufen möchten, müssen Sie den Parameter IntentView auf INTENT_VIEW_FULL festlegen. Weitere Informationen zu Intent-Daten finden Sie in den Methoden für den Typ Intents.
Intent erstellen
In den folgenden Beispielen wird gezeigt, wie Sie einen Intent erstellen. Weitere Informationen zu Intents finden Sie in der Referenz zu Intents.
REST
Wenn Sie einen Intent für Ihren Agenten erstellen möchten, rufen Sie die Methode create für die Ressource intent auf.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: Ihre Projekt-ID in Google Cloud
HTTP-Methode und URL:
POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/intents
JSON-Text anfordern:
{
"displayName": "ListRooms",
"priority": 500000,
"webhookState": "WEBHOOK_STATE_UNSPECIFIED",
"trainingPhrases": [
{
"type": "EXAMPLE",
"parts": [
{
"text": "What rooms are available at 10am today?"
}
]
}
],
"action": "listRooms",
"messages": [
{
"text": {
"text": [
"Here are the available rooms:"
]
}
}
]
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
Das Pfadsegment nach intents enthält Ihre neue Intent-ID.
Go
Richten Sie zur Authentifizierung bei Dialogflow CX Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Richten Sie zur Authentifizierung bei Dialogflow CX Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Richten Sie zur Authentifizierung bei Dialogflow CX Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Richten Sie zur Authentifizierung bei Dialogflow CX Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Weitere Sprachen
C#: Folgen Sie der Anleitung zur Einrichtung von C# auf der Seite „Clientbibliotheken“ und rufen Sie dann die Dialogflow CX-Referenzdokumentation für .NET auf.
PHP Folgen Sie der Anleitung zur Einrichtung von PHP auf der Seite der Clientbibliotheken und rufen Sie dann die Dialogflow CX-Referenzdokumentation für PHP auf.
Ruby: Folgen Sie der Anleitung zum Einrichten von Ruby auf der Seite der Clientbibliotheken und rufen Sie dann die Dialogflow CX-Referenzdokumentation für Ruby auf.
Intents auflisten
Die folgenden Beispiele zeigen, wie Intents aufgelistet werden. Weitere Informationen finden Sie in der Intents-Referenz.
REST
Rufen Sie die Methode list für die Ressource intents auf, um die Intents für Ihren Agenten aufzulisten.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: Ihre Projekt-ID in Google Cloud
HTTP-Methode und URL:
GET https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/intents
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"intents": [
{
"name": "projects/PROJECT_ID/agent/intents/5b290a94-55d6-4074-96f4-9c4c4879c2bb",
"displayName": "ListRooms",
"priority": 500000,
"action": "listRooms",
"messages": [
{
"text": {
"text": [
"Here are the available rooms:"
]
}
}
]
},
...
]
}
Die Pfadsegmente nach intents enthalten Ihre Intent-IDs.
Go
Richten Sie zur Authentifizierung bei Dialogflow CX Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Richten Sie zur Authentifizierung bei Dialogflow CX Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Richten Sie zur Authentifizierung bei Dialogflow CX Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Richten Sie zur Authentifizierung bei Dialogflow CX Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Weitere Sprachen
C#: Folgen Sie der Anleitung zur Einrichtung von C# auf der Seite „Clientbibliotheken“ und rufen Sie dann die Dialogflow CX-Referenzdokumentation für .NET auf.
PHP Folgen Sie der Anleitung zur Einrichtung von PHP auf der Seite der Clientbibliotheken und rufen Sie dann die Dialogflow CX-Referenzdokumentation für PHP auf.
Ruby: Folgen Sie der Anleitung zum Einrichten von Ruby auf der Seite der Clientbibliotheken und rufen Sie dann die Dialogflow CX-Referenzdokumentation für Ruby auf.
Intents löschen
Die folgenden Beispiele zeigen, wie Sie einen Intent löschen. Weitere Informationen finden Sie in der Referenz zu Intents.
REST
Wenn Sie einen Intent für Ihren Agenten löschen möchten, rufen Sie die Methode delete für die Ressource intents auf.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: Ihre Projekt-ID in Google Cloud
- INTENT_ID mit Ihrer Intent-ID
HTTP-Methode und URL:
DELETE https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/intents/INTENT_ID
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.
Go
Richten Sie zur Authentifizierung bei Dialogflow CX Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Richten Sie zur Authentifizierung bei Dialogflow CX Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Richten Sie zur Authentifizierung bei Dialogflow CX Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Richten Sie zur Authentifizierung bei Dialogflow CX Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Weitere Sprachen
C#: Folgen Sie der Anleitung zur Einrichtung von C# auf der Seite „Clientbibliotheken“ und rufen Sie dann die Dialogflow CX-Referenzdokumentation für .NET auf.
PHP Folgen Sie der Anleitung zur Einrichtung von PHP auf der Seite der Clientbibliotheken und rufen Sie dann die Dialogflow CX-Referenzdokumentation für PHP auf.
Ruby: Folgen Sie der Anleitung zum Einrichten von Ruby auf der Seite der Clientbibliotheken und rufen Sie dann die Dialogflow CX-Referenzdokumentation für Ruby auf.