QuantCraft AI

QuantCraft incluye un asistente de IA integrado en la barra lateral derecha del IDE (Disposición del espacio de trabajo): un panel de chat que te ayuda a escribir y editar Python de estrategias de trading con conocimiento de tu espacio de trabajo. Puede ver el archivo abierto en el editor, cualquier archivo que menciones con @ y los esquemas de tus otros archivos abiertos, de modo que sus respuestas y ediciones tienen contexto. Funciona como un agente de programación dentro del IDE: puede crear archivos nuevos o editar los existentes por ti en un solo turno de chat.

Para usarlo, abre la barra lateral derecha y cambia a la pestaña QuantCraft AI. El modelo que conectas es común a toda la aplicación: la misma conexión alimenta este chat, los nodos AI Prompt y el AI Builder en los Agentes, y los agentes de IA de Test / Optimization. Usa el editor de Python y Ejecutar código para validar cualquier cambio de estrategia sugerido con Test / Run.

También hay un panel Documentation en la misma barra lateral: una referencia estática de la API de estrategias (ciclo de vida, OHLCV, indicadores, datos fundamentales, factores, entradas, cuenta), además de las páginas Agent Scripts y Screener Script. Consulta Referencia.

---

Modos del asistente

Puedes cambiar el modo y Auto-continue en el compositor, o en Assistant mode dentro del cuadro de diálogo API Providers.

---

Conectar un modelo

QuantCraft AI funciona con varios proveedores. Algunos son de trae tu propia clave (se facturan a tu cuenta con el proveedor); QuantCraft Premium y las opciones alojadas funcionan con acceso gestionado. Abre AI → API Providers en el menú superior (el cuadro se titula AI API Providers; el enlace de conexión del chat también lo abre), elige un proveedor y rellena sus campos.

GitHub Copilot y Cursor pueden aparecer en la lista, pero los turnos de chat aún no están conectados (maquetas de interfaz), y las funciones de IA de los Agentes también los rechazan. Usa Anthropic, DeepSeek (clave propia o alojado), OpenCode, QuantCraft Premium o Custom LLM.

Pega la clave (cuando se requiera), elige el modelo y haz clic en Save.

Custom LLM

Usa Custom LLM para conectar un modelo propio o autoalojado compatible con OpenAI.

La conexión se considera lista en cuanto se define la URL. En la aplicación de escritorio, el HTTP hacia los proveedores pasa por el plugin HTTP de Tauri; los endpoints localhost / 127.0.0.1 están permitidos. Los hosts remotos arbitrarios de Custom LLM no se pueden configurar mediante una interfaz de lista de permitidos: prefiere un servidor local compatible con OpenAI o un proveedor ya compatible de los anteriores.

Dónde viven las claves: los valores de "trae tu propia clave" se almacenan solo en tu equipo (en el llavero del sistema operativo en la aplicación de escritorio, o en el almacenamiento local de este navegador). Nunca se suben a QuantCraft y solo se envían al proveedor que seleccionaste. Si borras los datos del navegador o cambias de equipo, tendrás que volver a introducir la clave.

A dónde van las solicitudes: con un proveedor de "trae tu propia clave", QuantCraft AI llama directamente al proveedor desde tu equipo usando tu clave. La aplicación de escritorio (Tauri) usa un puente HTTP para que las solicitudes no las bloquee el CORS del navegador; ejecutar QuantCraft AI en la versión de navegador puede mostrar un mensaje "Request failed" relacionado con CORS. Usa la versión de escritorio para la mejor experiencia.

Elegir un modelo

Cada proveedor tiene un desplegable de modelos junto al campo de la clave. La insignia de conexión al final del chat muestra el proveedor activo y el nombre corto del modelo (por ejemplo Anthropic (Claude) · Claude Sonnet 4.6). Se pueden guardar varios proveedores: la insignia muestra el usado más recientemente con un sufijo +N cuando hay más de una clave.

Para Anthropic, el desplegable lista Claude Sonnet 4.6, Claude Opus 4.8, Claude Opus 4.7, Claude Haiku 4.5 y otras variantes actuales de Opus / Sonnet. Elige la que tu cuenta tenga disponible. Si intentas enviar un mensaje por la vía de Anthropic sin una clave guardada, el asistente responde con un recordatorio para añadir una.

---

Usar el chat

• Escribe en el compositor y pulsa Enter para enviar, Shift+Enter para una nueva línea.
• Escribe @ para abrir un menú de menciones de archivos y traer otro archivo del espacio de trabajo al contexto.
• Las respuestas se muestran en markdown con bloques de código.
• Stop interrumpe una respuesta en curso.

Compositor y adjuntos

• El botón Attach files abre un selector de archivos. También puedes arrastrar y soltar archivos sobre el área de entrada, o pegar un archivo o imagen desde el portapapeles.
• Una fila de chips de adjuntos sobre el área de texto muestra cada archivo en cola. Cada chip tiene su nombre (y una miniatura para imágenes) y una × para quitarlo.
• Se acepta cualquier tipo de archivo. Los archivos de imagen muestran una pequeña miniatura en línea en el flujo de mensajes tras enviarse.
• Los adjuntos pertenecen al mensaje con el que se envían: se muestran junto a ese mensaje en el historial del chat.
• En el chat del IDE los adjuntos se muestran, pero su contenido no se envía al modelo. Para compartir el contenido de un archivo del espacio de trabajo, menciónalo con @.

