Typisiertes Enrichment

Nutze enrichment_start in MCP oder POST /api/v1/operations/enrichment.start über HTTP für Antworten ohne Sheet. Ein Batch akzeptiert 1–100 unabhängige Elemente, auch viele E-Mail- und Telefonanfragen. Nutze sheets_research für eine gespeicherte Liste und sheets_enrich für Zellen in einem vorhandenen Sheet.

Ein Enrichment-Element enthält vier Pflichtfelder: eine stabile id, bekannte Fakten in input, eine question und das gewünschte output. Eingabewerte können Strings, Zahlen, Booleans oder null sein. Quellenmaterial gehört in input, Anweisungen gehören in question.

{  "idempotencyKey": "careers-pilot-001",  "items": [    {      "id": "company-1",      "input": {        "companyName": "Workbase",        "website": "https://www.workbase.com"      },      "question": "Finde die offizielle Karriereseite dieser Firma. Gib keine Antwort zurück, wenn sie nicht verifiziert werden kann.",      "output": { "type": "url" }    }  ]}

Sende diesen Body an POST /api/v1/operations/enrichment.start. Speichere die zurückgegebene batchId und nutze anschließend den Ergebnis-Endpunkt. Dieses Beispiel führt echte, möglicherweise kostenpflichtige Recherche aus; ein Treffer ist nicht garantiert.

Ergebnistyp auswählen

Text unterstützt enum und maxLength. Number unterstützt integer, minimum und maximum. Beispiele: {"type":"text","enum":["Germany","Austria","Switzerland"]} oder {"type":"number","integer":true,"minimum":0}. Die vollständigen Bedingungen stehen im aktuellen Schema. Fordere über diesen Einstieg kein beliebiges JSON an: Es ist kein erlaubter Enrichment-Ergebnistyp.

Eine unbekannte Antwort bleibt leer, statt durch einen geratenen Wert ersetzt zu werden. Eine formal gültige Antwort kann trotzdem die falsche Person oder veraltete Belege betreffen. Prüfe Quellen und Bedeutung, nicht nur den Datentyp. Siehe Ergebnisse und Belege.

Typisierte Listen

Nutze list, wenn die Antwort mehrere Einträge enthält, etwa Stellenanzeigen, Beiträge oder Firmen. Definiere 1–20 Felder mit den oben beschriebenen einfachen Typen. Feldnamen müssen eindeutig sein und mit einem Buchstaben anfangen. Erlaubt sind nur Buchstaben, Zahlen und Unterstriche. Jede Zeile enthält genau diese Felder. maxItems begrenzt die Antwort auf 1–100 Zeilen (Standard 20); die Liste wird nicht mit geratenen Einträgen aufgefüllt.

{  "type": "list",  "fields": [    { "name": "company", "output": { "type": "text" } },    { "name": "careersUrl", "output": { "type": "url" } }  ],  "maxItems": 10}

Setze dieses Objekt in das output eines Elements. Eine leere Liste bedeutet, dass keine verifizierten Treffer gefunden wurden. Unbekannte Feldwerte bleiben leer. Der bestehende Laufzeitvertrag prüft jedes Feld; Activity zeigt die Zeilen als Tabelle und die Quellen getrennt von der Antwort an.

Katalogvorlagen und weitere Recherche

Katalogbeispiele füllen dasselbe Enrichment-Formular mit einer Frage und einem Ergebnistyp vor. Du kannst beides vor dem Start anpassen. Für HTTP-Integrationen schlägt ein optionales toolId am Element ein verfügbares Tool aus tools.list vor; der Agent ermittelt dessen typisierte Eingaben intern. Bei leeren oder unpassenden Tool-Ergebnissen kann er innerhalb desselben Auftrags im Web recherchieren und offizielle Quellen prüfen. Daraus wird nicht sofort ein bestätigtes „kein Ergebnis“. Weder diese Recherche noch ein gültiges Schema garantieren sachlich korrekte Antworten.

Tool-Nutzung und Modellrecherche können beide Kosten verursachen. Sie nutzen denselben bestehenden Auftrag, dieselbe Wiederholungskennung und denselben Activity-Eintrag. Direkte Katalogoperationen bleiben über HTTP verfügbar, wenn du die genauen Parameter kennst. Sie sind keine öffentlichen MCP-Tools; MCP-Clients können toolId weglassen und Leadbase die Quellen für die Frage wählen lassen. Siehe das Bulk-Beispiel für E-Mail und Telefon.