Agentes

Los Agentes te permiten construir una automatización de trading de forma visual, sin escribir un script de estrategia completo. En el lienzo QuantCraft — Agents conectas nodos que obtienen datos, toman una decisión (con reglas o un prompt de IA), colocan operaciones y envían alertas; después ejecutas todo el flujo como un backtest histórico o como una ejecución forward (en vivo/papel). La función Agentes controla la página de Agentes, su enlace de navegación y su ventana emergente; ejecutar agentes desde el menú Agents del gráfico y el New Agent Bulk Run de AutoTrading está disponible en cualquier caso.

Abre Agents desde la navegación (o saca el editor a su propia ventana). Los agentes se apoyan en otras partes de QuantCraft: el asistente de IA impulsa los nodos AI Prompt; los backtests usan la cuenta en papel, y las ejecuciones forward pueden enviar órdenes a tu cuenta de bróker conectada seleccionada.

Tipos de agente

Create agent pregunta qué tipo quieres y luego un nombre:

Los agentes Test y Optimization muestran "Not available in this build." cuando esa función está desactivada.

---

Tipos de nodo

Añade nodos desde el selector (el Schedule trigger se crea por ti y no aparece en el selector).

Los nodos condicionales son Strategy y AI Prompt: producen un booleano y controlan si se ejecutan sus hijos.

---

Construir un agente

1. Crea un agente en la barra lateral (Create agent → Trading Agent → ponle nombre). Aparece como Draft con un Schedule trigger ya colocado.
2. Añade un nodo: haz clic en el botón + (añadir hijo) de un nodo, o clic derecho en un nodo → Node Actions → New Child Node. El selector solo ofrece nodos válidos como hijos del que pulsaste (por ejemplo, un nodo Execution solo aparece bajo un nodo Strategy o AI Prompt, y un nodo Execution solo ofrece hijos Notification).
3. Conecta nodos: arrastra el tirador de reasignación de padre de un nodo sobre otro nodo. Reglas:
   • Un nodo puede tener como máximo 2 padres.
   • No se permiten ciclos.
   • Un nodo Data pasa a ser el padre del nodo condicional al que alimenta.
   • Un nodo Execution solo puede conectarse a un nodo Strategy o AI Prompt, y sus únicos hijos pueden ser nodos Notification.
   • Haz clic en una arista para eliminar ese enlace.
4. Configura un nodo: haz clic en él para abrir el panel inspector, que tiene pestañas según el tipo (Rules / Sources, más Output; Strategy y AI Prompt también tienen una pestaña Received data). Los nodos Trigger, Strategy y Execution también tienen una pestaña Parameters; consulta Parámetros expuestos. Cada fila de regla o fuente se edita haciendo clic.
5. Define la puerta de entrada: para los hijos de un nodo condicional, el panel muestra un resumen Upstream gate. Ábrelo para elegir cómo se combinan los padres (AND / OR) y qué resultado debe producir cada padre (true / false). Convención: condiciona una entrada a true y la salida correspondiente a false.

Los datos fluyen hacia abajo por el grafo: un nodo Strategy o AI Prompt lee todos los datos de OHLCV, fundamentales y de factores de cada nodo Data que tenga por encima.

¿Prefieres describir el agente con palabras? Usa el AI Builder.

---

Configurar nodos

Schedule trigger

En un backtest, el calendario lo fija la pestaña Scheduler del cuadro Test, que sustituye a este nodo. El calendario del nodo se aplica a las ejecuciones forward.

Fuentes de datos

Un nodo Data puede contener varias fuentes a la vez.

El esquema describe el JSON que devuelve el script o la URL; sus campos son los que el elemento Custom data de un nodo Strategy te permite comparar. Guardar sin uno muestra "Enter a JSON response schema."

Un nodo admite como máximo una fuente Fama-French y como máximo una fuente Fundamentals por periodo del informe.

Elementos de Strategy

Un nodo Strategy combina uno o más elementos. Los tipos de elemento disponibles dependen de los Data de entrada (por ejemplo, las reglas Indicator necesitan OHLCV de entrada, y un elemento Fundamentals necesita una fuente de datos fundamentales de entrada).

