Agentes

Os Agentes permitem construir uma automação de trading de forma visual, sem escrever um script de estratégia completo. Na tela QuantCraft — Agents, você conecta nós que buscam dados, tomam uma decisão (com regras ou um prompt de IA), colocam operações e enviam alertas — e então executa todo o fluxo como um backtest histórico ou como uma execução forward (ao vivo/paper). O recurso Agentes controla a página Agentes, seu link de navegação e sua janela destacável; executar agentes pelo menu Agents do gráfico e o New Agent Bulk Run do AutoTrading está disponível de qualquer forma.

Abra Agents pela navegação (ou destaque o editor em uma janela própria). Os agentes se apoiam em outras partes do QuantCraft: o assistente de IA alimenta os nós AI Prompt; os backtests usam a conta paper, e as execuções forward podem enviar ordens para a sua conta de corretora conectada selecionada.

Tipos de agente

Create agent pergunta qual tipo você quer e depois um nome:

Os agentes Test e Optimization mostram "Not available in this build." quando esse recurso está desativado.

---

Tipos de nó

Adicione nós pelo seletor (o Schedule trigger é criado para você e não está no seletor).

Os nós condicionais são Strategy e AI Prompt — eles produzem um booleano e controlam se seus filhos são executados.

---

Construindo um agente

1. Crie um agente na barra lateral (Create agent → Trading Agent → dê um nome). Ele aparece como Draft com um Schedule trigger já posicionado.
2. Adicione um nó — clique no botão + (adicionar filho) de um nó, ou clique com o botão direito em um nó → Node Actions → New Child Node. O seletor só oferece nós válidos como filhos daquele em que você clicou (por exemplo, um nó Execution só aparece sob um nó Strategy ou AI Prompt, e um nó Execution só oferece filhos Notification).
3. Conecte os nós — arraste a alça de troca de pai de um nó sobre outro nó. Regras:
   • Um nó pode ter no máximo 2 pais.
   • Ciclos não são permitidos.
   • Um nó Data torna-se pai do nó condicional que ele alimenta.
   • Um nó Execution só pode ser ligado a um nó Strategy ou AI Prompt, e seus únicos filhos podem ser nós Notification.
   • Clique em uma aresta para excluir esse vínculo.
4. Configure um nó — clique nele para abrir o painel inspetor, que tem abas específicas do tipo (Rules / Sources, mais Output; Strategy e AI Prompt também têm uma aba Received data). Os nós Trigger, Strategy e Execution também têm uma aba Parameters — veja Parâmetros expostos. Toda linha de regra ou fonte é editável com um clique.
5. Defina a porta a montante — para os filhos de um nó condicional, o painel mostra um resumo Upstream gate. Abra-o para escolher como os pais se combinam (AND / OR) e que resultado cada pai deve produzir (true / false). Convenção: condicione uma entrada a true e a saída correspondente a false.

Os dados fluem para baixo no grafo: um nó Strategy ou AI Prompt lê todos os dados de OHLCV, fundamentalistas e de fatores de cada nó Data acima dele.

Prefere descrever o agente em palavras? Use o AI Builder.

---

Configurando os nós

Schedule trigger

Em um backtest, o cronograma é definido pela aba Scheduler da caixa Test, que substitui este nó. O cronograma do nó se aplica às execuções forward.

Fontes de dados

Um nó Data pode conter várias fontes ao mesmo tempo.

O esquema descreve o JSON que o script ou a URL retorna; seus campos são os que o item Custom data de um nó Strategy permite comparar. Salvar sem um mostra "Enter a JSON response schema."

Um nó permite no máximo uma fonte Fama-French e no máximo uma fonte Fundamentals por período do relatório.

Itens de Strategy

Um nó Strategy combina um ou mais itens. Os tipos de item disponíveis dependem dos Data a montante (por exemplo, regras Indicator precisam de OHLCV a montante, e um item Fundamentals precisa de uma fonte de dados fundamentalistas a montante).

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

Operadores de comparação

Indicadores — todo o registro de indicadores do gráfico está disponível. Os indicadores de saída única incluem SMA, EMA, WMA, RSI, ATR, OBV, VWAP, CCI, ROC, Williams %R, Parabolic SAR, HMA, DEMA, TEMA, Supertrend, VWMA, MFI, Awesome Oscillator, CMF e A/D Line. Os indicadores de várias saídas — Bollinger Bands, MACD, Stochastic, Donchian, ADX, Ichimoku, Keltner, Stochastic RSI e PPO — permitem escolher qual linha comparar (por exemplo, a linha MACD contra o seu sinal). Veja Séries de indicadores.

Métricas de Trade Activity: número de operações abertas, quantidade total das operações abertas, além das mesmas contagens restritas ao símbolo atual. Métricas de Account Status: patrimônio (equity), saldo, P/L flutuante.

Use Combine items with (no nível do nó) e Combine rules with (por item) para unir condições com AND ou OR.

Ações de Execution

Cada ação é uma Entry (open), uma Exit (close) ou um Script. O símbolo vem da configuração da execução — você não o digita aqui.

Entry (coloca uma ordem)

Exit (fecha uma posição): Quantidade (ações) ou Porcentagem da posição. Script: executa um Agent Script do QuantCraft.

Notification

Uma regra envia um e-mail a um destinatário, com uma mensagem personalizada opcional e uma chave Include Previous Node Output. A chave Disable in Backtest no nível do nó ignora os e-mails durante um Agent Test.

---

Fazendo o backtest de um agente

Clique em Test no cabeçalho do editor para abrir Test agent (backtest).

Aba Setup

Aba Scheduler

A aba Scheduler substitui o nó Schedule trigger apenas no backtest; as execuções forward continuam seguindo o nó.

