QuantCraft AI

O QuantCraft inclui um assistente de IA integrado na barra lateral direita do IDE (Layout do espaço de trabalho) — um painel de chat que ajuda você a escrever e editar Python de estratégias de trading com conhecimento do seu espaço de trabalho. Ele enxerga o arquivo aberto no editor, qualquer arquivo que você mencionar com @ e os esboços dos seus outros arquivos abertos, de modo que as respostas e edições têm contexto. Funciona como um agente de programação dentro do IDE: pode criar novos arquivos ou editar os existentes para você em um único turno de chat.

Para usá-lo, abra a barra lateral direita e mude para a aba QuantCraft AI. O modelo que você conecta é válido para todo o aplicativo — a mesma conexão alimenta este chat, os nós AI Prompt e o AI Builder em Agentes, e os agentes de IA de Test / Optimization. Use o editor Python e Executando código para validar qualquer alteração de estratégia sugerida com Test / Run.

Também há um painel Documentation na mesma barra lateral — uma referência estática da API de estratégias (ciclo de vida, OHLCV, indicadores, dados fundamentalistas, fatores, entradas, conta), além das páginas Agent Scripts e Screener Script. Veja Referência.

---

Modos do assistente

Você pode alternar o modo e o Auto-continue no compositor, ou em Assistant mode na caixa API Providers.

---

Conectando um modelo

O QuantCraft AI funciona com vários provedores. Alguns são traga sua própria chave (cobrados na sua conta no provedor); o QuantCraft Premium e as opções hospedadas funcionam com acesso gerenciado. Abra AI → API Providers no menu superior (a caixa se chama AI API Providers; o link de conexão do chat também a abre), escolha um provedor e preencha seus campos.

GitHub Copilot e Cursor podem aparecer na lista, mas os turnos de chat ainda não estão conectados (maquetes de interface) — e os recursos de IA de Agentes também os rejeitam. Use Anthropic, DeepSeek (chave própria ou hospedado), OpenCode, QuantCraft Premium ou Custom LLM.

Cole a chave (quando exigida), escolha o modelo e clique em Save.

Custom LLM

Use Custom LLM para conectar o seu próprio modelo, ou um modelo auto-hospedado, compatível com OpenAI.

A conexão é considerada pronta assim que a URL é definida. No aplicativo desktop, o HTTP para os provedores passa pelo plugin HTTP do Tauri; endpoints localhost / 127.0.0.1 são permitidos. Hosts remotos arbitrários de Custom LLM não são configuráveis pelo usuário por meio de uma interface de lista de permissões — prefira um servidor local compatível com OpenAI ou um provedor já suportado acima.

Onde as chaves ficam: os valores de "traga sua própria chave" são armazenados somente na sua máquina (no chaveiro do sistema operacional no aplicativo desktop, ou no armazenamento local deste navegador). Nunca são enviados ao QuantCraft e só são transmitidos ao provedor que você selecionou. Se você apagar os dados do navegador ou mudar de computador, precisará inserir a chave novamente.

Para onde as requisições vão: com um provedor de "traga sua própria chave", o QuantCraft AI chama o provedor diretamente da sua máquina usando a sua chave. O aplicativo desktop (Tauri) usa uma ponte HTTP para que as requisições não sejam bloqueadas pelo CORS do navegador — executar o QuantCraft AI na versão para navegador pode exibir uma mensagem "Request failed" relacionada a CORS; use a versão desktop para a melhor experiência.

Escolhendo um modelo

Cada provedor tem um menu suspenso de modelos ao lado do campo da chave. O selo de conexão na parte inferior do chat mostra o provedor ativo e o nome curto do modelo (por exemplo Anthropic (Claude) · Claude Sonnet 4.6). Vários provedores podem ser salvos — o selo mostra o usado mais recentemente com o sufixo +N quando há mais de uma chave.

Para a Anthropic, o menu lista Claude Sonnet 4.6, Claude Opus 4.8, Claude Opus 4.7, Claude Haiku 4.5 e outras variantes atuais de Opus / Sonnet. Escolha o que a sua conta tem disponível. Se você tentar enviar uma mensagem pelo caminho da Anthropic sem uma chave salva, o assistente responde com um lembrete para adicionar uma.

---

Usando o chat

• Digite no compositor e pressione Enter para enviar, Shift+Enter para uma nova linha.
• Digite @ para abrir um menu de menção de arquivos e trazer outro arquivo do espaço de trabalho para o contexto.
• As respostas são renderizadas em markdown com blocos de código.
• Stop interrompe uma resposta em andamento.

Compositor e anexos

• O botão Attach files abre um seletor de arquivos. Você também pode arrastar e soltar arquivos na área de entrada, ou colar um arquivo/imagem da área de transferência.
• Uma linha de chips de anexos acima da caixa de texto mostra cada arquivo na fila. Cada chip tem o nome (e uma miniatura para imagens) e um × para removê-lo.
• Qualquer tipo de arquivo é aceito. Os arquivos de imagem mostram uma pequena miniatura embutida no fluxo de mensagens após o envio.
• Os anexos pertencem à mensagem com a qual são enviados — aparecem junto dessa mensagem no histórico do chat.
• No chat do IDE, os anexos são exibidos, mas seu conteúdo não é enviado ao modelo. Para compartilhar o conteúdo de um arquivo do espaço de trabalho, mencione-o com @.

