1Die drei Mechanismen

Ein Workflow-Schritt kann Vor- und Nachverarbeitung nutzen, um externe Systeme einzubinden. (AH 9)

HTTP-Service

ein vordefinierter REST-Aufruf (z. B. CRM- oder Preis-API).

Funktion

ein JavaScript-Skript (ScriptEngine) mit Modulen für HTTP, SQL, Mail, MS Graph, Wissensdatenbank …

MCP-Server

eine angebundene externe Tool-Sammlung; AuxData ist MCP-Client.

Alle drei werden auf Organisationsebene gepflegt (Org-Admin oder höher) und stehen damit den Agenten der Organisation als Bausteine zur Verfügung. Die konkrete Nutzung passiert im Workflow-Schritt oder über aktivierten Tool-Use. (AH 9.6)

2Der vierte Weg: Webhooks

Seit v2.4.1 führt ein vierter Weg nach außen — genauer: von außen herein. Inbound-Webhooks lassen ein externes System (Paperless-ngx, GitHub, ein Monitoring-Werkzeug) eine AuxData-Funktion auslösen, indem es einen HTTP-POST schickt.

Die Verwaltung liegt unter Einstellungen → Webhooks und ist Organisations-Administratoren vorbehalten. Ein Webhook besteht aus fünf Angaben:

Name

Beschreibt den Zweck, etwa „Paperless Dokument-Ingestion“.

Function

Die JavaScript-Funktion der Organisation, die beim Aufruf läuft. Sie bekommt automatisch body, headers, query und method.

Ausführungs-User

In wessen Kontext die Funktion läuft. Dieser Benutzer braucht alle Rechte, die das Skript anfasst — etwa Zugriff auf die Ziel-Wissensdatenbank.

Modus

Asynchron (empfohlen) antwortet sofort mit HTTP 200 und arbeitet im Hintergrund. Synchron wartet auf das Ergebnis und gibt es als Antwort-Body zurück.

Aktiv

Erst einschalten, dann die URL weitergeben.

Damit kehrt sich die Richtung um: HTTP-Service, Funktion und MCP rufen von AuxData aus nach draußen, der Webhook lässt draußen bei AuxData anklopfen. Für wiederkehrende Abholvorgänge ist ein Intervallplan meist die einfachere Wahl; der Webhook lohnt sich, wenn das externe System den Zeitpunkt bestimmt.

1Reiter „Anfrage"

URL, Methode, Header und ein Request-Body mit Platzhaltern ${parameter}. (AH 9.1)

2Umgebungsvariablen & Test

Secrets (API-Keys, Tokens) liegen im separaten Schlüssel-Wert-Speicher und werden in HTTP-/MCP-Templates über ${env.NAME} eingesetzt. Die Vertraulich-Markierung maskiert solche Werte nur in der Tabelle — gespeichert werden sie im Klartext (in der Datenbank; über die REST-API und die Browser-DevTools für Aufrufende einsehbar). Für hochkritische Geheimnisse gehört daher ein separater Secret-Manager davor. Die Testseite führt einen Probe-Aufruf aus und zeigt Request, Response und Status. (AH 9.1; Programmierhandbuch · Vertrauliche Werte)

1JavaScript in der Sandbox

Funktionen sind JavaScript (ECMAScript 5.1) und laufen über Otto in einer Sandbox — ohne Datei- oder Netzwerkzugriff außerhalb der eingebauten Module. (AH 9.2; Programmierhandbuch)

function preisAbfrage(produkt) {
    getModule("http");
    getModule("log");

    if (!produkt) {
        log_error("Produkt fehlt");
        return "FEHLER: Produkt fehlt";
    }

    try {
        var header = new Object();
        header["Authorization"] = "Bearer " + api_token; // Umgebungsvariable
        var url = "https://api.example.com/preis?produkt=" + http_queryEscape(produkt);
        log_info("Preisabfrage gestartet");
        return http_get(url, header);
    } catch (error) {
        log_error("Preisabfrage fehlgeschlagen: " + error);
        return "FEHLER: Preisabfrage fehlgeschlagen";
    }
}

