Versionen und Umgebungen

Sie können mehrere Versionen Ihres Agents erstellen und diese in separaten Umgebungen veröffentlichen.

Beim Bearbeiten eines Agents bearbeiten Sie den Agent-Entwurf. Sie können den Agent-Entwurf jederzeit als Agent-Version speichern. Dies ist ein nicht veränderbarer Snapshot Ihres Agents.

Wenn Sie den Agent-Entwurf speichern, wird er in der Standardumgebung veröffentlicht. Wenn Sie Agent-Versionen erstellen, können Sie sie in benutzerdefinierten Umgebungen veröffentlichen. Sie können eine Vielzahl von benutzerdefinierten Umgebungen für folgende Zwecke erstellen:

  • Test
  • Entwicklung
  • Produktion
  • usw.

Produktionstraffic

Agent-Versionen immer für Produktionstraffic verwenden

Ein Agent-Entwurf wird jedes Mal aktualisiert, wenn ein Entwickler in Ihrem Team eine Änderung vornimmt. Es kann leicht passieren, dass ein Agent-Entwurf aus Versehen unterbrochen wird, insbesondere wenn mehrere Personen Schreibzugriff auf den Agent haben. Darüber hinaus kann ein kürzlich bearbeiteter Agent-Entwurf möglicherweise nicht mit dem trainierten Modell übereinstimmen, da das Training verzögert sein kann oder eine manuelle Ausführung erfordert.

Sie sollten daher immer Agent-Versionen für Ihren Produktions-Traffic verwenden. Agent-Entwürfe sollten getestet werden, bevor sie zu Produktionsversionen hochgestuft werden. Sie können ein Rollback zu einer vorherigen Version durchführen, falls Probleme auftreten.

Mögliche Agent-Fehler beim Versionswechsel berücksichtigen

Wenn Sie eine Agentversion in Ihrer Produktionsumgebung ändern, während Sitzungen aktiv sind, kann das zu Agentenfehlern bei einigen aktiven Sitzungen führen. Diese Fehler können auftreten, wenn die vorherige und die neue Version nicht miteinander übereinstimmen und dadurch der Sitzungsstatus gestört wird. Daher sollten Sie die Versionen während der Ruhezeit oder außerhalb der Stoßzeiten ändern.

Version in einer neuen Umgebung veröffentlichen

So veröffentlichen Sie einen Agent-Entwurf in einer Version und erstellen eine benutzerdefinierte Umgebung:

Console

  1. Rufen Sie die Dialogflow ES-Konsole auf.
  2. Wählen Sie Ihren Agent im oberen Bereich der linken Seitenleiste aus.
  3. Klicken Sie neben dem Namen des Agents auf die Schaltfläche für die Einstellungen.
  4. Klicken Sie auf den Tab Environments (Umgebungen).
  5. Klicken Sie auf Publish a version (Version veröffentlichen).
  6. Fügen Sie optional eine Beschreibung hinzu und klicken Sie auf Next (Weiter).
  7. Wählen Sie +New Environment aus.

  8. Geben Sie einen Umgebungsnamen ein.

  9. Wählen Sie die Auftragsausführungsmethode für die Umgebung aus.

  10. Wählen Sie die Sprachausgabe-Einstellungen für die Umgebung aus.

  11. Klicken Sie auf Veröffentlichen.

  12. Die Umgebungsinformationen werden jetzt im Abschnitt Custom environments aufgeführt.

API

  1. Rufen Sie die Methode create für den Versionstyp auf, um eine neue Agent-Version zu erstellen.
  2. Rufen Sie die Methode create für den Umgebungstyp auf, um eine neue Umgebung zu erstellen. Geben Sie die Agent-Version, die Sie gerade erstellt haben, im Feld agentVersion an.

Frühere Version einer Umgebung wiederherstellen

Sie können eine Umgebung auf eine frühere Agent-Version zurücksetzen:

Console

  1. Klicken Sie im Abschnitt Custom environments (Benutzerdefinierte Umgebungen) auf eine Umgebung.
  2. Das Dialogfeld "Umgebungseinstellungen" wird geöffnet.
  3. Klicken Sie im Abschnitt Publishing History auf das Dreipunkt-Menü  einer bereits veröffentlichten Version.
  4. Klicken Sie auf Revert to this version.
  5. Der Veröffentlichungsverlauf wird aktualisiert.

API

Rufen Sie die Methode patch/update für den Umgebungstyp auf, um eine Umgebung zu aktualisieren. Geben Sie die zuvor erstellte Agent-Version im Feld agentVersion an.

Frühere Version in Entwurf laden

Wenn Sie eine frühere Version in den Entwurf laden, wird der Agent-Entwurf in der Standardumgebung mit einer ausgewählten Agent-Version überschrieben.

So laden Sie eine vorherige Version als Entwurf:

Console

  1. Rufen Sie die Dialogflow ES-Konsole auf.
  2. Wählen Sie Ihren Agent im oberen Bereich der linken Seitenleiste aus.
  3. Klicken Sie neben dem Namen des Agents auf die Schaltfläche für die Einstellungen.
  4. Klicken Sie auf den Tab Environments (Umgebungen).
  5. Klicken Sie im Abschnitt Entwurf auf Alle Versionen ansehen.
  6. Klicken Sie auf die Schaltfläche für eine Version, die Sie in den Entwurf laden möchten.
  7. Klicken Sie auf Load to Draft (In Entwurf laden).
  8. Klicken Sie auf Yes, I'm sure (Ja, ich bin sicher).
  9. Laden Sie alle geöffneten Tabs des Browsertabs der Konsole neu, damit sie mit den neuesten Agent-Daten aktualisiert werden.

API

Rufen Sie die Methode patch/update für den Umgebungstyp mit den folgenden Eingaben auf:

  • Verwenden Sie - als Umgebungs-ID, um die Standardumgebung anzugeben.
  • allowLoadToDraftAndDiscardChanges auf „true“ festlegen.
  • Geben Sie im Feld agentVersion die Agent-Version an, die den Agent-Entwurf überschreibt.

Version exportieren

Wenn Sie eine Version exportieren möchten, müssen Sie sie zuerst in den Entwurf laden und dann den Agent exportieren.

Agent in einer Umgebung testen

Sie können mit der API Ihren Agent in einer beliebigen benutzerdefinierten Umgebung testen. Rufen Sie die Methode Intent erkennen auf, ändern Sie aber die Endpunkt-URL. Fügen Sie dazu environments/environment-name/users/-/ zwischen agent und sessions ein.

Der folgende Endpunkt verwendet beispielsweise die "Entwicklungsumgebung" mit einem nicht angegebenen Nutzer:

"https://dialogflow.googleapis.com/v2/projects/my-project-id/agent/environments/development/users/-/sessions/123456789:detectIntent"

Umgebungsspezifische Einstellungen

Auftragsausführung und Sprachausgabe werden von der Umgebung konfiguriert, sodass der Agent die Umgebungseinstellungen für diese Features verwendet.

Weitere Informationen dazu, wie Daten auf verschiedenen Ebenen angewendet werden, finden Sie unter Ebenen der Anwendungsausführung.

Google Assistant

Wenn Sie Release-Umgebungen von Actions on Google verwenden, lesen Sie die Beschränkungen der Versionsverwaltung für die Dialogflow-Bibliothek zur Auftragsausführung.

Mega-Agent

Funktionsweise von Versionen und Umgebungen in Mega-Agents

Beschränkungen

Es gelten folgende Einschränkungen:

  • Maximale Anzahl Umgebungen pro Agent: 10
  • Maximale Anzahl Versionen pro Agent: 1.000