Tipos de elemento: Script, Indicator, Fundamentals, Trade Activity, Account Status, Custom data, Fama-French.

Operadores de comparación

Indicadores: está disponible todo el registro de indicadores del gráfico. Los indicadores de salida única incluyen SMA, EMA, WMA, RSI, ATR, OBV, VWAP, CCI, ROC, Williams %R, Parabolic SAR, HMA, DEMA, TEMA, Supertrend, VWMA, MFI, Awesome Oscillator, CMF y A/D Line. Los indicadores de varias salidas (Bollinger Bands, MACD, Stochastic, Donchian, ADX, Ichimoku, Keltner, Stochastic RSI y PPO) te permiten elegir qué línea comparar (p. ej. la línea MACD frente a su señal). Consulta Series de indicadores.

Métricas de Trade Activity: número de operaciones abiertas, cantidad total de las operaciones abiertas, y los mismos recuentos restringidos al símbolo actual. Métricas de Account Status: capital (equity), saldo, P/L flotante.

Usa Combine items with (a nivel de nodo) y Combine rules with (por elemento) para unir condiciones con AND u OR.

Acciones de Execution

Cada acción es una Entry (open), una Exit (close) o un Script. El símbolo viene de la configuración de la ejecución; no lo escribes aquí.

Entry (coloca una orden)

Exit (cierra una posición): Cantidad (acciones) o Porcentaje de la posición. Script: ejecuta un Agent Script de QuantCraft.

Notification

Una regla envía un correo electrónico a un destinatario, con un mensaje personalizado opcional y un interruptor Include Previous Node Output. El interruptor Disable in Backtest a nivel de nodo omite los correos durante un Agent Test.

---

Backtest de un agente

Haz clic en Test en el encabezado del editor para abrir Test agent (backtest).

Pestaña Setup

Pestaña Scheduler

La pestaña Scheduler sustituye al nodo Schedule trigger solo en el backtest; las ejecuciones forward siguen el nodo.

Pestaña Optimization: aparece cuando el agente tiene parámetros expuestos. Marca Run as optimization para recorrerlos (cuadrícula o genética) en lugar de ejecutar una sola vez; el botón pasa entonces a Start optimization en lugar de Start test.

Requisitos y controles

• Se requiere una cuenta de trading conectada activa: se usa para precargar datos de mercado, así que Test no arranca sin ella.
• Mientras una ejecución está en curso, el botón Test pasa a ser Pause / Resume y Stop. La pausa surte efecto cuando termina el nodo que se está ejecutando.
• Se recuerdan tus últimos ajustes de Test.

Resultados: si todo va bien, el encabezado cambia a una pestaña Test Results: gráfico OHLC con superposiciones de indicadores, historial de operaciones, curva de capital y métricas de la cuenta, más el calendario de reequilibrio del Screener y las filas de split / dividendo cuando corresponda. Las ejecuciones con varios símbolos comparten una cuenta en papel, así que las operaciones y métricas se combinan (no son por símbolo). La pestaña Output de cada nodo muestra registros en directo (datos obtenidos, aprobación/fallo de la estrategia, respuestas de la IA, ejecuciones de órdenes, intenciones de correo); los nodos Strategy y AI Prompt también muestran las entradas exactas en su pestaña Received data.

---

Parámetros expuestos y optimización

En un nodo Trigger, Strategy o Execution, la pestaña Parameters te permite marcar ajustes numéricos (un intervalo, un periodo de indicador, un umbral, un tamaño de orden…) como expuestos, con un rango. Los parámetros expuestos son lo que recorre la pestaña Optimization del cuadro Test y lo que ajusta un agente de optimización de IA. Consulta Optimización para ver cómo funcionan la búsqueda en cuadrícula y la genética.

---

AI Builder

El botón AI Builder (icono de destellos) del encabezado de un agente Trading abre un chat junto al lienzo. Describe el agente en lenguaje natural y tu modelo de IA conectado añade, configura y enlaza los nodos por ti; además puede escribir Agent Scripts en tu espacio de trabajo.

