Saltar al contenido principal

Asistente IA

Haz preguntas sobre tu código en lenguaje natural.

Descripción General​

El Asistente IA de ArchiCore comprende tu código y puede responder preguntas como:

  • "¿Cómo funciona el sistema de autenticación?"
  • "¿Qué se rompería si cambio UserService?"
  • "¿Dónde está la lógica de procesamiento de pagos?"
  • "Explica el flujo de datos para la creación de pedidos"

Usando el Asistente​

Interfaz Web​

  1. Selecciona un proyecto
  2. Escribe tu pregunta en el panel de chat
  3. Obtén una respuesta con referencias al código

CLI​

Simplemente escribe tu pregunta en modo interactivo:

> ¿Cómo funciona la autenticación de usuarios?

El sistema de autenticación en este proyecto usa tokens JWT.
Así es como funciona:

1. **Flujo de Login** (src/auth/login.ts)
   - El usuario envía email/contraseña
   - Credenciales validadas contra la base de datos
   - Token JWT generado con ID de usuario

2. **Validación de Token** (src/middleware/auth.ts)
   - authMiddleware() extrae el token del header
   - Token verificado usando JWT_SECRET
   - Usuario adjunto al objeto request

3. **Gestión de Sesiones** (src/services/session.ts)
   - Sesiones almacenadas en Redis
   - Expiración de 7 días por defecto
   - Soporte para refresh token

Archivos clave:
- src/auth/login.ts:45-78
- src/middleware/auth.ts:12-34
- src/services/session.ts:23-56

API​

curl -X POST https://api.archicore.io/api/v1/projects/:id/ask \
  -H "Authorization: Bearer TU_API_KEY" \
  -d '{"question": "¿Cómo funciona la autenticación?"}'

Tipos de Preguntas​

Preguntas de Arquitectura​

> ¿Cuál es la arquitectura general de este proyecto?
> ¿Cómo están organizados los módulos?
> ¿Qué patrones de diseño se usan?

Preguntas de Flujo de Código​

> ¿Qué pasa cuando un usuario hace un pedido?
> ¿Cómo fluyen los datos de la API a la base de datos?
> Traza el ciclo de vida de la petición para /api/users

Preguntas de Impacto​

> ¿Qué se rompería si cambio UserService?
> ¿Qué archivos dependen del módulo de base de datos?
> ¿Qué pruebas cubren la lógica de pagos?

Preguntas de Ubicación​

> ¿Dónde está la lógica de envío de emails?
> ¿Qué archivo maneja el registro de usuarios?
> Encuentra el middleware de rate limiting

Preguntas de Explicación​

> Explica qué hace processOrder()
> ¿Por qué esta función usa recursión?
> ¿Cuál es el propósito de la capa de caché?

Consejos para Mejores Respuestas​

Sé Específico​

❌ "¿Cómo funciona?"
✓ "¿Cómo funciona el proceso de registro de usuarios?"

Proporciona Contexto​

❌ "¿Por qué es lento?"
✓ "¿Por qué la función getProducts() en src/api/products.ts podría ser lenta?"

Haz Seguimiento​

> ¿Cómo funciona la autenticación?
[Respuesta sobre tokens JWT...]

> ¿Puedes mostrarme el código de validación de token?
[Muestra código específico...]

> ¿Qué pasa si el token está expirado?
[Explica el flujo de refresh token...]

Soporte de Idiomas​

El asistente responde en el mismo idioma de tu pregunta:

> ¿Cómo funciona la autenticación?

El sistema de autenticación utiliza tokens JWT...

Limitaciones​

El asistente IA:

  • Solo conoce código indexado - Ejecuta /index primero
  • No puede ejecutar código - Solo analiza código estático
  • Puede tener información desactualizada - Re-indexa después de cambios
  • Se enfoca en tu proyecto - No discutirá librerías externas en detalle

Privacidad​

  • Las preguntas son procesadas por modelos de IA
  • El contexto de tu código se envía para análisis
  • Ningún código se almacena permanentemente
  • Ver Política de Privacidad para detalles