Contexto

El endpoint más importante para los agentes IA. Devuelve las memorias más relevantes para una tarea específica, listas para insertar en el prompt.

Construir contexto

POST/api/v1/context/build

bash

curl -s -X POST "$SOLUCORTEX_URL/api/v1/context/build" \
  -H "Authorization: Bearer $SOLUCORTEX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "project_id": "'"$SOLUCORTEX_PROJECT_ID"'",
    "query": "implementar autenticación con API keys rotables"
  }'

Parámetros

Campo	Tipo	Requerido	Descripción
`project_id`	UUID	✅	UUID del proyecto
`query`	string	✅	Descripción de la tarea o pregunta. Mientras más específico, mejor el resultado.
`limit`	int	—	Máximo de memorias a devolver. Default: 15

Respuesta

json

{
  "query": "implementar autenticación con API keys rotables",
  "project": { "id": "...", "name": "Mi Proyecto" },
  "memories": [
    {
      "id": "uuid",
      "type": "decision",
      "title": "API keys con prefijo scx_ y hash SHA-256",
      "content": "Las API keys se almacenan como hash para evitar exposición...",
      "importance": 9,
      "summary": "Resumen generado automáticamente por OpenAI",
      "score": 0.94
    }
  ],
  "context_text": "--- MEMORIA 1 (importancia: 9) ---\nAPI keys con prefijo scx_..."
}

Usa context_text directamente en el system prompt del agente.

Cómo usarlo en un agente

Claude Code / Claude API

bash

#!/bin/bash
source ai/.env.ai

# 1. Cargar contexto
CONTEXT=$(curl -s -X POST "$SOLUCORTEX_URL/api/v1/context/build" \
  -H "Authorization: Bearer $SOLUCORTEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"project_id\": \"$SOLUCORTEX_PROJECT_ID\",
    \"query\": \"$1\"
  }" | jq -r '.context_text')

# 2. Usar el contexto
echo "Contexto cargado:"
echo "$CONTEXT"

Script de bootstrap incluido

bash

source ai/.env.ai
bash ai/runtime/bootstrap/load-context.sh "describe tu tarea aquí"

Snapshots

Los snapshots son fotos inmutables del contexto. Útiles para auditoría o para comparar el estado del conocimiento en distintos momentos.

POST/api/v1/snapshots

GET/api/v1/snapshots/{id}

bash

# Crear snapshot del estado actual
curl -s -X POST "$SOLUCORTEX_URL/api/v1/snapshots" \
  -H "Authorization: Bearer $SOLUCORTEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "'"$SOLUCORTEX_PROJECT_ID"'",
    "label": "Pre-deploy v1.2.0"
  }'