Enquanto o assistente gera uma resposta, o compositor fica desativado com o texto "Please wait…" e uma pequena linha de status aparece na lista de mensagens (por exemplo Building API messages…, Streaming reply… 1,234 characters, Syncing to workspace folder on disk…).

---

Sessões de chat

O QuantCraft AI mantém um histórico de sessões de chat. Cada sessão é uma conversa própria, com suas mensagens e anexos. A barra no topo do painel de chat tem:

• New chat — inicia uma sessão nova e vazia. Fica desativado enquanto o assistente trabalha, enquanto há uma edição de arquivo pendente, ou se o seu chat atual já estiver vazio.
• Chats — um menu suspenso listando todas as sessões salvas, das mais novas às mais antigas. Cada entrada mostra seu título (derivado automaticamente da primeira mensagem do usuário) e a hora da última atualização. Clique em uma linha para alternar, ou no ícone de lixeira para excluí-la.

As sessões são persistidas automaticamente (na configuração local no aplicativo desktop, caso contrário no armazenamento local do navegador) e sobrevivem a recarregamentos e reinicializações. Alternar entre chats e criar novos fica bloqueado enquanto uma resposta está em streaming ou enquanto há uma barra Accept/Undo não resolvida — conclua ou desfaça a alteração primeiro.

---

O que o assistente consegue ver

Cada vez que você envia uma mensagem, o QuantCraft AI monta a requisição com:

1. A documentação para desenvolvedores do QuantCraft incluída (assim ele conhece o ciclo de vida, a API de conta, os módulos OHLCV / dados fundamentalistas, as séries de indicadores etc.).
2. Um snapshot recente do espaço de trabalho — o caminho da pasta de trabalho vinculada, o arquivo aberto no editor e a lista de abas e pastas abertas.
3. Os turnos anteriores da sessão de chat ativa (suas mensagens e as respostas dele).
4. Sua nova mensagem mais os anexos.

É por isso que escolher uma pasta de trabalho na barra lateral Files é importante — sem uma, o assistente ainda responde perguntas, mas não consegue gravar arquivos em disco e avisará isso.

---

Edições de arquivos pelo assistente

No modo Agent, o assistente pode retornar uma ou mais ações sobre arquivos em uma única resposta: criar um arquivo novo, editar o arquivo atual do editor ou editar um arquivo específico do espaço de trabalho. Quando isso acontece:

• Os arquivos novos aparecem como uma nova aba na pasta vinculada; os existentes são atualizados no lugar em sua aba.
• O editor salta para o local alterado e destaca as linhas alteradas para que você revise o que o assistente fez.
• Uma barra de pendências aparece na parte inferior do chat com um breve resumo e dois botões:
  • Accept — mantém a alteração. O destaque é removido e você pode continuar conversando.
  • Undo — reverte a alteração. Em uma edição, o conteúdo anterior do arquivo é restaurado. Em um arquivo novo, a nova aba é removida.
• Até você escolher Accept ou Undo, o chat fica congelado — você não pode trocar de sessão nem enviar outra mensagem. É intencional: garante que você revise ativamente cada alteração.
• Em respostas com vários arquivos, a barra informa quantas alterações foram aplicadas. O botão Undo reverte apenas a última etapa, então revise os destaques aba por aba se necessário.

Estratégias com vários arquivos

No modo Agent o assistente pode dividir uma estratégia em módulos auxiliares em pastas (indicators/, risk/, …) e importá-los no arquivo raiz do algoritmo. Ele mantém as funções do ciclo de vida (on_init, on_bar, …) no arquivo raiz e usa importações absolutas a partir da raiz do espaço de trabalho, por exemplo from indicators.momentum import calc_rsi, sem arquivos __init__.py.

• O assistente vê por inteiro os arquivos que o arquivo ativo importa e os que o importam. Dos seus outros arquivos, ele só vê esboços — para que ele edite um deles, mencione-o com @.
• As alterações de arquivos de cada resposta são verificadas antes de qualquer uma ser aplicada. Se uma etapa não puder ser executada com segurança (por exemplo, criaria um arquivo que já existe ou reescreveria um arquivo que ele só viu em esboço), nenhuma etapa é aplicada e a resposta explica o motivo.
• Depois que as alterações são aplicadas, as importações do espaço de trabalho que falhariam em tempo de execução (por exemplo, um auxiliar renomeado sem atualizar os arquivos que o importam) são listadas abaixo da resposta. O agente as corrige no próximo turno.

Sincronizando com o disco

Os arquivos também são sincronizados com a pasta de trabalho vinculada no disco (no aplicativo desktop). Na versão para navegador, os arquivos continuam sendo atualizados no editor e nas abas, mas não são espelhados no disco — a resposta avisa isso para que você saiba usar a versão desktop para a integração completa de arquivos.

