Recetas — briefings y logs

Un briefing es un link que le das a un agente externo (ChatGPT, Claude, Gemini, n8n…) con un recorte de tu memoria + instrucciones. El agente lo lee, hace la tarea y puede dejar un log de ejecución. Por API podés crear briefings, leer sus logs y dejar logs vos mismo.

Crear un briefing

curl -X POST https://fiacopilot.com/api/v1/briefings \
  -H "Authorization: Bearer fia_sk_…" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Analizá mis últimas reuniones",
    "instructions": "Resumí patrones de los leads que compraron vs los que no.",
    "include_profile": true
  }'

Respuesta 201:

{ "data": { "id": "…", "token": "…", "url": "https://fiacopilot.com/u/tu-handle/b/token" } }

Ese url es el link que le pasás al agente. Campos opcionales del body: included_outputs (uuid[]), included_business_context (uuid[]), include_profile, include_diagnostico, expires_at, max_views, password, public_on_profile.

Necesita scope briefings:write.

Listar tus briefings

curl https://fiacopilot.com/api/v1/briefings \
  -H "Authorization: Bearer fia_sk_…"

Ver un briefing y editarlo

# Ver
curl https://fiacopilot.com/api/v1/briefings/{id} -H "Authorization: Bearer fia_sk_…"

# Revocar (deja de funcionar el link público)
curl -X PATCH https://fiacopilot.com/api/v1/briefings/{id} \
  -H "Authorization: Bearer fia_sk_…" -H "Content-Type: application/json" \
  -d '{"status":"revoked"}'

PATCH acepta: status (active|revoked), instructions, expires_at, max_views, public_on_profile.

Leer los logs que dejaron los agentes

curl https://fiacopilot.com/api/v1/briefings/{id}/executions \
  -H "Authorization: Bearer fia_sk_…"

{ "data": [ { "id": "…", "agent_name": "Claude", "summary": "Analicé 5 reuniones…",
  "output_text": "…", "created_at": "…" } ],
  "page": { "limit": 1, "offset": 0, "total": 1 } }

Dejar un log de ejecución

Útil cuando tu propio código/agente quiere registrar lo que hizo (con autenticación por key):

curl -X POST https://fiacopilot.com/api/v1/briefings/{id}/executions \
  -H "Authorization: Bearer fia_sk_…" -H "Content-Type: application/json" \
  -d '{"summary":"Tarea completada","agent":"mi-script","output":"Resultado completo…"}'

Nota: los agentes que acceden al link público del briefing usan otro endpoint sin key (/api/briefings/public/{token}/log). Este endpoint con {id} es la versión autenticada, para cuando operás con tu API key.