Búsqueda semántica

Busca memorias por significado, no por palabras exactas. Usa embeddings de OpenAI para encontrar conocimiento relevante aunque uses términos distintos.

Búsqueda semántica

POST/api/v1/search/semantic

bash

curl -s -X POST "$SOLUCORTEX_URL/api/v1/search/semantic" \
  -H "Authorization: Bearer $SOLUCORTEX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "project_id": "'"$SOLUCORTEX_PROJECT_ID"'",
    "query": "¿cómo está implementada la autenticación?",
    "limit": 10
  }'

Parámetros

Campo	Tipo	Requerido	Descripción
`project_id`	UUID	✅	UUID del proyecto
`query`	string	✅	Pregunta o descripción en lenguaje natural
`limit`	int	—	Número de resultados. Default: 10, máx: 50
`type`	string	—	Filtrar por tipo de memoria
`threshold`	float	—	Similaridad mínima 0–1. Default: 0.5

Respuesta

json

{
  "query": "¿cómo está implementada la autenticación?",
  "results": [
    {
      "id": "019e...",
      "type": "decision",
      "title": "API keys con hash SHA-256",
      "content": "Las keys se almacenan como hash...",
      "importance": 9,
      "score": 0.94,
      "created_at": "2026-05-13T10:00:00Z"
    },
    {
      "id": "019f...",
      "type": "architecture",
      "title": "Middleware api.key valida Bearer token",
      "score": 0.87
    }
  ]
}

score es la similitud coseno (0–1). Valores sobre 0.8 son altamente relevantes.