• El modo Ask responde preguntas sobre el grafo sin cambiarlo; el modo Build hace cambios.
• Los cambios se aplican en directo, y cada respuesta tiene Keep / Undo.
• Puedes adjuntar archivos a tus mensajes.
• Usa la misma conexión de modelo que QuantCraft AI; su uso de tokens cuenta en la insignia de tokens del agente.

---

Agentes de IA de prueba y optimización

Los agentes Test y Optimization no tienen un grafo de nodos. Le das a la IA un objetivo (un algoritmo del IDE o un Trading agent) más Instructions for the AI, y límites: Max iterations (una iteración = un backtest; la IA las planifica todas de antemano), Max AI rounds, Max AI tokens y Max backtest windows. Marca Allow market data tools para dejarle usar QuantCraft Tools (desactivado por defecto). Puedes adjuntar archivos a las instrucciones.

Cuando inicias uno, la IA trabaja en sus propias ventanas emergentes controladas por la IA: ejecuta backtests y optimizaciones, guarda hallazgos en memoria y termina con un resumen. La página del agente tiene las pestañas Overview, Sessions, Windows y Memory, para que puedas seguir cada sesión, ver su plan de iteraciones y ejecuciones, y cerrar ventanas.

Los resultados de backtest y optimización, incluido el resumen que haga una IA, describen únicamente datos históricos y no garantizan resultados en vivo.

---

Guardar, gestionar y monitorizar

• Save quita la insignia Draft y conserva una copia guardada del grafo. Cada edición se sigue guardando automáticamente en local, pero en cuanto cambias un agente guardado vuelve la insignia Draft con un botón Undo, que (tras una confirmación) devuelve el grafo a tu último guardado.
• En la barra lateral, haz clic derecho en un agente para Rename, Duplicate o Delete. Duplicar clona el grafo como un nuevo borrador.
• Compartir agentes como archivos (aplicación de escritorio): el menú ⋯ del encabezado tiene Export…, que guarda el agente como un archivo .qca, y el menú de la barra lateral tiene Import… para cargar uno o varios archivos .qca. Las referencias a Agent Scripts se vuelven a enlazar con tu espacio de trabajo al importar.
• Durante una ejecución, cada tarjeta de nodo muestra una insignia de estado en directo (en espera, en ejecución, ok, fallido u omitido) y envía eventos a su pestaña Output.

---

Conviene saber

• Ejecución backtest vs forward. El Test de un agente (backtest) usa una cuenta en papel simulada. Las ejecuciones forward (menú Agents del gráfico, New Agent Bulk Run de AutoTrading) usan la cuenta de bróker conectada seleccionada y pueden enviar órdenes reales cuando esa cuenta es real. Los ejecutores de QuantCloud solo ejecutan algoritmos del IDE, no agentes.
• El calendario se aplica una vez iniciada la ejecución. El editor no inicia agentes automáticamente en segundo plano. Tras iniciar una ejecución forward / masiva / de gráfico, la cadencia procede del Schedule trigger (o de la sustitución de la pestaña Scheduler del cuadro Test en los backtests).
• Límites estructurales: máximo 2 padres por nodo, sin ciclos, los nodos Execution solo se conectan a nodos Strategy o AI Prompt, y los hijos de un nodo Execution solo pueden ser nodos Notification.
• Los datos fundamentales en un backtest están restringidos a Premium (el mismo acceso a datos gratuitos que el resto de interfaces de datos fundamentales cuando está habilitado).

---

Véase también

• QuantCraft AI: el nodo AI Prompt y cómo se elige su modelo
• QuantCraft Tools: herramientas de solo lectura que pueden invocar los nodos AI Prompt y los agentes de IA
• AutoTrading: Agent Bulk Run y monitorización forward local
• Screener: filtrar acciones por datos fundamentales para usarlas como objetivos de ejecución masiva
• Modelo de cuenta: la cuenta en papel, métricas, comisión / slippage
• Datos fundamentales: datos fundamentales
• Factores Fama-French: factores Fama-French
• Series de indicadores: superposiciones de indicadores del gráfico