Inicio rápido

Conecta tu primer proyecto y carga contexto en un agente en menos de 5 minutos.

1. Crear el proyecto

Desde la UI web en /projects/create, ingresa:

  • Nombre y Código (ej: mi-proyecto) — únicos campos obligatorios.
  • URL del repositorio (GitHub, GitLab o Gitea) — opcional.
  • Token Git si el repo es privado — opcional.
  • URL de Notion + Token de integración — opcional.
💡 Puedes crear un proyecto vacío, sin fuentes externas. En ese caso empieza vacío y vas registrando memorias manualmente vía API o dashboard.

Al guardar, SoluCortex muestra dos datos que necesitas guardar de inmediato:

  • Project ID — UUID del proyecto (visible siempre en el dashboard).
  • API key (scx_...) — Cópiala ahora, solo se muestra una vez.
⚠️ La API key no se puede recuperar después. Si la pierdes, genera una nueva desde el dashboard del proyecto. El Project ID siempre es visible en la URL y en la página del proyecto.

2. Guardar las credenciales

En tu proyecto, crea o edita ai/.env.ai:

bash
SOLUCORTEX_URL=https://solucortex.soluai.cl
SOLUCORTEX_PROJECT_ID=<uuid-del-proyecto>
SOLUCORTEX_API_KEY=scx_<tu-api-key>
🔒 ai/.env.ai debe estar en .gitignore. Nunca commitear credenciales.

3. Importación inicial (si conectaste fuentes)

Si configuraste Git o Notion, el worker importa memorias en background (~1–3 min). Verifica en el dashboard que aparezcan memorias con estado pendiente y apruébalas desde /memories → Aprobar todas las del filtro.

Si creaste el proyecto vacío, salta este paso — el proyecto ya está listo para recibir memorias.

4. Cargar contexto en tu agente

bash
source ai/.env.ai

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\"
  }"

La respuesta devuelve las memorias más relevantes, listas para pegar en el contexto del agente.

5. Registrar tu primera memoria

bash
curl -s -X POST "$SOLUCORTEX_URL/api/v1/memories" \
  -H "Authorization: Bearer $SOLUCORTEX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d "{
    \"project_id\": \"$SOLUCORTEX_PROJECT_ID\",
    \"type\": \"decision\",
    \"title\": \"Usar pgvector para búsqueda semántica\",
    \"content\": \"Se eligió pgvector sobre Pinecone para mantener todo en PostgreSQL y evitar dependencias externas.\",
    \"importance\": 8
  }"
✓ ¡Listo! Ya tienes tu primer proyecto conectado y funcionando. La memoria fue registrada y estará disponible en futuras búsquedas semánticas una vez que se genere su embedding.