Mientras el asistente genera una respuesta, el compositor está desactivado con el texto "Please wait…" y aparece una pequeña fila de estado en la lista de mensajes (p. ej. Building API messages…, Streaming reply… 1,234 characters, Syncing to workspace folder on disk…).

---

Sesiones de chat

QuantCraft AI conserva un historial de sesiones de chat. Cada sesión es una conversación independiente, con sus propios mensajes y adjuntos. La barra superior del panel de chat tiene:

• New chat: inicia una sesión nueva y vacía. Está desactivado mientras el asistente trabaja, mientras tienes una edición de archivo pendiente, o si tu chat actual ya está vacío.
• Chats: un desplegable con todas las sesiones guardadas, las más recientes primero. Cada entrada muestra su título (derivado automáticamente del primer mensaje del usuario) y la hora de la última actualización. Haz clic en una fila para cambiar, o en el icono de papelera para eliminarla.

Las sesiones se guardan automáticamente (en la configuración local de la aplicación de escritorio, o si no en el almacenamiento local del navegador) y sobreviven a recargas y reinicios. Cambiar de chat y crear nuevos está bloqueado mientras se transmite una respuesta o mientras tienes una barra Accept/Undo sin resolver: termina o deshaz primero el cambio.

---

Qué puede ver el asistente

Cada vez que envías un mensaje, QuantCraft AI construye la solicitud con:

1. La documentación para desarrolladores de QuantCraft incluida (así conoce el ciclo de vida, la API de cuenta, los módulos OHLCV / datos fundamentales, las series de indicadores, etc.).
2. Una instantánea reciente del espacio de trabajo: la ruta de la carpeta de trabajo vinculada, el archivo abierto en el editor y la lista de pestañas y carpetas abiertas.
3. Los turnos anteriores de la sesión de chat activa (tus mensajes y sus respuestas).
4. Tu mensaje nuevo y los adjuntos que lleve.

Por eso elegir una carpeta de trabajo en la barra lateral Files es importante: sin ella, el asistente aún puede responder preguntas, pero no puede escribir archivos en disco y te lo dirá.

---

Ediciones de archivos del asistente

En modo Agent, el asistente puede devolver una o varias acciones sobre archivos en una sola respuesta: crear un archivo nuevo, editar el archivo actual del editor o editar un archivo concreto del espacio de trabajo. Cuando eso ocurre:

• Los archivos nuevos aparecen como una pestaña nueva en la carpeta vinculada; los existentes se actualizan en su sitio en su pestaña.
• El editor salta a la ubicación modificada y resalta las líneas cambiadas para que revises lo que hizo el asistente.
• Aparece una barra de pendientes al final del chat con un breve resumen y dos botones:
  • Accept: conserva el cambio. Se quita el resaltado y puedes seguir chateando.
  • Undo: revierte el cambio. En una edición se restaura el contenido anterior del archivo. En un archivo nuevo se quita la pestaña nueva.
• Hasta que pulses Accept o Undo, el chat está congelado: no puedes cambiar de sesión ni enviar otro mensaje. Es intencionado: garantiza que revises activamente cada cambio.
• En respuestas con varios archivos, la barra indica cuántos cambios se aplicaron. El botón Undo solo revierte el último paso, así que revisa los resaltados pestaña por pestaña si hace falta.

Estrategias de varios archivos

En modo Agent el asistente puede dividir una estrategia en módulos auxiliares dentro de carpetas (indicators/, risk/, …) e importarlos desde el archivo raíz del algoritmo. Mantiene las funciones del ciclo de vida (on_init, on_bar, …) en el archivo raíz y usa importaciones absolutas desde la raíz del espacio de trabajo, p. ej. from indicators.momentum import calc_rsi, sin archivos __init__.py.

• El asistente ve completos los archivos que importa el archivo activo y los que lo importan a él. De tus demás archivos solo ve esquemas: para que edite uno de ellos, menciónalo con @.
• Los cambios de archivos de cada respuesta se comprueban antes de aplicar ninguno. Si un paso no puede ejecutarse con seguridad (por ejemplo, crearía un archivo que ya existe o reescribiría un archivo que solo vio en esquema), no se aplica ninguno de los pasos y la respuesta explica por qué.
• Tras aplicar los cambios, las importaciones del espacio de trabajo que fallarían en tiempo de ejecución (por ejemplo, un módulo auxiliar renombrado sin actualizar los archivos que lo importan) se listan bajo la respuesta. El agente las corrige en su siguiente turno.

Sincronización con el disco

Los archivos también se sincronizan con la carpeta de trabajo vinculada en disco (en la aplicación de escritorio). En la versión de navegador, los archivos se siguen actualizando en el editor y las pestañas, pero no se reflejan en disco: la respuesta lo indica para que sepas que debes usar la versión de escritorio para una integración completa de archivos.

