Ihre Bewerbung fragt.
afka erledigt die Arbeit.
Erstellen Sie Aufgaben, rufen Sie Ergebnisse ab und empfangen Sie signierte Ereignisse. Die gleichen Berechtigungen und Genehmigungsgates gelten, unabhängig davon, ob eine Person oder Ihr Code die Arbeit startet.
Von der Anfrage zum Ergebnis.
Verwenden Sie die Task-API, um ein klares Ergebnis zu übergeben. Verfolgen Sie die Aufgabe, rufen Sie ihre Artefakte ab und bringen Sie das Ergebnis zurück in Ihre eigene Anwendung.
POST https://api.afka.ai/v1/tasks
{ "prompt": "Prepare an evidence-backed candidate shortlist" }
202 Accepted
{ "task_id": "task_5f2c", "status": "queued" }
GET https://api.afka.ai/v1/tasks/task_5f2c
{ "status": "done", "credits_spent": 412,
"artifacts": ["art_9d1e"] }Eine kleine Oberfläche.
Eine vollständige Arbeitschleife.
| Anfrage | Was es tut | Ergebnis |
|---|---|---|
| POST /v1/tasks | Reichen Sie ein Ergebnis ein, damit afka daran arbeitet. | Aufgabe in Warteschlange und Aufgaben-ID |
| GET /v1/tasks/:id | Lesen Sie den Run und seinen aktuellen Status. | Status, Credits ausgegeben und Artefakte |
| Aufgabe abgeschlossen | Erhalten Sie ein Abschluss-Event an Ihrem Webhook. | Aufgaben- und Arbeitsbereich-Referenzen |
Ein Schlüssel ist niemals eine Abkürzung um die Kontrolle.
Erbt Berechtigungen
Ein Schlüssel hat niemals mehr Zugriff als die Person, die ihn erstellt hat.
Sicherheitsübersicht lesen ↗GenehmigungDas gleiche menschliche Gate
Sensible Aktionen warten weiterhin auf die autorisierte Person.
Genehmigungen erkunden ↗AufzeichnungVerfolgen Sie das Ergebnis
Folgen Sie der Aufgabe und den Aktionen hinter dem gelieferten Artefakt.
Plattform erkunden ↗Signierte Ereignisse. Sichere Wiederholungen.
POST https://your-app.example/afka/hooks x-afka-event: task.finished x-afka-delivery: d_8f3a1c9e x-afka-signature: sha256=<hex digest> expected = hmac_sha256(signing_secret, raw_body).hexdigest()
Überprüfen Sie die Signatur anhand der rohen Request-Bytes, bevor Sie den Body analysieren. Verwenden Sie die stabile Delivery-ID zur Deduplizierung von Wiederholungen. Halten Sie Signing Secrets auf dem Server.
Bauen Sie auf einer kontrollierten Arbeitschleife auf.
Beginnen Sie mit einer Aufgabe. Erweitern Sie, wenn das Ergebnis und der Genehmigungspfad für Ihr Team richtig sind.