Twoja kandydatura pyta.
afka wykonuje pracę.
Twórz zadania, pobieraj wyniki i otrzymuj podpisane zdarzenia. Te same uprawnienia i bramy zatwierdzenia obowiązują niezależnie od tego, czy pracę rozpoczyna osoba, czy Twój kod.
Od żądania do wyniku.
Użyj interfejsu API zadań, aby przekazać jasny wynik. Śledź zadanie, pobierz jego artefakty i przywróć wynik do własnej aplikacji.
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"] }Mała powierzchnia.
Pełna pętla pracy.
| Żądanie | Co to robi | Wynik |
|---|---|---|
| POST /v1/tasks | Prześlij wynik, aby afka mógł nad nim pracować. | Zadanie w kolejce i identyfikator zadania |
| GET /v1/tasks/:id | Przeczytaj przebieg i jego bieżący status. | Stan, wydane kredyty i artefakty |
| zadanie.ukończone | Otrzymaj zdarzenie ukończenia w swoim webhooku. | Odwołania do zadania i obszaru roboczego |
Klucz nigdy nie jest skrótem omijającym kontrolę.
Dziedziczy uprawnienia
Klucz nigdy nie ma więcej dostępu niż osoba, która go utworzyła.
Przeczytaj przegląd bezpieczeństwa ↗ZatwierdzenieTa sama brama człowieka
Wrażliwe działania nadal czekają na osobę uprawnioną.
Poznaj zatwierdzenia ↗NagranieŚledź wynik
Postępuj zgodnie z zadaniem i działaniami stojącymi za dostarczonym artefaktem.
Odkryj platformę ↗Podpisane zdarzenia. Bezpieczne ponowne próby.
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()
Zweryfikuj podpis względem surowych bajtów żądania przed przeanalizowaniem treści. Użyj stabilnego identyfikatora dostarczenia do deduplikacji ponownych prób. Przechowuj tajne klucze podpisywania na serwerze.
Zbuduj na pętli pracy z zatwierdzeniami.
Zacznij od jednego zadania. Rozwijaj, gdy wynik i ścieżka zatwierdzenia są odpowiednie dla Twojego zespołu.