Tools
Tools sind ausführbare Aktionen, die Agents während einer Konversation oder eines Workflows aufrufen — ein Ticket erstellen, das Memory abfragen, eine Diagnose auf einem Edge-Gerät ausführen. Sie verwalten sie unter Tools in der Admin-Seitenleiste.
Tool-Katalog
Abschnitt betitelt „Tool-Katalog“Die Seite Tools listet alle Tools Ihrer Organisation auf. Über das Suchfeld filtern Sie die Liste, mit Create Tool legen Sie ein neues Tool an. Ein Klick auf ein Tool öffnet den Editor; jede Entität öffnet sich als schließbarer Tab.
Der Tool-Editor
Abschnitt betitelt „Der Tool-Editor“Der Editor ist eine Node-Graph-Oberfläche im gleichen Stil wie der Agent-Editor. Ein Auswahlfeld für den Veröffentlichungsstatus steuert, wer das Tool verwenden darf:
| Status | Wirkung |
|---|---|
| Draft | Nur Admins können es testen |
| Private | Nur die erstellende Person kann es verwenden |
| Live | Für alle in der Organisation verfügbar |
Definition
Abschnitt betitelt „Definition“Die Definition beschreibt dem Agent, was das Tool tut und wann er es einsetzen soll:
- Title und Description — was das Tool ist.
- Call when — die Situationen, in denen ein Agent es aufrufen soll.
- Prerequisites — Bedingungen, die vor dem Aufruf erfüllt sein müssen.
- Limitations — was das Tool nicht kann.
- Side effects — Änderungen, die der Aufruf außerhalb der Konversation bewirkt.
- Arguments — das Eingabeschema, bearbeitet in einem JSON-Schema-Builder mit visueller und Code-Ansicht.
Formulieren Sie Call when, Prerequisites und Limitations aus Sicht des Agents — das Modell liest diese Felder, wenn es entscheidet, ob und wie es das Tool aufruft.
Verhalten
Abschnitt betitelt „Verhalten“- Narration policy — wie der Agent den Aufruf im Chat kommuniziert: Natural, Brief progress phrase oder Silent.
- Requires approval — wenn aktiviert, muss der Nutzer jeden Aufruf vor der Ausführung freigeben.
- Activity visibility — ob der Aufruf im Chat-Verlauf erscheint: Visible in chat oder Hidden internal activity.
Implementierungstypen
Abschnitt betitelt „Implementierungstypen“Jedes Tool hat eine Implementierung, die bestimmt, wo es ausgeführt wird:
| Implementierung | Ausführung | Hinweise |
|---|---|---|
| Native | In die Plattform integriert | Kein Setup; von nara gepflegt |
| Edge | Auf Ihren Edge-Deployments über den Organization connector | Optionales Exclusive execution beschränkt das Tool auf ein bestimmtes Deployment |
| Agentic | Durch einen Workflow-Agent umgesetzt | Der Tool-Aufruf führt den Agent aus und liefert dessen Ergebnis zurück |
Edge-Implementierungen werden in TypeScript geschrieben und als Tool-Bundles über die Edge Connector CLI ausgeliefert — siehe Custom Tools. Agentic-Implementierungen erlauben es, Tools aus Workflow-Agents zusammenzusetzen, ohne die Plattform zu verlassen.
Test Console
Abschnitt betitelt „Test Console“Der Editor enthält eine Test Console, um das Tool direkt auszuführen:
-
Geben Sie die Aufruf-Argumente als JSON ein, passend zum Arguments-Schema des Tools.
-
Wählen Sie bei Edge-Tools über Select Deployment das ausführende Deployment. Die Konsole warnt, wenn das gewählte Deployment offline ist.
-
Klicken Sie auf Execute Test und prüfen Sie das Ergebnis.
Available Integrations
Abschnitt betitelt „Available Integrations“Das Panel Available Integrations im Editor verweist auf die verbundenen Provider Ihrer Organisation. Manche Tools setzen eine aktive Integration voraus (z. B. einen Ticketing- oder Knowledge-Base-Provider) — verbinden und verwalten Sie diese unter Integrationen.