Verteilungsziele

TL;DR

Verteilen Sie eine gespeicherte Bot-Version an viele Ziel-Bots auf dieser Instanz oder auf andere Instanzen.

Verteilungsziele ermöglicht es einem Content Manager, eine gespeicherte Version an eine Liste von Remote-Bots auszurollen. Dies unterscheidet sich von Version verteilen unter Versionen: Letzteres klont Inhalte in einen Bot auf derselben Instanz, während Verteilungsziele eine gewählte Version an Ziel-Bots verteilt, die auf anderen Botario-Instanzen liegen können (z. B. ein Quellbot, der an viele Kundeninstanzen verteilt wird).

Öffnen Sie es über den Tab Versionen mit Verteilen → Extern.

Ein Ziel hinzufügen

Klicken Sie auf Ziel hinzufügen und geben Sie an:

• Name: Eine frei wählbare Bezeichnung, z. B. Kunde PROD.
• Ziel-Bot-URL: Die vollständige URL des Ziel-Bots, die den Bot-Pfad enthalten muss, z. B. https://customer.botario.cloud/#/bots/6aac56e3cf5484b7eefdc342. Die Bot-ID wird aus dieser URL gelesen. Eine URL ohne /bots/<id> wird abgelehnt.
• API-Schlüssel: Ein Schlüssel, der auf der Ziel-Instanz erstellt wurde und den Zugriff auf diesen Bot autorisiert.

Beim Speichern wird das Ziel sofort geprüft: Es muss erreichbar sein und den API-Schlüssel akzeptieren. Andernfalls wird es nicht gespeichert und der Grund angezeigt.

Ziele testen

Der Server prüft alle Ziele alle 20 Sekunden im Hintergrund und speichert das Ergebnis. Die Liste zeigt sofort den zuletzt bekannten Stand, Änderungen werden live an die geöffnete Seite übertragen:

• Status:
  • Erreichbar: Die Instanz ist erreichbar und der API-Schlüssel kann auf den Bot zugreifen.
  • Kein Zugriff: Die Instanz ist erreichbar, aber der API-Schlüssel kann nicht auf den Bot zugreifen (falscher Scope/falsche Rolle oder der Schlüssel ist auf einen anderen Bot beschränkt).
  • Nicht erreichbar : Die Instanz selbst hat nicht geantwortet.
• Version:
  • die App-Version des Ziels (aus /api/health/version), die für die unten stehende Prüfung auf exakte Übereinstimmung verwendet wird, und
  • die verteilte Version: Der Kommentar der zuletzt von hier an dieses Ziel verteilten Version (oder der Zeitpunkt der Verteilung, wenn die Version keinen Kommentar hat), oder Nicht verteilt. Mit Versionskommentaren wie Release Oktober sehen Sie auf einen Blick, welche Version ein Ziel hat.

Eine Version verteilen

Wählen Sie die zu verteilende gespeicherte Version (mit Datum und Kommentar, neueste zuerst) und verwenden Sie dann An alle verteilen, Ausgewählte verteilen oder die Verteilungsaktion pro Zeile. Eine Bestätigung listet jedes Ziel mit seinem Ergebnis auf:

• Bereit → Wird verteilt → Verteilt oder Fehlgeschlagen mit einem Grund (z. B. Zugriff verweigert, Versionskonflikt, Nicht erreichbar).

Beim Verteilen wird der Inhalt des Ziel-Bots überschrieben – mit der verteilten Version, genauso wie bei einer Wiederherstellung oder einem Klonvorgang. Nach einem erfolgreichen Verteilen erstellt das Ziel automatisch die Embeddings für die importierten Dokumente der Wissensdatenbank, sie müssen also nicht manuell angestoßen werden.

Vor dem Import sichert das Ziel seinen aktuellen Stand. Schlägt der Import auf dem Ziel fehl, wird dieses Backup automatisch wiederhergestellt und das Ziel kehrt zu seinem Stand vor dem Verteilen zurück. Das Backup wird anschließend entfernt und erscheint nicht in der Versionsliste des Ziels. Schlägt auch das Wiederherstellen fehl, bleibt das Backup als Version Backup before failed import in der Versionsliste des Ziels erhalten und kann von dort wiederhergestellt werden.

Aktivieren Sie Ohne Wissensdatenbank-Inhalte verteilen, um die eigene Wissensdatenbank jedes Ziels unangetastet zu lassen – nur Skripte, Flows, Einstellungen und der Rest werden überschrieben, während das Ziel seine vorhandenen Dokumente behält.

Exakte Versionsübereinstimmung

Ein Ziel kommt nur für die Verteilung infrage, wenn seine App-Version exakt mit der App-Version dieser Instanz übereinstimmt. Ziele mit einer anderen Version werden als Versionskonflikt angezeigt und übersprungen. Ein auf einer Plattformversion exportiertes Bundle darf nicht in einen Bot importiert werden, der eine andere Version ausführt.

Berechtigungen des Ziel-API-Schlüssels

Der für jedes Ziel gespeicherte API-Schlüssel (erstellt auf der Ziel-Instanz) muss Folgendes haben:

• die Rolle Backup Manager (version-manager) und
• Lese-Scope (zum Prüfen des Ziels) und Schreib-Scope (zum Empfangen der verteilten Version).

Es wird empfohlen, den Schlüssel auf den einzelnen Ziel-Bot zu beschränken, ist aber nicht erforderlich. Unter API-Schlüssel erfahren Sie, wie Sie einen erstellen.

Hinweise

• Verbundene Ziele sind nicht Teil des Versions-Exports des Bots – beim Exportieren oder Verteilen einer Version wird die Ziel-Liste eines Bots niemals an einen anderen Bot übertragen.
• Alle Aktionen hier erfordern die Rolle Version Manager auf dieser Instanz.