---

QuantCraft Tools integradas

Um conjunto próprio de ferramentas de mercado somente leitura — OHLCV, indicadores, dados fundamentalistas, screener, conta e posições — vem ativado por padrão e pode ser chamado direto do chat (e dos nós AI Prompt dos agentes). Gerencie-o em AI → MCPs (a linha QuantCraft Tools (built-in) no topo). Veja QuantCraft Tools.

---

Ferramentas do Screener

Quando o recurso AI Screener está ativado, o chat também pode operar o Screener para você: abrir uma janela do Screener, montar ou carregar um filtro, executá-lo e ler os resultados. A janela mostra "The AI is using this window" e bloqueia seus controles enquanto a IA trabalha. Nos modos Chat e Plan a IA só recebe o subconjunto somente leitura (pode ver filtros e resultados, mas não alterá-los); o modo Agent recebe o conjunto completo. Veja Screener.

---

Ferramentas

As ferramentas são serviços de dados externos que o modelo do chat pode chamar ao responder. Adicione-as em AI → AI Tools.

• A ferramenta disponível é LLMQuant Data — ative-a com a caixa Enable for chat e cole uma API key (há um link "Get a key").
• Depois de ativada, o assistente pode buscar dados ao vivo durante a conversa em categorias como wiki e artigos de pesquisa, preços de ações e criptomoedas, consulta de ETFs e suas carteiras, indicadores macro, arquivamentos na SEC e posições 13F, e dados de mercados de previsão.

As ferramentas só se anexam em provedores de chat operacionais (Anthropic, DeepSeek, OpenCode, Premium, Custom LLM). Copilot / Cursor não estão implementados para o chat, então as ferramentas nunca são executadas com essas seleções.

---

Servidores MCP

Os servidores MCP (Model Context Protocol) expõem suas próprias ferramentas ao assistente. Adicione-os e gerencie-os em AI → MCPs. A lista começa com a linha integrada QuantCraft Tools (built-in); cada servidor salvo tem uma chave Enabled for chat além de Edit / Remove, e as ferramentas dos servidores ativados ficam disponíveis no chat.

Para adicionar um, clique em Add server e escolha um Transport:

Dê um Name ao servidor, use Test connection para verificá-lo (ele informa quantas ferramentas o servidor expõe), depois Apply para adicioná-lo à lista e Save para persistir.

---

Nós AI Prompt em Agentes

Dentro de um Agente você pode adicionar um nó AI Prompt — a contraparte de IA de um nó Strategy.

• Você escreve um único prompt de texto livre fazendo uma pergunta de sim/não, por exemplo "Dada a ação recente do preço e os dados fundamentalistas, esta é uma configuração altista?" Não há regras estruturadas.
• Uma seção Data sent to the AI mostra chips com os dados de entrada que o modelo recebe (janela OHLCV, dados fundamentalistas etc.). Vincule um pai Data, ou o nó avisa que a IA não tem entradas.
• A resposta da IA é forçada para true / false, e esse resultado condiciona os nós filhos pela porta de entrada — exatamente como o resultado de um Strategy.
• O modelo também pode chamar as QuantCraft Tools somente leitura (OHLCV, indicadores, dados fundamentalistas, screener, conta, posições) restritas à execução.

Qual modelo o executa depende da sua conexão ativa:

• QuantCraft Premium — a chamada é executada no servidor com o acesso atribuído a você. Aqui só funciona uma concessão de Claude; uma de DeepSeek interrompe a execução com "not supported for AI Prompt nodes yet".
• Traga sua própria chave (Anthropic, OpenCode ou Custom LLM) — a chamada é executada a partir do aplicativo com a sua própria chave, que nunca é enviada ao servidor.

O DeepSeek — com chave própria ou hospedado — ainda não funciona em nós AI Prompt.

O uso de tokens dos nós AI Prompt do Agent Test e do AI Builder é contabilizado por agente e exibido como um selo no cabeçalho do editor: Tokens · This month: … · Lifetime: … (o valor mensal é zerado a cada mês civil).

---

Dicas

• Vincule primeiro uma pasta de trabalho. Na barra lateral Files, escolha a pasta do seu projeto. Sem uma, o assistente responde perguntas, mas não pode criar nem editar arquivos em disco.
• Seja explícito com os caminhos de arquivos. Ao pedir uma edição, mencione o título da aba ou um caminho como utils/foo.py. O assistente entende ambos.
• Use o Undo à vontade. É mais seguro deixar o assistente tentar uma alteração com vários arquivos e desfazer do que microgerenciar cada etapa — desfazer restaura o buffer do editor instantaneamente.
• Troque de modelo conforme a tarefa. Use um modelo Claude mais rápido para edições de rotina e um mais forte (Opus) para grandes refatorações ou para o design de estratégias.
• Mantenha suas chaves seguras. Os valores de "traga sua própria chave" ficam apenas nesta máquina. Trate-os como senhas — não os cole em nenhum lugar fora da caixa AI API Providers.