rag-service/docs/PENDIENTES_GENERALES.md

151 lines
5.9 KiB
Markdown

# Pendientes Generales
**Proyecto:** Workspace de tools IA para empresas
**Ultima actualizacion:** 2026-04-05
**Ultima modificacion por:** Agente tools IA para potenciar servicios empresariales
**Estado:** Activo
---
## Proposito
Este documento centraliza las lineas de trabajo, experimentos, investigaciones y tools pendientes del workspace para dar continuidad al objetivo principal:
- Desarrollar tools, herramientas, skills y componentes reutilizables para potenciar soluciones con IA para empresas.
- Priorizar piezas que puedan integrarse facilmente con servicios ya en funcionamiento.
- Mantener visible el estado de las iniciativas activas y sus siguientes pasos.
---
## Como usar este documento
Este archivo funciona como listado rapido de ideas, lineas de trabajo y frentes pendientes del workspace.
Cuando el usuario pregunte que hay pendiente por hacer, este documento debe permitir responder con un panorama rapido y claro.
No debe convertirse en un gestor detallado de tareas ni duplicar informacion que pertenezca a otros documentos.
---
## Lineas de trabajo prioritarias
### 1. Sistema basico RAG reutilizable
**Objetivo:**
Diseñar una base RAG simple, modular y facil de conectar a otros servicios ya existentes.
**Enfoque inicial:**
- Definir una arquitectura minima reutilizable.
- Permitir conexion sencilla desde otros servicios o agentes.
- Separar claramente ingesta, almacenamiento, recuperacion y consumo.
- Evaluar un formato de configuracion que permita adaptar el RAG a distintos clientes o casos de uso.
**Pendientes iniciales:**
- Definir estructura base del proyecto o modulo.
- Elegir estrategia inicial de almacenamiento y vectorizacion.
- Definir interfaz de integracion con servicios externos.
- Identificar un primer caso real de uso para validacion.
- Revisar y sustituir mas adelante el modelo actual de `answer` por una opcion alineada con la decision de no depender de OpenAI para esa capa.
**Estado:** En marcha
**Estado actual resumido:**
- La v1 del servicio RAG ya esta desplegada y operativa en `VPS2`.
- Dominio activo: `https://rag.por-correo.com`
- Modos ya funcionales: `documental` y `codigo`
- Endpoints operativos: `health`, `ingest`, `retrieve`, `answer`
**Pendientes inmediatos reales:**
- Sustituir el modelo actual de `answer` por una opcion no-OpenAI.
- Crear una metodologia reutilizable de despliegue correcto en EasyPanel para futuros servicios.
- Valorar refinados adicionales en retrieval y answer segun uso real.
---
### 2. Estructura MCP para integracion de tools
**Objetivo:**
Preparar una estructura MCP que permita ir conectando nuestras tools con otros servicios que vayamos desarrollando y poniendo en funcionamiento.
**Enfoque inicial:**
- Dejar una base de organizacion clara para futuras tools.
- Definir criterios para exponer capacidades de forma consistente.
- Diseñar una estructura que facilite escalar nuevas integraciones.
- Mantener separacion entre tools independientes y tools de soporte para otros servicios.
**Pendientes iniciales:**
- Definir estructura minima MCP del workspace.
- Establecer convenciones de organizacion para nuevas tools.
- Identificar primeras capacidades a exponer.
- Documentar como se conectara con servicios internos y externos.
**Estado:** Pendiente
---
### 3. Potenciar agentes de Retell con herramientas y flujos externos
**Objetivo:**
Preparar una integracion para que Retell pueda conectarse con flujos y servicios externos, como n8n y otros sistemas, de manera que el agente telefonico pueda apoyarse en herramientas adicionales y fuentes externas de informacion.
**Contexto actual:**
- Existe un flujo en n8n para atencion al cliente.
- Ese flujo ya dispone de varias herramientas para atender clientes de una empresa concreta.
- Actualmente las peticiones suelen llegar desde WhatsApp.
- Se quiere que Retell pueda aprovechar ese tipo de flujos externos y tambien futuras integraciones similares.
**Enfoque inicial:**
- Analizar como Retell puede invocar herramientas o endpoints externos.
- Diseñar una capa de integracion reutilizable para conectar Retell con n8n u otros servicios.
- Reutilizar herramientas ya existentes sin acoplarlas a un unico canal.
- Dejar preparada una via estandar para futuras integraciones de voz con fuentes externas.
**Pendientes iniciales:**
- Definir payloads de entrada y salida entre Retell y servicios externos.
- Identificar endpoint, adaptador o capa intermedia de integracion.
- Mapear como reutilizar el flujo actual de n8n desde Retell.
- Detectar necesidades de contexto, autenticacion, trazabilidad y control de errores.
**Estado:** Pendiente
---
### 4. Explorar posible potenciacion del RAG con Obsidian
**Objetivo:**
Evaluar si Obsidian puede aportar valor como capa de organizacion, fuente de conocimiento o apoyo a futuras capacidades del sistema RAG.
**Pendientes iniciales:**
- Revisar en que puntos podria integrarse con el RAG.
- Valorar si aporta ventajas reales para documentacion, enlaces entre conceptos o gestion de conocimiento.
- Dejarlo como linea futura, sin afectar a la salida de la v1.
**Estado:** Pendiente
---
## Criterios generales de desarrollo
- Priorizar soluciones simples y reutilizables.
- Favorecer integraciones desacopladas de un unico canal o proveedor.
- Diseñar cada tool pensando en reutilizacion por otros servicios.
- Documentar decisiones tecnicas y aprendizajes a medida que avancemos.
---
## Proximos pasos sugeridos
1. Sustituir el modelo actual de `answer` por una alternativa alineada con la estrategia del proyecto.
2. Documentar la metodologia correcta para desplegar futuros servicios en EasyPanel.
3. Diseñar la estructura inicial MCP del workspace.
---
## Resumen rapido
| Linea | Estado |
|-------|--------|
| Sistema basico RAG reutilizable | En marcha |
| Estructura MCP para integracion de tools | Pendiente |
| Retell conectado con herramientas externas | Pendiente |
| Posible potenciacion del RAG con Obsidian | Pendiente |