Aba Optimization — aparece quando o agente tem parâmetros expostos. Marque Run as optimization para pesquisá-los (grade ou genética) em vez de executar uma única vez; o botão passa a mostrar Start optimization em vez de Start test.

Requisitos e controles

• É necessária uma conta de trading conectada ativa — ela é usada para pré-carregar dados de mercado, então o Test não inicia sem ela.
• Enquanto uma execução está em andamento, o botão Test vira Pause / Resume e Stop. A pausa tem efeito depois que o nó em execução termina.
• As suas últimas configurações de Test são lembradas.

Resultados — em caso de sucesso, o cabeçalho muda para uma aba Test Results: gráfico OHLC com sobreposições de indicadores, histórico de operações, curva de patrimônio e métricas da conta, além do cronograma de rebalanceamento do Screener e das linhas de desdobramento / dividendo quando aplicáveis. As execuções com vários símbolos compartilham uma conta paper, então operações e métricas são combinadas (não por símbolo). A aba Output de cada nó transmite logs ao vivo (dados buscados, aprovação/reprovação da estratégia, respostas da IA, execuções de ordens, intenções de e-mail); os nós Strategy e AI Prompt também mostram as entradas exatas na aba Received data.

---

Parâmetros expostos e otimização

Em um nó Trigger, Strategy ou Execution, a aba Parameters permite marcar configurações numéricas (um intervalo, um período de indicador, um limite, um tamanho de ordem…) como expostas, com uma faixa. Os parâmetros expostos são o que a aba Optimization da caixa Test pesquisa e o que um agente de otimização de IA ajusta. Veja Otimização para saber como funcionam a busca em grade e a genética.

---

AI Builder

O botão AI Builder (ícone de brilho) no cabeçalho de um agente Trading abre um chat ao lado da tela. Descreva o agente em linguagem natural e o seu modelo de IA conectado adiciona, configura e liga os nós para você — e pode escrever Agent Scripts no seu espaço de trabalho.

• O modo Ask responde perguntas sobre o grafo sem alterá-lo; o modo Build faz alterações.
• As alterações são aplicadas ao vivo, e cada resposta tem Keep / Undo.
• Você pode anexar arquivos às suas mensagens.
• Usa a mesma conexão de modelo do QuantCraft AI; o uso de tokens conta no selo de tokens do agente.

---

Agentes de IA de teste e otimização

Os agentes Test e Optimization não têm um grafo de nós. Você dá à IA um alvo — um algoritmo do IDE ou um Trading agent — mais Instructions for the AI e limites: Max iterations (uma iteração = um backtest; a IA planeja todas de antemão), Max AI rounds, Max AI tokens e Max backtest windows. Marque Allow market data tools para deixá-la usar as QuantCraft Tools (desativado por padrão). Você pode anexar arquivos às instruções.

Quando você inicia um, a IA trabalha em suas próprias janelas destacadas controladas pela IA — executando backtests e otimizações, salvando descobertas na memória — e termina com um resumo. A página do agente tem as abas Overview, Sessions, Windows e Memory, para que você acompanhe cada sessão, veja seu plano de iterações e execuções e feche janelas.

Os resultados de backtest e otimização — inclusive o resumo feito por uma IA — descrevem apenas dados históricos e não garantem resultados reais.

---

Salvando, gerenciando e monitorando

• Save remove o selo Draft e mantém uma cópia salva do grafo. Toda edição ainda é salva automaticamente em local, mas, quando você altera um agente salvo, o selo Draft volta com um botão Undo, que (após uma confirmação) devolve o grafo ao seu último salvamento.
• Na barra lateral, clique com o botão direito em um agente para Rename, Duplicate ou Delete. Duplicar clona o grafo como um novo rascunho.
• Compartilhar agentes como arquivos (aplicativo desktop): o menu ⋯ do cabeçalho tem Export…, que salva o agente como um arquivo .qca, e o menu da barra lateral tem Import… para carregar um ou mais arquivos .qca. As referências a Agent Scripts são religadas ao seu espaço de trabalho na importação.
• Durante uma execução, cada cartão de nó mostra um selo de status ao vivo — aguardando, executando, ok, falhou ou ignorado — e transmite eventos para a sua aba Output.

---

Bom saber

• Execução backtest vs forward. O Test de um agente (backtest) usa uma conta paper simulada. As execuções forward (menu Agents do gráfico, New Agent Bulk Run do AutoTrading) usam a conta de corretora conectada selecionada e podem enviar ordens reais quando essa conta é real. Os executores do QuantCloud executam apenas algoritmos do IDE — não agentes.
• O cronograma vale depois que uma execução é iniciada. O editor não inicia agentes automaticamente em segundo plano. Depois de iniciar uma execução forward / em massa / de gráfico, a cadência vem do Schedule trigger (ou da substituição pela aba Scheduler da caixa Test nos backtests).
• Limites estruturais: no máximo 2 pais por nó, sem ciclos, os nós Execution só se ligam a nós Strategy ou AI Prompt, e os filhos de um nó Execution só podem ser nós Notification.
• Dados fundamentalistas em um backtest são restritos ao Premium (o mesmo acesso a dados gratuitos das outras interfaces de dados fundamentalistas, quando habilitado).

---

Veja também

• QuantCraft AI — o nó AI Prompt e como o seu modelo é escolhido
• QuantCraft Tools — ferramentas somente leitura que os nós AI Prompt e os agentes de IA podem chamar
• AutoTrading — Agent Bulk Run e monitoramento forward local
• Screener — filtrar ações por dados fundamentalistas para usar como alvos de execuções em massa
• Modelo de conta — a conta paper, métricas, comissão / slippage
• Dados fundamentalistas — dados fundamentalistas
• Fatores Fama-French — fatores Fama-French
• Séries de indicadores — sobreposições de indicadores do gráfico