skailan-ai/README.md

Servicio de IA y procesamiento de lenguaje natural para Skailan

# @skailan/ai

Servicio de IA y procesamiento de lenguaje natural para la plataforma Skailan.

## Descripción

Este módulo proporciona capacidades de inteligencia artificial y procesamiento de lenguaje natural para la plataforma Skailan. Incluye:

- Integración con múltiples proveedores de IA (OpenAI, Google Gemini)
- Generación de contenido automático
- Análisis de intenciones y sentimientos
- Configuración de prompts y LLMs
- Procesamiento de conversaciones en tiempo real

## Instalación

```bash
npm install @skailan/ai
```

## Uso

### Importación básica

```typescript
import { AIService } from '@skailan/ai';

const aiService = new AIService();

// Generar contenido
const content = await aiService.generateContent({
  prompt: "Escribe un email de bienvenida",
  model: "gpt-4"
});
```

### Configuración de variables de entorno

```env
OPENAI_API_KEY="your-openai-api-key"
GOOGLE_GEMINI_API_KEY="your-gemini-api-key"
DATABASE_URL="postgresql://user:password@localhost:5432/skailan"
```

## API Endpoints

### Configuración de LLM
- `GET /llm-configs` - Listar configuraciones de LLM
- `POST /llm-configs` - Crear configuración de LLM
- `GET /llm-configs/:id` - Obtener configuración
- `PUT /llm-configs/:id` - Actualizar configuración
- `DELETE /llm-configs/:id` - Eliminar configuración

### Prompts
- `GET /prompts` - Listar prompts
- `POST /prompts` - Crear prompt
- `GET /prompts/:id` - Obtener prompt
- `PUT /prompts/:id` - Actualizar prompt
- `DELETE /prompts/:id` - Eliminar prompt

### Generación de contenido
- `POST /content/generate` - Generar contenido
- `POST /content/analyze` - Analizar contenido
- `POST /intent/analyze` - Analizar intención

## Características

- **Múltiples proveedores**: Soporte para OpenAI y Google Gemini
- **Gestión de prompts**: Sistema de templates y variables
- **Configuración flexible**: Configuración por organización
- **Análisis de intenciones**: Clasificación automática de intenciones
- **Generación de contenido**: Creación automática de contenido relevante

## Dependencias

- OpenAI SDK para GPT models
- Google Generative AI para Gemini
- Express.js para el servidor web
- Prisma para ORM
- @skailan/core para autenticación

## Desarrollo

```bash
# Instalar dependencias
npm install

# Ejecutar en modo desarrollo
npm run dev

# Construir para producción
npm run build

# Generar cliente Prisma
npm run prisma:generate
```

## Ejemplos de uso

### Generar respuesta automática

```typescript
import { AIService } from '@skailan/ai';

const aiService = new AIService();

const response = await aiService.generateResponse({
  message: "Hola, necesito ayuda con mi cuenta",
  context: "Cliente nuevo",
  tone: "amigable"
});
```

### Analizar intención del cliente

```typescript
const intent = await aiService.analyzeIntent({
  message: "Quiero cancelar mi suscripción",
  customerHistory: "Cliente activo por 6 meses"
});
```

## Licencia

MIT