Documentação1.0 (latest)
PáginasFerramentas do QuantCraft · 27 / 29

QuantCraft Tools

O QuantCraft Tools é um conjunto integrado de ferramentas de mercado somente de leitura que a IA pode chamar por você — no chat do QuantCraft AI, em um nó AI Prompt de um Agente e nos agentes de IA Test / Optimization. Em vez de adivinhar preços ou copiar números para o seu prompt, o modelo busca o que precisa e raciocina sobre os dados reais.

Ele vem ativado por padrão. Gerencie-o em AI → MCPs no menu superior: QuantCraft Tools (built-in) é a primeira linha, com uma caixa Enabled for chat, ao lado de quaisquer servidores MCP personalizados que você adicionar. Essa caixa afeta somente o chat — os nós AI Prompt sempre têm as ferramentas.


O que as ferramentas fazem

FerramentaO que retorna
get_ohlcvBarras OHLCV recentes de um símbolo (até 60).
compute_indicatorO(s) valor(es) mais recente(s) de um indicador — rsi, macd, bollinger, atr, adx, vwap, supertrend e o restante do conjunto de gráficos. As linhas de saída correspondem ao gráfico (por exemplo, MACD → macd / signal / histogram).
get_fundamentalsDados financeiros da empresa — balanço, demonstração de resultados, fluxo de caixa, lucros, índices, valores por ação, avaliação e pontuações (Piotroski / Altman / Beneish) — em um ponto no tempo. O modelo pode pedir apenas os fields de que precisa. Veja Dados fundamentalistas.
run_screenerExecuta um filtro de dados fundamentalistas e retorna os símbolos correspondentes. Veja Screener.
get_accountSaldo, patrimônio, P&L realizado / não realizado.
get_positionsPosições abertas.

As seis são somente de leitura — a IA pode olhar, nunca operar. O envio de ordens continua no nó Execution do agente.


No chat do assistente

Faça uma pergunta sobre dados e o modelo chama uma ferramenta no meio da resposta — você verá um status como Calling MCP (QuantCraft Tools): get_ohlcv enquanto ela executa. Exemplos:

  • “Qual foi o último fechamento da AAPL e o RSI de 14 dias?”
  • “Filtre grandes empresas lucrativas negociadas abaixo de 15 vezes o lucro.”
  • “Quanto poder de compra eu tenho e o que estou mantendo?”

get_ohlcv, compute_indicator, get_account e get_positions usam a sua conta do Trade conectada para dados ao vivo. Sem conta conectada, informam que os dados não estão disponíveis (get_account diz “not connected”) em vez de falhar. get_fundamentals usa a sua sessão do QuantCraft conectada (o mesmo acesso que alimenta os dados fundamentalistas dos backtests); desconectado, informa “not available”.


Em um nó AI Prompt de agente

Quando um nó AI Prompt é executado, o modelo pode chamar as mesmas ferramentas — restritas àquela execução:

  • get_ohlcv / compute_indicator veem as barras da própria execução para o símbolo da execução.
  • get_fundamentals respeita a data de divulgação para a barra atual.
  • get_account / get_positions leem a conta simulada ou real da execução.

Assim, um prompt como:

“Use compute_indicator e get_fundamentals para decidir se esta é uma entrada de valor. Responda true ou false.”

…permite que o nó reúna evidências antes de responder, em vez de você pré-carregar tudo no texto do prompt.

Observações:

  • Funciona com o QuantCraft Premium (somente a concessão do Claude), uma chave Anthropic ou OpenCode conectada e endpoints Custom LLM auto-hospedados (compatíveis com OpenAI, com chamada de ferramentas). O DeepSeek — chave própria ou hospedado — não é compatível com nós AI Prompt.
  • Um teste avalia o nó a cada avaliação agendada (o intervalo de barra do Scheduler), e cada rodada de ferramenta é uma chamada ao modelo, portanto o orçamento de chamadas de IA (500 chamadas por teste) cobre também o uso de ferramentas. Reduza o intervalo de datas ou use um cronograma mais espaçado se atingi-lo. Não há configuração para alterar o orçamento nem para desligar as ferramentas de um nó.
  • O run_screener dentro de uma execução é limitado a cerca de 45 segundos por chamada (ou para quando você pressiona Stop); um resultado parcial é retornado e marcado como tal.
  • Cada chamada de ferramenta aparece na aba Output do nó com um resumo de uma linha.

Nos agentes Test / Optimization

Os agentes de IA Test e Optimization podem usar as mesmas ferramentas quando Allow market data tools está marcado nas configurações do agente (desativado por padrão). Veja Agentes.


Veja também

  • QuantCraft AI — conectar um modelo, ferramentas de IA e servidores MCP
  • Agentes — nós AI Prompt, AI Builder, agentes Test / Optimization
  • Screener — os filtros por trás do run_screener
4 min de leituraSugerir uma edição ↗
Ferramentas do QuantCraft — Documentação (1.0 (latest)) | QuantCraft