skill_get_content

Hinweise:

Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins ALBERT | AI Agents. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.
Wie Sie die KI-Tools in Ihren KI-Voreinstellungen verwenden, erfahren Sie hier: ALBERT | AI agents tools einrichten

Anzeigename: Returns the content of a file inside a Claude skill

Technischer Name: agorum_ai_agents_library_basic_skill_get_content

Was macht das Tool?

Dieses Tool gibt den Inhalt einer Datei innerhalb eines Skill-Ordners als Rohtext zurück. Es funktioniert analog zum allgemeinen get_content-Tool, ist jedoch zwingend auf Dateien innerhalb eines Skill-Ordners begrenzt. Aufrufe außerhalb eines Skills werden mit einem Fehler abgewiesen.

Empfohlener Einsatzzweck

Lesen der SKILL.md-Datei, um die Anweisungen eines Skills zu verstehen und anzuwenden
Lesen zusätzlicher Dateien innerhalb eines Skills (z. B. Vorlagen, Beispielcode, Konfigurationen)
Teilweises Lesen großer Dateien über die Parameter start und length

Funktionsbeschreibung

Parameter	Beschreibung
id (Pflicht)	ID, UUID oder Pfad der Datei innerhalb eines Skill-Ordners. Die Datei muss sich innerhalb eines Skill-Ordners befinden (ein Vorfahren-Ordner muss eine `SKILL.md` enthalten).
start (Optional)	Startposition (0-basierter Zeichenindex), ab der der Inhalt gelesen wird. Standard: 0
length (Optional)	Maximale Anzahl der zurückgegebenen Zeichen. Ermöglicht das teilweise Lesen großer Dateien.
basePathIds (Optional)	Schränkt ein, dass der umschließende Skill-Ordner unterhalb eines der angegebenen Pfade liegen muss. Format: Array von IDs, UUIDs oder Pfaden.

Rückgabeformat

Die Rückgabe erfolgt als Rohtext (nicht JSON-kodiert) mit einem Metadaten-Header:

=== FILE METADATA ===
uuid: <UUID der Datei>
name: <Dateiname>
hash: <MD5-Hash>
size: <Gesamtgröße in Zeichen>
start: <Startposition>
length: <Zurückgegebene Länge>
skillFolderUuid: <UUID des umschließenden Skill-Ordners>
=== FILE CONTENT ===
<Dateiinhalt>
=== END OF FILE ===

Das Feld skillFolderUuid gibt zusätzlich die UUID des umschließenden Skill-Ordners an, was bei der Navigation innerhalb des Skills hilfreich ist.

Sicherheitseinschränkung

Hinweis: Dieses Tool kann nur auf Dateien innerhalb eines Skill-Ordners zugreifen. Wenn die angegebene Datei nicht innerhalb eines Skill-Ordners liegt, gibt das Tool einen Fehler zurück. Ebenso wird ein Fehler zurückgegeben, wenn das Objekt ein Ordner statt einer Datei ist. Diese Einschränkung stellt sicher, dass das Tool nicht für den Zugriff auf beliebige Dateien in agorum core verwendet werden kann.

Tipps und Tricks

Tipps:

Verwenden Sie skill_tree, um die verfügbaren Dateien innerhalb eines Skills zu ermitteln, bevor Sie deren Inhalt lesen.
Für große Dateien können Sie start und length verwenden, um nur einen Ausschnitt zu lesen und so Token zu sparen.
Der hash-Wert in der Rückgabe kann verwendet werden, um Änderungen an der Datei zu erkennen.