Operationen
Eine Operation ist Ihre Logik, aufgerufen über Fóir. Sie hosten einen HTTP-Endpunkt und registrieren seine URL, und Fóir sendet ihm eine signierte Payload, wiederholt bei Fehlern und zeichnet das Ergebnis auf.
Wie eine ausgelöst wird
Eine Operation läuft über eine Schaltfläche in der Konsole, ein Feld im Datensatz-Editor, einen Lifecycle-Hook, einen Zeitplan oder einen Aufruf der öffentlichen API. Jede bekommt eine eigene, aus ihrem Eingabe- und Ausgabeschema erzeugte typisierte GraphQL Mutation: Aus einer Operation mit dem Schlüssel sodass aus einer Operation mit dem Schlüssel ai-summarize wird executeAiSummarize. Preconditions und Nutzungskontingente entscheiden, wer sie ausführen darf und wie oft.
Synchron oder im Hintergrund
Im Sync-Modus wartet der Aufrufer, und Ihr Antwortkörper ist das Ergebnis. Das Timeout beträgt standardmäßig 30 Sekunden und lässt sich auf bis zu fünf Minuten setzen. Im Async-Modus antwortet Ihr Endpunkt mit 202 und meldet später Fortschritt, Abschluss, Fehler oder Abbruch über ein Callback-Token. Er hat standardmäßig 24 Stunden Zeit für den Rückruf, bevor der Lauf als Timeout markiert wird.
Wiederholungen und die Dead-Letter-Queue
Ein fehlgeschlagener Aufruf wird wiederholt, standardmäßig dreimal, und ein Circuit Breaker öffnet nach fünf Fehlern und weist Aufrufe 60 Sekunden lang ab. Ein Lauf in der Warteschlange, der seine Wiederholungen aufbraucht, landet in der Dead-Letter-Queue, wo Sie ihn prüfen, wiederholen oder verwerfen können. Ein Idempotenzschlüssel am Aufruf sorgt dafür, dass eine Wiederholung den Lauf des ersten Versuchs übernimmt, sodass die Arbeit nicht doppelt erledigt wird.
Der Laufdatensatz
Jeder Lauf wird mit Status, Dauer, Ergebnis oder Fehler, Auslöser, Anzahl der Wiederholungen und Fortschritt aufgezeichnet.
Aufrufe von Drittanbieter-APIs
Ein Pass-through-Schreibzugriff hat keinen Dienst von Ihnen dahinter. Fóir ruft die Drittanbieter-API selbst aus einer Anfragevorlage auf, mit Zugangsdaten aus Secrets. Eine Resolver-Operation stellt eine Drittanbieter-API als GraphQL-Abfrage oder als Feld an einem Modell bereit, mit Caching und Batching.
Details nachlesen
Der Operations-Leitfaden behandelt das Registrieren eines Endpunkts, die Payload, die er erhält, beide Modi und den Laufverlauf.