Bulk-Enrichment und Ergebnisabruf
Starte bis zu 100 unabhängige Elemente und rufe ihre Aufträge mit stabilen Wiederholungsschlüsseln ab.
enrichment.start akzeptiert 1–100 Elemente pro Anfrage. Jedes Element braucht eine eigene ID, Eingabe, Frage und Ausgabe. Ein Batch darf unterschiedliche Fragen und Ergebnistypen enthalten. Der Batch wird atomar angenommen und liefert batchId sowie Auftragsdatensätze; die Annahme bedeutet nicht, dass jedes Element eine Antwort findet.
Nutze das Beispiel mit einem Element als Ausgangspunkt und ergänze Elemente mit verschiedenen IDs. Liegen deine Daten als CSV vor, parse die Datei in deiner Anwendung oder deinem KI-Client und überführe jeden Datensatz in ein Element. Behalte die ursprüngliche Datensatz-ID, um Antworten später zuzuordnen. Ein Import in die App ist nicht nötig.
Denselben Batch abrufen
Ersetze den Platzhalter durch die zurückgegebene UUID. Frage mit angemessenem Abstand und zunehmenden Pausen ab, solange Aufträge warten oder laufen. Prüfe jeden Auftrag einzeln und verfolge den Abrechnungsstatus weiter, solange er nicht abgeglichen ist. Vermeide sehr häufiges Polling, das ebenfalls dein Request-Kontingent nutzt.
Wiederholen, ohne einen neuen Auftrag anzulegen
Speichere vor dem Versand den vollständigen Start-Body und idempotencyKey. Geht die Antwort verloren, sende denselben Body mit demselben Schlüssel erneut. Erzeuge für die Wiederaufnahme keinen neuen Schlüssel. Ein neuer Schlüssel gehört nur zu einer bewusst neuen Anfrage, auch bei geänderter Frage oder Eingabe.
Teile mehr als 100 Elemente in Batches mit höchstens 100 auf und beachte die JSON-Body-Grenze. Erhöhe die Menge schrittweise anhand beobachteter Geschwindigkeit und Kosten. Batchgröße, Anfragerate und gleichzeitige Ausführung sind unterschiedliche Grenzen; 100 eingereichte Elemente müssen nicht gleichzeitig starten.
Siehe Activity für die Ergebnisinterpretation und Credits für die Abrechnung.