2Eingebaute Module

http

http_get, http_post, http_put, http_delete, http_queryEscape.

graphapi

MS Graph: Ressourcen abrufen, E-Mails senden, neue E-Mails holen, verschieben, löschen.

aiservice

andere AI-Services synchron/asynchron aufrufen, z. B. aiservice_run.

knowledgedb

Text/Binary speichern und per find / findByKeyword suchen.

sql

sql_execute, sql_query — direkter Datenbankzugriff nur für Admins.

log

log_info, log_warn, log_error, log_debug.

1Die Funktion als Vorverarbeitung

Sie holt neue E-Mails über MS Graph und lässt sie von einem AI-Service einstufen. Das Beispiel ist ein verdichtetes Muster: Graph-Konfiguration, IDs, Rechte und Ordnernamen müssen gegen deine Instanz und das Programmierhandbuch geprüft werden. (AH Anhang E S3; PH graphapi/aiservice)

function emailCategorization(agentId, categorizationServiceId, maxEmails) {
    getModule("graphapi");
    getModule("aiservice");
    getModule("log");

    if (!agentId || !categorizationServiceId) {
        log_error("agentId oder serviceId fehlt");
        return "FEHLER: Konfiguration unvollständig";
    }

    var graphConfig = new Object(); // aus Funktions-/Org-Umgebungsvariablen befüllen
    var mails = graphapi_getNewFromInbox(graphConfig, maxEmails || 10);
    var verarbeitet = 0;

    for (var i = 0; i < mails.length; i++) {
        var params = new Object();
        params["subject"] = mails[i].Subject || mails[i].subject;
        params["content"] = mails[i].Body || mails[i].body;

        var result = aiservice_run(agentId, categorizationServiceId, params);
        if (result && result.MultiResults && result.MultiResults.Results.length > 0) {
            log_info("Kategorie: " + result.MultiResults.Results[0].Result);
            verarbeitet++;
        }
    }

    return "Verarbeitete E-Mails: " + verarbeitet;
}

1AuxData als MCP-Client

MCP (Model Context Protocol) gibt LLMs Zugriff auf standardisierte Tools, Prompts und Resources. AuxData ist MCP-Client. (AH 9.3)

2Nutzung

Ein konfigurierter MCP-Server ist im Workflow-Schritt unter Vor-/Nachverarbeitung als Tool wählbar. Alternativ nutzen Tool-Use-fähige Modelle die Tools autonom, wenn der Admin das aktiviert. Die „CRM MCP" ist hier bewusst Demo, nicht Quelle für einen echten Endpunkt. (AH 9.3)

1Der automatisierte Ablauf

2Kategorien & Ordner

Ein Kategorisierungs-Service ordnet jede E-Mail einer Kategorie zu (Dringend, Wichtig, Projekt, HR, IT, Vertrieb, Finanzen, Allgemein) und bestimmt die Priorität. Eine Zuordnung steuert das Verschieben: (AH Anhang E S4–5)

var folderMapping = {
    "Dringend":  "Inbox/Dringend",
    "Wichtig":   "Inbox/Wichtig",
    "IT":        "Inbox/IT-Support",
    "Allgemein": "Inbox/Allgemein"
};
// Als Intervall-Service alle checkInterval Sekunden ausführen

Wichtige Treffer melden wir zusätzlich in einen Teams-Kanal; der Intervall-Service stößt den Ablauf alle checkInterval Sekunden an. Organisations-Intervallpläne zeigen Plan-ID, Anwender, Agent, Service, nächste Ausführung, Intervall und Aktiv-Status. (Admin-HB · Monitoring; AH Anhang E S6–8)

1Sicherheitsgrenzen

URL-Whitelist

HTTP- und MCP-Aufrufe nur an freigegebene Ziele.

MCP nur HTTPS

valides Zertifikat und 15-Sekunden-Timeout pro Tool-Aufruf.

SQL nur Admins

direkter Datenbankzugriff ist eingeschränkt.

Otto-Sandbox

kein Datei-/Netz-IO außerhalb der Module.

2Best Practices