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_knowledge


agorum_ai_agents_library_basic_knowledge_write_document

Anzeigename: Writes the given content into a knowledge document.

Was macht das Tool?

Dieses Tool schreibt den angegebenen Inhalt in ein bestehendes agorum core Dokument.
Es stehen verschiedene Schreiboptionen zur Verfügung:

Das Zielobjekt (Dokument) muss bereits existieren. Existiert es nicht, wird eine Fehlermeldung zurückgegeben.  Alle Operationen werden sequenziell ausgeführt, wobei das System automatisch die Zeilenoffsets bei mehreren Änderungen berücksichtigt.

Empfohlener Einsatzzweck

Das Tool eignet sich zum automatisierten Aktualisieren, Ergänzen oder Überschreiben von Inhalten in bestehenden Wissensdokumenten innerhalb von agorum core.

Funktionsbeschreibung

Parameter Beschreibung
id
(Pflicht)
Die ID (Pfad, numerische ID oder UUID) des agorum core Objekts, in das geschrieben werden soll.
operations
(Pflicht)
Ein Array von Operationen, die sequenziell ausgeführt werden. Mindestens eine Operation muss angegeben werden.

Jede Operation ist ein Objekt mit folgenden Eigenschaften:

operation (Pflicht): Der Typ der Operation. Mögliche Werte:
  • update: Ersetzt den gesamten Dokumentinhalt durch den angegebenen Inhalt
  • append: Fügt Inhalt am Ende des Dokuments hinzu
  • prepend: Fügt Inhalt am Anfang des Dokuments hinzu
  • insertAt: Fügt Inhalt an einer spezifischen Zeilenposition ein
  • deleteLines: Löscht einen Zeilenbereich

content (Optional): Der einzufügende Inhalt (erforderlich für update, append, prepend, insertAt).

Hinweis: Zeilenumbrüche (\n) müssen vom Aufrufer selbst eingefügt werden, das System fügt diese nicht automatisch hinzu.


line (Optional): Die Zeilennummer für insertAt-Operationen (ab 1, bezieht sich auf das Originaldokument) (erforderlich für insertAt).
Minimum: 1
Der Inhalt wird VOR der angegebenen Zeile eingefügt.

startLine (Optional): Startzeilennummer für deleteLines-Operationen (ab 1, inklusive, bezieht sich auf das Originaldokument) (erforderlich für deleteLines).
Minimum: 1

endLine (Optional): Endzeilennummer für deleteLines-Operationen (ab 1, inklusive, bezieht sich auf das Originaldokument) (erforderlich für deleteLines).
Minimum: 1

 

Das Tool gibt den neuen Inhalt zurück, damit Sie überprüfen können, ob die Änderungen korrekt sind.

Tipps und Tricks

Tipps:

  • Achten Sie darauf, dass das Zielobjekt bereits existiert. Das Tool kann keine neuen Dokumente anlegen, sondern nur in bestehende schreiben.
  • Das 'update'-Verfahren löscht automatisch alle bisherigen Inhalte.
  • Alle Zeilennummern in den Operationen beziehen sich immer auf das ursprüngliche Dokument.
  • Um eine bestimmte Zeile zu ersetzen, verwenden Sie 'deleteLines' für diese Zeile und anschließend 'insertAt'.