Ваша кандидатура просит.
afka делает работу до конца.
Создавайте задачи, получайте результаты и получайте подписанные события. Одни и те же разрешения и gates применяются независимо от того, запускает ли работу человек или ваш код.
От запроса к результату.
Используйте API задач, чтобы передать четкий результат. Отслеживайте задачу, получайте её артефакты и возвращайте результат в своё приложение.
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"] }Небольшая поверхность.
Полный цикл работы.
| Запрос | Что она делает | Результат |
|---|---|---|
| POST /v1/tasks | Отправьте результат, над которым будет работать afka. | Задача в очереди и ID задачи |
| GET /v1/tasks/:id | Прочитайте запуск и его текущий статус. | Статус, потраченные кредиты и артефакты |
| задача завершена | Получите событие завершения на вашем вебхуке. | Ссылки на задачу и рабочее пространство |
Ключ никогда не является обходом контроля.
Наследует разрешения
Ключ никогда не имеет больше доступа, чем человек, который его создал.
Читать обзор безопасности ↗ОдобрениеОдин и тот же человек, одобряющий действие
Чувствительные действия по-прежнему ожидают одобрения уполномоченного лица.
Изучить согласования ↗ЗаписьОтследить результат
Следите за задачей и действиями, стоящими за сданной работой.
Изучить платформу ↗Подписанные события. Безопасные повторные попытки.
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()
Проверьте подпись против исходных байтов запроса перед разбором тела. Используйте стабильный ID доставки для дедупликации повторных попыток. Храните секреты подписи на сервере.
Создавайте на основе управляемого цикла работ.
Начните с одной задачи. Расширяйте, когда результат и процесс согласования подходят вашей команде.