Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > ALBERT | AI > ALBERT | AI Agents > ALBERT| AI KI-Tools-Dokumentationen


agorum_ai_agents_library_basic_get_restore_history

Anzeigename: History - Get - Restore

Was macht das Tool?

Dieses Tool ermöglicht den Zugriff auf die Versionshistorie eines agorum core Objekts und erlaubt das gezielte Wiederherstellen bestimmter Versionen. Das Tool ermöglicht es, einzelne Versionsstände abzufragen, die Anzahl der Versionen zu ermitteln und gezielt bestimmte Versionen für das Objekt wiederherzustellen.

Empfohlener Einsatzzweck

Das Tool ist ideal, wenn Sie frühere Versionen eines Dokuments, Ordners oder anderen agorum core Objekts einsehen oder gezielt wiederherstellen möchten. Es eignet sich besonders für die Wiederherstellung nach versehentlichen Änderungen oder zur Nachverfolgung von Änderungen zu Audit- und Kontrollzwecken.

Funktionsbeschreibung

Parameter Beschreibung
id
(Pflicht)
Die ID (Pfad, ID oder UUID) des agorum core Objekts, dessen Historie abgerufen oder wiederhergestellt werden soll.
action
(Pflicht)
Die gewünschte Aktion. Mögliche Werte:
  • getFirstHistory: Holt die älteste Historienversion
  • getLastHistory: Holt die neueste Historienversion
  • getHistory: Holt eine bestimmte Historienversion (benötigt num)
  • getHistoryCount: Gibt die Anzahl der Historieneinträge zurück
  • restoreLastHistory: Stellt die neueste Historienversion wieder her
  • restoreFirstHistory: Stellt die älteste Historienversion wieder her
  • restoreNumHistory: Stellt eine bestimmte Historienversion wieder her (benötigt num)
  • isHistoryObject: Prüft, ob das Objekt eine Historienversion ist
  • restoreHistory: Allgemeine Wiederherstellung einer Historienversion
num
(Optional, aber erforderlich für getHistory und restoreNumHistory)
Die Position der Historienversion, die abgerufen oder wiederhergestellt werden soll. Positive Werte: 1 (älteste) bis n (neueste), negative Werte: -1 (neueste) bis -n (älteste).

Beispiel-Prompt

Ich möchte die zweitälteste Version des Dokuments mit der UUID d5b7cf90-8969-11f0-a52d-02420a0a000e wiederherstellen:

Nutze das Tool "agorum_ai_agents_library_basic_get_restore_history" mit:
    id: d5b7cf90-8969-11f0-a52d-02420a0a000e
    action: restoreNumHistory
    num: 2

Tipps und Tricks

Tipps:

  • Die gezielte Wiederherstellung einzelner Versionen ist besonders hilfreich, wenn versehentlich Änderungen vorgenommen wurden oder eine frühere Version aus Revisionsgründen benötigt wird. Beachten Sie, dass für einige Aktionen (z. B. Wiederherstellung) entsprechende Berechtigungen erforderlich sind.
  • Nutzen Sie getHistoryCount, um vorab zu prüfen, wie viele Versionen vorliegen.