Custom Tools

Tools Advanced

Custom Tools erweitern deine Agents um Fähigkeiten, die speziell zu deiner Organisation passen. Du definierst die Schnittstelle des Tools mit Parametern und Result-Schema und hängst danach eine agentische oder eine Edge-Implementierung an.

Aufbau einer Tool-Definition

Feld	Pflicht	Beschreibung
`name`	Ja	Eindeutiger Bezeichner in Tool-Aufrufen
`title`	Ja	Gut lesbarer Anzeigename
`description`	Ja	Erklärt den Zweck des Tools
`group`	Ja	Kategorie des Tools
`parameters`	Ja	Schema für die Eingaben
`resultSchema`	Ja	Schema für die strukturierte Ausgabe
`documentation`	Nein	Hilft dem Agent, das Tool richtig einzuordnen
`visibility`	Nein	Steuert, ob das Tool öffentlich sichtbar oder intern ist

Documentation-Objekt

Das documentation-Objekt gibt dem Agent strukturierte Hinweise zur Nutzung des Tools:

Eigenschaft	Beschreibung
`callWhen`	Wann das Tool aufgerufen werden soll
`preconditions`	Bedingungen vor dem Aufruf
`effects`	Was das Tool bewirkt oder zurückgibt
`limitations`	Einschränkungen, die der Agent berücksichtigen soll

Ein Custom Tool erstellen

Custom Tools werden im Admin-Bereich angelegt und danach mit einer Implementierung verbunden.

Über das Admin-Dashboard

Navigiere zu Tools und wähle Create Tool.
Fülle Name, Title, Description, Gruppe, Parameter und Result-Schema aus.
Ergänze optional die Documentation-Felder.
Speichere das Tool.
Hänge entweder eine Agentic- oder eine Edge-Implementierung an.

Agentic Implementation

Nutze eine agentische Implementierung, wenn ein anderer Workflow-Agent den Tool-Vertrag erfüllen soll. Das passt gut zu Orchestrierung und logiklastigen Abläufen.

Edge Implementation

Nutze eine Edge-Implementierung, wenn das Tool in deiner Infrastruktur ausgeführt werden muss. Der generate-Befehl erzeugt eine Grundstruktur aus der Registry:

edge-connector generate -l typescript -t <tool_name> -o ./custom-implementations

Edge-Bundles

Custom EDGE-Tools werden als Bundles bereitgestellt. Ein Bundle ist ein komprimiertes Archiv mit:

einem Manifest mit Tools, Checksummen und Metadaten
kompilierten Tool-Dateien im dist/tools/-Verzeichnis

Bundles sind versioniert. Beim Upload werden unveränderte Implementierungen wiederverwendet und geänderte Implementierungen erhalten neue Versionen.

Wie Edge-Implementierungen ausgeführt werden

Der Edge Connector erkennt verfügbare Tools während seines Handshakes mit der Plattform. Wenn ein Tool-Aufruf ankommt:

empfängt der Connector den Tool-Namen und die Argumente
lädt die passende Implementierung aus dem zugewiesenen Bundle
führt sie aus
sendet das strukturierte Ergebnis an die Plattform zurück

Upload-Ablauf

Tool definieren. Lege Name, Parameter, Result-Schema und Dokumentation fest.
Im Edge Connector implementieren. Schreibe die eigentliche Ausführungslogik.
Paketieren. Kompiliere und verpacke deine Implementierungen als Bundle.
Bundle hochladen.
Terminal-Fenster
```
edge-connector upload
```

Bundle einem Deployment zuweisen.

edge-connector bundle assign <bundleId> --deployment <deploymentId>

Nächste Schritte

Edge Connector Übersicht Erfahre, wie der Edge Connector Tools nah an deiner Infrastruktur ausführt.

Tool-Verwaltung Tools, Integrationen und Sichtbarkeit im Admin-Bereich verwalten.