Custom Tools

So funktioniert es

Sie definieren das Tool einmal als Ressource auf Organisationsebene: die Request-Methode (GET/POST/PUT/PATCH/DELETE), die Endpunkt-URL mit {{param}}-Platzhaltern, die Authentifizierung (API-Key, Bearer-Token oder Basic Auth — Zugangsdaten werden verschlüsselt und nie an das Modell weitergegeben), die Parameter, die die KI liefern soll, ein optionales JSON-Body-Template und ein Response-Mapping, das die Antwort auf das zusammenstreicht, was der Agent braucht.

Jedes Tool ist als Read oder Write typisiert. Read-Tools holen nur Daten; Write-Tools erstellen, aktualisieren oder löschen — und halten, wie die Write-Tools der Konnektoren, im interaktiven Chat vor der Ausführung zur Bestätigung an. Anschließend weisen Sie das Tool den Agenten zu, die es brauchen.

Warum sie wichtig sind

Custom Tools sind das, was einen Agenten auf Ihrem Stack handeln lässt — einem internen CRM, einem Logistikdienstleister, einem Nischen-SaaS — und nicht nur in den Systemen, für die Macha Konnektoren mitliefert. Sie sind der praktische Ausdruck agentischer KI für die Tools, die Ihr Team ohnehin nutzt.

Sie können sie von Hand bauen oder die API Sidekick beschreiben: Sidekick findet die Endpunkte, testet Ihre Zugangsdaten und verdrahtet das Tool für Sie.