Sua candidatura pede.
afka faz o trabalho.
Criar tarefas, recuperar resultados e receber eventos assinados. As mesmas permissões e gates de aprovação se aplicam independentemente de uma pessoa ou seu código iniciar o trabalho.
Do pedido ao resultado.
Use a API de tarefas para entregar um resultado claro. Acompanhe a tarefa, recupere seus artefatos e traga o resultado de volta para sua própria aplicação.
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"] }Uma pequena superfície.
Um ciclo de trabalho completo.
| Solicitação | O que faz | Resultado |
|---|---|---|
| POST /v1/tasks | Envie um resultado para afka trabalhar. | Tarefa enfileirada e ID da tarefa |
| GET /v1/tasks/:id | Leia a execução e seu status atual. | Status, créditos gastos e artefatos |
| tarefa.concluída | Receba um evento de conclusão no seu webhook. | Referências de tarefa e espaço de trabalho |
Uma chave nunca é um atalho para contornar o controle.
Herda permissões
Uma chave nunca tem mais acesso do que a pessoa que a criou.
Ler visão geral de segurança ↗AprovaçãoO mesmo portão humano
Ações sensíveis ainda aguardam a pessoa autorizada.
Explore as aprovações ↗RegistroRastrear o resultado
Siga a tarefa e as ações por trás do artefato entregue.
Explore a plataforma ↗Eventos assinados. Retentativas seguras.
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()
Verifique a assinatura contra os bytes brutos da solicitação antes de analisar o corpo. Use o ID de entrega estável para desduplicar tentativas. Mantenha os segredos de assinatura no servidor.
Construir em um loop de trabalho governado.
Comece com uma tarefa. Expanda quando o resultado e o caminho de aprovação forem adequados para sua equipe.