Tu candidatura pregunta.
afka hace el trabajo.
Crear tareas, recuperar resultados y recibir eventos firmados. Los mismos permisos y puertas de aprobación se aplican tanto si una persona como si tu código inicia el trabajo.
De la solicitud al resultado.
Utiliza la API de tareas para entregar un resultado claro. Realiza un seguimiento de la tarea, recupera sus artefactos y devuelve el resultado a tu propia aplicación.
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"] }Una superficie pequeña.
Un ciclo de trabajo completo.
| Solicitud | Qué hace | Resultado |
|---|---|---|
| POST /v1/tasks | Envía un resultado para que afka trabaje en él. | Tarea en cola e ID de tarea |
| GET /v1/tasks/:id | Lee la ejecución y su estado actual. | Estado, créditos gastados y artefactos |
| tarea.finalizada | Recibe un evento de finalización en tu webhook. | Referencias de tareas y espacios de trabajo |
Una clave nunca es un atajo alrededor del control.
Hereda permisos
Una clave nunca tiene más acceso que la persona que la creó.
Lee descripción general de seguridad ↗AprobaciónLa misma puerta de aprobación humana
Las acciones sensibles siguen esperando la aprobación de la persona autorizada.
Explorar aprobaciones ↗RegistroRastrear el resultado
Sigue la tarea y las acciones detrás del artefacto entregado.
Explora la plataforma ↗Eventos firmados. Reintentos seguros.
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()
Verifica la firma contra los bytes de solicitud sin procesar antes de analizar el cuerpo. Utiliza el ID de entrega estable para deduplicar reintentos. Mantén los secretos de firma en el servidor.
Construir sobre un bucle de trabajo gobernado.
Comienza con una tarea. Expande cuando el resultado y la ruta de aprobación sean adecuados para tu equipo.