Configuración de IA
Campbooks usa IA para la organización automática de la bandeja de entrada, el análisis de documentos, los borradores de respuesta y el asistente Scout. La IA es opcional — la aplicación funciona completamente sin ella, y estas funciones se activan en cuanto añades una clave de proveedor. Puedes combinar proveedores y asignarlos a diferentes tareas.
Dos roles: texto y visión
Con independencia de cuántas tareas individuales de IA haya, la configuración se reduce a elegir dos modelos:
- Un modelo de texto — alimenta la organización automática, el chat, los resúmenes, los borradores de respuesta y los recordatorios. Cualquier proveedor sirve.
- Un modelo de visión — lee los adjuntos de documentos para clasificarlos y extraerlos. Debe ser un proveedor con capacidad de visión (OpenAI, Anthropic o Gemini).
Si defines una única clave de OpenAI, cubre ambos roles además de los embeddings usados para la búsqueda semántica. Es la configuración más sencilla posible.
Los servicios de IA
Internamente, esos dos roles se distribuyen en ocho servicios, cada uno de los cuales puede usar un proveedor diferente si deseas un control más fino:
| Servicio | Rol | Propósito |
|---|---|---|
| Análisis de documentos | Visión | Clasificar y extraer adjuntos de documentos |
| Clasificación de correo | Texto | Categorizar los correos entrantes |
| Análisis de correo | Texto | Extraer elementos de acción y señales |
| Extracción de recordatorios | Texto | Detectar compromisos con fecha y convertirlos en recordatorios |
| Chat de correo | Texto | Chatear sobre un hilo de correo concreto |
| Borrador de respuesta | Texto | Generar borradores de respuesta a correos |
| Chat de redacción | Texto | Asistir mientras redactas un mensaje |
| Chat global | Texto | El asistente Scout |
Proveedores
Campbooks admite cinco proveedores. Tres tienen capacidad de visión (necesaria para el análisis de documentos); los cinco gestionan texto.
| Proveedor | Visión | Residencia de datos | Clave de entorno |
|---|---|---|---|
| OpenAI | ✓ | EE. UU. | OPENAI_API_KEY |
| Anthropic (Claude) | ✓ | EE. UU. | ANTHROPIC_API_KEY |
| Gemini | ✓ | EE. UU. | GEMINI_API_KEY |
| Mistral | — | UE | MISTRAL_API_KEY |
| DeepSeek | — | China | DEEPSEEK_API_KEY |
La residencia de datos importa para el RGPD. Mistral procesa en la UE, por eso es el predeterminado preferido para usuarios europeos; los demás implican transferencias internacionales, y DeepSeek (China) no cuenta con una decisión de adecuación de la UE. La región del proveedor se muestra en la configuración de IA para que puedas elegir con conocimiento de causa.
Modelos
Cada proveedor ofrece varios modelos; elige uno por servicio (el predeterminado en negrita):
| Proveedor | Modelos |
|---|---|
| Anthropic | claude-sonnet-4-6, claude-haiku-4-5, claude-opus-4-7, claude-sonnet-4-5 |
| OpenAI | gpt-4o, gpt-4o-mini, gpt-4-turbo, gpt-4, o3-mini, o4-mini |
| Mistral | mistral-large-latest, mistral-medium-latest, mistral-small-latest, ministral-8b-latest |
| DeepSeek | deepseek-v4-pro, deepseek-chat, deepseek-reasoner |
| Gemini | gemini-2.5-flash, gemini-2.5-pro, gemini-2.0-flash, gemini-1.5-pro, gemini-1.5-flash |
De dónde vienen las claves
Hay dos formas de proporcionar claves:
- Autoalojado (para toda la instancia): define las claves de entorno del proveedor en
.env. ConSELF_HOSTED=1, la app las lee y cada espacio de trabajo puede usar la IA sin introducir su propia clave. - Por espacio de trabajo (trae la tuya): un usuario añade una clave en Configuración → IA. Se almacena cifrada y es exclusiva de ese espacio de trabajo.
Añadir un adaptador de IA
- Ve a Configuración → IA y haz clic en Añadir adaptador.
- Elige el proveedor (OpenAI, Anthropic, Mistral, DeepSeek o Gemini).
- Introduce la clave de API — o déjala en blanco para usar la clave de entorno de la instancia (autoalojado).
- Opcionalmente define una URL de endpoint personalizada para enrutar a través de una puerta de enlace compatible con OpenAI o un servidor de modelo local (la URL se valida para bloquear solicitudes a infraestructura interna).
- Elige el modelo.
Luego asigna el adaptador a los servicios que deban usarlo — o simplemente define los dos roles durante la configuración inicial y deja que se distribuyan solos.
Asignar adaptadores a servicios
Cada servicio puede usar un adaptador diferente. En Configuración → IA, despliega un servicio y elige su adaptador. El cambio surte efecto de inmediato — de modo que puedes usar un modelo rápido y económico para la clasificación y uno más capaz para el análisis y el chat.
El análisis de documentos requiere un proveedor de visión. Si asignas un proveedor solo de texto (DeepSeek o Mistral) al Análisis de documentos, la app no te permitirá guardar la configuración. Usa OpenAI, Anthropic o Gemini para ese servicio.
Búsqueda semántica
Los embeddings alimentan la búsqueda semántica en correos y documentos, y los producen OpenAI o Gemini. Sin ninguno de los dos configurado, la búsqueda sigue funcionando — recurre a la coincidencia por palabras clave (ILIKE).
Pruebas
Tras configurar un adaptador, pruébalo enviando un mensaje en Scout o reprocesando un documento. Si algo falla, comprueba que la clave de API y (si la defines) el endpoint son correctos, que el nombre del modelo es uno que el proveedor acepta, y que el proveedor admite la función que estás usando (p. ej., visión para el análisis de documentos).