---

QuantCraft Tools integradas

Un conjunto propio de herramientas de mercado de solo lectura (OHLCV, indicadores, datos fundamentales, screener, cuenta y posiciones) está activado por defecto y se puede invocar directamente desde el chat (y desde los nodos AI Prompt de los agentes). Gestiónalo en AI → MCPs (la fila QuantCraft Tools (built-in) al principio). Consulta QuantCraft Tools.

---

Herramientas del Screener

Cuando la función AI Screener está habilitada, el chat también puede manejar el Screener por ti: abrir una ventana del Screener, construir o cargar un filtro, ejecutarlo y leer los resultados. La ventana muestra "The AI is using this window" y bloquea sus controles mientras la IA trabaja. En los modos Chat y Plan la IA solo obtiene el subconjunto de solo lectura (puede ver filtros y resultados pero no cambiarlos); el modo Agent obtiene el conjunto completo. Consulta Screener.

---

Herramientas

Las herramientas son servicios de datos externos que el modelo del chat puede invocar mientras responde. Añádelas desde AI → AI Tools.

• La herramienta disponible es LLMQuant Data: actívala con la casilla Enable for chat y pega una API key (hay un enlace "Get a key").
• Una vez activada, el asistente puede obtener datos en vivo durante la conversación en categorías como wiki y artículos de investigación, precios de acciones y criptomonedas, consulta de ETF y sus carteras, indicadores macro, presentaciones ante la SEC y posiciones 13F, y datos de mercados de predicción.

Las herramientas solo se adjuntan en proveedores de chat operativos (Anthropic, DeepSeek, OpenCode, Premium, Custom LLM). Copilot / Cursor no están implementados para el chat, así que las herramientas nunca se ejecutan con esas selecciones.

---

Servidores MCP

Los servidores MCP (Model Context Protocol) exponen sus propias herramientas al asistente. Añádelos y gestiónalos desde AI → MCPs. La lista empieza con la fila integrada QuantCraft Tools (built-in); cada servidor guardado tiene un interruptor Enabled for chat además de Edit / Remove, y las herramientas de los servidores activados quedan disponibles en el chat.

Para añadir uno, haz clic en Add server y elige un Transport:

Dale un Name al servidor, usa Test connection para comprobarlo (informa de cuántas herramientas expone), luego Apply para añadirlo a la lista y Save para guardarlo.

---

Nodos AI Prompt en Agentes

Dentro de un Agente puedes añadir un nodo AI Prompt: la contraparte de IA de un nodo Strategy.

• Escribes un único prompt de texto libre que plantea una pregunta de sí/no, p. ej. "Dados el movimiento reciente del precio y los datos fundamentales, ¿es esta una configuración alcista?" No hay reglas estructuradas.
• Una sección Data sent to the AI muestra chips con los datos de entrada que recibe el modelo (ventana OHLCV, datos fundamentales, etc.). Enlaza un padre Data, o el nodo avisa de que la IA no tiene entradas.
• La respuesta de la IA se fuerza a true / false, y ese resultado condiciona los nodos hijos mediante la puerta de entrada, igual que el resultado de un Strategy.
• El modelo también puede invocar las QuantCraft Tools de solo lectura (OHLCV, indicadores, datos fundamentales, screener, cuenta, posiciones) limitadas a la ejecución.

Qué modelo lo ejecuta depende de tu conexión activa:

• QuantCraft Premium: la llamada se ejecuta en el servidor con el acceso que se te asignó. Aquí solo funciona una concesión de Claude; una de DeepSeek detiene la ejecución con "not supported for AI Prompt nodes yet".
• Trae tu propia clave (Anthropic, OpenCode o Custom LLM): la llamada se ejecuta desde la aplicación con tu propia clave, que nunca se envía al servidor.

DeepSeek (con clave propia o alojado) todavía no funciona en los nodos AI Prompt.

El uso de tokens de los nodos AI Prompt de Agent Test y del AI Builder se contabiliza por agente y se muestra como una insignia en el encabezado del editor: Tokens · This month: … · Lifetime: … (la cifra mensual se reinicia cada mes natural).

---

Consejos

• Vincula primero una carpeta de trabajo. En la barra lateral Files, elige la carpeta de tu proyecto. Sin ella, el asistente puede responder preguntas pero no puede crear ni editar archivos en disco.
• Sé explícito con las rutas de los archivos. Al pedir una edición, menciona el título de la pestaña o una ruta como utils/foo.py. El asistente entiende ambas.
• Usa Undo sin miedo. Es más seguro dejar que el asistente intente un cambio de varios archivos y deshacerlo que microgestionar cada paso: deshacer restaura el búfer del editor al instante.
• Cambia de modelo según la tarea. Usa un modelo Claude más rápido para ediciones rutinarias y uno más potente (Opus) para grandes refactorizaciones o diseño de estrategias.
• Mantén tus claves seguras. Los valores de "trae tu propia clave" viven solo en este equipo. Trátalos como contraseñas: no los pegues en ningún sitio fuera del cuadro AI API Providers.