Recetas — memoria y procesos

Tu memoria es la bóveda de outputs que vas guardando en FIA Copilot. Los procesos son un tipo de memoria (content_type=context_process). Por API podés leerlos y crear nuevos.

Traer tus procesos

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

Equivale a GET /memory?type=context_process.

Buscar en tu memoria

curl "https://fiacopilot.com/api/v1/memory?q=ventas&limit=5" \
  -H "Authorization: Bearer fia_sk_…"

Solo los destacados

curl "https://fiacopilot.com/api/v1/memory?starred=true" \
  -H "Authorization: Bearer fia_sk_…"

Paginar

La respuesta trae page: { limit, offset, total }. Para la página siguiente, subí el offset:

curl "https://fiacopilot.com/api/v1/memory?limit=50&offset=50" \
  -H "Authorization: Bearer fia_sk_…"

Guardar un proceso nuevo

curl -X POST https://fiacopilot.com/api/v1/memory \
  -H "Authorization: Bearer fia_sk_…" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Onboarding de cliente nuevo",
    "content": "1. Crear carpeta…\n2. Enviar bienvenida…\n3. Agendar kickoff…",
    "content_type": "context_process",
    "tags": ["operaciones", "clientes"]
  }'

Necesita una key con scope memory:write (o sin scopes = acceso total).

Caso típico: un agente que documenta

Un flujo común es que un agente externo (Claude, n8n) lea tu contexto y escriba el resultado de vuelta en tu memoria:

1. GET /memory?type=context_business → el agente entiende tu negocio.
2. El agente hace su tarea (redacta, analiza, etc.).
3. POST /memory con content_type=ai_response → guarda el resultado en tu bóveda.

Así tu memoria crece sola, sin que entres a la app.