Ein Conversational Agents (Dialogflow CX)-Agent ist ein virtueller Agent, der nebenläufige Unterhaltungen mit Ihren Endnutzern abwickelt. Mithilfe von Natural Language Understanding (NLU) versteht der Agent die Nuancen der menschlichen Sprache. Konversations-Agents (Dialogflow CX) übersetzen Nutzereingaben in Text- oder Audioform im Laufe einer Unterhaltung in strukturierte Daten, die Ihre Anwendungen und Dienste verstehen können. Sie entwerfen und erstellen einen Agent für Konversations-Agents (Dialogflow CX), der die für Ihr System erforderlichen verschiedenen Typen von Unterhaltungen verarbeitet.
Ein Konversations-Agent (Dialogflow CX) ähnelt einem menschlichen Callcenter-Agent. Beide werden für die Bearbeitung erwarteter Szenarien trainiert. Dabei sind keine übermäßig genauen Vorgaben nötig.
Agent erstellen
So erstellen Sie einen Agent:
Console
- Öffnen Sie die Dialogflow CX-Konsole.
- Erstellen Sie ein Google Cloud-Projekt oder wählen Sie eines aus.
- Klicken Sie auf Agent erstellen.
- Wählen Sie Automatisch generieren aus, um einen Datenspeicher-Agent zu erstellen, oder Selbst erstellen, um andere Arten von Agents zu erstellen.
- Füllen Sie das Formular für die grundlegenden Agent-Einstellungen aus.
- Sie können einen beliebigen Anzeigenamen wählen.
- Wählen Sie den bevorzugten Standort aus. Klicken Sie auf die Schaltfläche Bearbeiten, wenn Sie die erweiterten Standorteinstellungen ändern möchten.
- Wählen Sie Ihre bevorzugte Zeitzone aus.
- Wählen Sie die Standardsprache für Ihren Agent aus. Sie können die Standardsprache für einen Agent nicht mehr ändern, nachdem er erstellt wurde.
- Klicken Sie auf Speichern.
API
Wenn Sie noch keine Standorteinstellungen für Ihr Projekt konfiguriert haben, müssen Sie dies über die Console tun, bevor Sie Agents mit der API erstellen. Derzeit können Sie Standorteinstellungen nicht mit der API konfigurieren.
Informationen zum Erstellen eines Agents finden Sie in der Methode create
für den Typ Agent
.
Wählen Sie ein Protokoll und eine Version für die Agent-Referenz aus:
Protokoll | V3 | V3beta1 |
---|---|---|
REST | Agent-Ressource | Agent-Ressource |
RPC | Agent-Oberfläche | Agent-Oberfläche |
C++ | AgentsClient | Nicht verfügbar |
C# | AgentsClient | Nicht verfügbar |
Go | AgentsClient | Nicht verfügbar |
Java | AgentsClient | AgentsClient |
Node.js | AgentsClient | AgentsClient |
PHP | Nicht verfügbar | Nicht verfügbar |
Python | AgentsClient | AgentsClient |
Ruby | Nicht verfügbar | Nicht verfügbar |
Agent-Daten
Agents für Conversational Agents (Dialogflow CX) dienen als übergeordnete Container für Einstellungen und Daten für virtuelle Agents. Agents sind folgenden Daten zugeordnet:
Weitere Informationen dazu, wie Daten auf verschiedenen Ebenen angewendet werden, finden Sie unter Ebenen für die Datenanwendung.
Agent exportieren und wiederherstellen
Sie können einen Agent in eine Datei exportieren und einen Agent mit dieser Datei wiederherstellen.
Ein Agent-Export umfasst alle Agent-Daten mit Ausnahme der folgenden:
- Ablaufversionen: Nur die Entwurfsabläufe werden in eine Datei exportiert.
- Umgebungen: Benutzerdefinierte Umgebungen werden nicht in eine Datei exportiert.
Bei der Wiederherstellung eines Agents werden alle Daten des Ziel-Agents (einschließlich aller Ablaufversionen) überschrieben, mit Ausnahme der folgenden:
- Umgebungen: Alle benutzerdefinierten Umgebungen bleiben im Ziel-Agent unverändert. Auf Ablaufversionen, auf die in benutzerdefinierten Umgebungen im Ziel-Agent verwiesen wird, kann weiterhin zugegriffen werden, solange die zugehörigen Umgebungen vorhanden sind. Diese alten Ablaufversionen werden jedoch nicht als auswählbare Ablaufversionen für den Agent aufgeführt.
- Vertex AI Agents-Apps:
Die Zuordnung zu einer Vertex AI Agents-App bleibt im Ziel-Agent unverändert. (Mit anderen Worten: der Wert von
engine
in GenAppBuilderSettings) Das bedeutet, dass Datenspeicher-Agents nur in andere vorhandene Datenspeicher-Agents wiederhergestellt werden können, da der resultierende Agent auch einer Vertex AI Agents-Anwendung zugeordnet sein muss. Vertex AI Agents-Datenspeicher: Alle Verweise auf Datenspeicher werden im Ziel-Agenten gemäß den folgenden Regeln überschrieben:
- Wenn der Ziel-Agent nicht mit einer App verknüpft ist, kann kein Agent mit Datenspeicherverweisen wiederhergestellt werden. Bei einem entsprechenden Versuch wird eine Fehlermeldung ausgegeben. Um das Problem zu beheben, können Sie entweder einen neuen Datenspeicher-Agent erstellen. Alternativ können Sie Ihren vorhandenen Agenten in einen Datenspeicher-Agenten umwandeln, indem Sie ihm einen Status-Handler für Datenspeicher hinzufügen. In diesem Fall werden Sie durch das Hinzufügen einer verknüpften App zu Ihrem Agenten geführt.)
- Wenn der Ziel-Agent mit einer App verknüpft ist, werden beim Wiederherstellen alle Data Store-Referenzen aktualisiert: Die Google Cloud-Projekt-ID und der Standort werden so aktualisiert, dass sie mit der App des Ziel-Agents übereinstimmen. Die Sammlungs-ID und die Datenspeicher-ID bleiben unverändert. Das bedeutet, dass Sie vor dem Wiederherstellungsvorgang Datenspeicher für alle IDs mit übereinstimmenden Typen in der App des Ziel-Agents hinzufügen müssen.
Beispiel: Wenn sich der Quell-Agent auf einen Datenspeicher mit dem Namen
projects/123/locations/eu-west2/collections/default_collection/dataStores/myDataStore1
bezieht und die App des Ziel-Agents den Namenprojects/321/locations/us-east1/collections/default_collections/engines/app123
hat, lautet die resultierende Datenspeicherreferenz im Ziel-Agent:projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1
Beim Exportieren können Sie das Exportdateiformat auswählen. Wenn Sie die Quellcodeverwaltung für Ihre Agentendaten verwenden, sollten Sie im JSON-Format exportieren. Wenn Sie einen Agent wiederherstellen, wird das Dateiformat automatisch von Conversational Agents (Dialogflow CX) ermittelt.
So exportieren Sie einen Agent oder stellen ihn wieder her:
Console
- Öffnen Sie die Dialogflow CX-Konsole.
- Wählen Sie das Google Cloud-Projekt für den Agent aus.
- Klicken Sie in der Liste auf das Dreipunkt-Menü more_vert für einen Agent in der Liste.
- Klicken Sie auf die Schaltfläche Exportieren oder Wiederherstellen.
- Folgen Sie der Anleitung, um den Vorgang abzuschließen.
API
Siehe die Methoden export
und restore
für den Typ Agent
.
Wählen Sie ein Protokoll und eine Version für die Agent-Referenz aus:
Protokoll | V3 | V3beta1 |
---|---|---|
REST | Agent-Ressource | Agent-Ressource |
RPC | Agent-Oberfläche | Agent-Oberfläche |
C++ | AgentsClient | Nicht verfügbar |
C# | AgentsClient | Nicht verfügbar |
Go | AgentsClient | Nicht verfügbar |
Java | AgentsClient | AgentsClient |
Node.js | AgentsClient | AgentsClient |
PHP | Nicht verfügbar | Nicht verfügbar |
Python | AgentsClient | AgentsClient |
Ruby | Nicht verfügbar | Nicht verfügbar |
Wenn die Agent-Größe die maximale Grenze überschreitet, verwenden Sie die Cloud Storage-Option für den Agent-Export und die Wiederherstellung.
Wenn Sie GitHub verwenden, lesen Sie auch die Anleitung zum Exportieren/Wiederherstellen von GitHub.
Agent löschen
Zum Löschen eines Agents benötigen Sie eine Rolle mit uneingeschränktem Zugriff oder Bearbeitungszugriff. Weitere Informationen finden Sie in der Anleitung zur Zugriffssteuerung.
So löschen Sie einen Agent:
Console
- Öffnen Sie die Dialogflow CX-Konsole.
- Wählen Sie das Google Cloud-Projekt für den Agent aus.
- Klicken Sie in der Liste auf das Dreipunkt-Menü more_vert für einen Agent in der Liste.
- Klicken Sie auf deleteLöschen.
- Bestätigen Sie den Löschvorgang im Dialogfeld.
API
Siehe die Methode delete
für den Typ Agent
.
Wählen Sie ein Protokoll und eine Version für die Agent-Referenz aus:
Protokoll | V3 | V3beta1 |
---|---|---|
REST | Agent-Ressource | Agent-Ressource |
RPC | Agent-Oberfläche | Agent-Oberfläche |
C++ | AgentsClient | Nicht verfügbar |
C# | AgentsClient | Nicht verfügbar |
Go | AgentsClient | Nicht verfügbar |
Java | AgentsClient | AgentsClient |
Node.js | AgentsClient | AgentsClient |
PHP | Nicht verfügbar | Nicht verfügbar |
Python | AgentsClient | AgentsClient |
Ruby | Nicht verfügbar | Nicht verfügbar |
Wenn Sie Ihr Projekt löschen, werden alle mit dem Projekt verknüpften Conversational Agents (Dialogflow CX) und Daten sofort gelöscht.