Ir para o conteúdo

Fluxos de trabalho de IA com cTrader CLI

Este artigo explica como utilizar um assistente de IA com o cTrader CLI quando sabe o que pretende alcançar, mas não conhece a sintaxe exata. Descreva a tarefa em linguagem natural e o assistente cria um comando ou script para rever antes de executar.

Nota

Para que o assistente de IA crie comandos corretos, indique-lhe o repositório GitHub do cTrader CLI, para que possa consultar a referência completa dos comandos antes de preparar scripts.

Como os assistentes de IA podem ajudar

Um assistente de IA é útil com o cTrader CLI quando consegue descrever o objetivo, mas não conhece o comando necessário. O assistente pode ajudar a:

  • Transformar um objetivo expresso em linguagem natural numa proposta de comando do cTrader CLI.
  • Explicar um comando, opção ou resultado que desconhece.
  • Sugerir a causa provável de uma mensagem de erro e uma solução.
  • Rever um ficheiro .cbotset, um ficheiro de parâmetros optimize ou uma configuração de testes de verificação.
  • Preparar um script reutilizável a partir de uma sequência de comandos que já executa manualmente.
  • Utilizar skills para gerar comandos com maior fiabilidade.

Comandos e prompts

É importante distinguir claramente duas coisas.

  • Um comando é o texto que introduz num terminal, como ctrader-cli candles --account=<account-id> --symbol=EURUSD --period=h1 --count=200.
  • Um prompt é o texto que envia a um assistente de IA para descrever o que pretende. O assistente responde com um comando que deverá rever antes de executar.

Nota

Os prompts deste artigo destinam-se a ser copiados para um assistente de IA. Os comandos apresentados na documentação de referência da CLI destinam-se a ser executados num terminal.

Escrever prompts seguros

Um prompt funciona melhor quando fornece contexto suficiente e define limites claros para o assistente. Inclua o seguinte:

  • O objetivo, expresso de forma clara.
  • O contexto relevante, como o sistema operativo e os grupos de comandos que prevê utilizar.
  • Uma instrução para não inventar comandos nem opções que o cTrader CLI não disponibiliza.
  • Uma instrução para utilizar a sintaxe da versão pública atual do cTrader CLI.
  • Um pedido para explicitar todos os pressupostos.
  • Um pedido para assinalar informações em falta antes de prosseguir.
  • Um pedido para apresentar uma sequência de passos segura e fácil de rever, em vez de um único comando combinado.
  • Marcadores de posição para caminhos, números de conta e símbolos, para não partilhar credenciais reais.

Prompts gerais

Os exemplos seguintes mostram como utilizar a IA com o cTrader CLI.

Explicar um comando encontrado

Peça ao assistente para explicar um comando linha a linha, identificar opções potencialmente arriscadas e assinalar elementos que pareçam inventados. Depois, encaminhe-o para as entradas correspondentes, onde poderá consultar a lista completa de opções.

Explain what this cTrader CLI command does, option by option, and describe any
effect it would have on a trading account:

<paste the command here>

If any option looks incorrect or risky, say so. Do not assume options that are
not shown.

Diagnosticar um erro

Envie ao assistente o comando, a mensagem de erro e o contexto para que sugira a causa mais provável e uma solução segura. Se necessário, utilize o procedimento de resolução de problemas como alternativa.

I ran this cTrader CLI command:

<paste the command, with credentials removed>

It returned this error:

<paste the error output>

Suggest the most likely cause and a safe way to fix it. List the checks I should
make first. Do not invent commands or options that cTrader CLI does not provide,
and state your assumptions.

Preparar um script reutilizável

Transforme uma sequência de comandos que já executa manualmente num script que pare ao primeiro erro e não guarde credenciais no ficheiro, utilizando os grupos de comandos habituais.

I run these cTrader CLI commands in order by hand:

<list the commands, with credentials removed>

Draft a script for <operating system> that runs them in sequence and stops if a
command fails. Keep credentials in placeholders or environment variables, not
in the script. Add a comment above each command explaining what it does, and
add a note reminding me to review the script before running it on a live
account.

Prompts de negociação

Os prompts seguintes destinam-se a cenários concretos de negociação.

Nota

Reveja qualquer comando ou script gerado por IA antes de o executar:

  • Confirme que cada comando e opção consta da documentação de referência da CLI.
  • Verifique se os números de conta, símbolos, volumes e preços estão corretos.
  • Execute primeiro comandos apenas de leitura para confirmar a configuração.
  • Teste os comandos de negociação numa conta demo antes de os utilizar numa conta real.

Modificar ou cancelar uma ordem pendente

Peça ao assistente para alterar o preço, o stop loss e o take profit de uma ordem limite pendente ou, em alternativa, cancelar a ordem, utilizando os comandos de ordens.

Write a cTrader CLI command that changes the price of pending order <order-id>
on account <account-id> to <new-price>, with stop-loss <price> and take-profit
<price>. Tell me how to cancel the same order instead.

i

Executar um cBot a partir de um script

Forneça ao assistente o caminho do cBot e os parâmetros necessários para iniciar uma instância através do comando run.

Write a cTrader CLI command that runs <path-to-algo-file> on account
<account-id> with symbol <symbol> and period <period>. Show me how to pass cBot
parameters on the command line and how to make the CLI exit when the cBot stops.

i

Adicionar proteção a uma posição aberta

Peça ao assistente para definir um stop loss e um take profit numa posição que não os tenha, utilizando os comandos de posições.

Position <position-id> on account <account-id> is open on <symbol> with no
stop loss or take profit. Write the cTrader CLI command that sets stop-loss
<price> and take-profit <price> on it. A position has one take-profit level,
so use one `--tp` price. Show the command, no preview output.

i

Detalhes das operações

  • Atualmente, o cTrader CLI não suporta o intervalo de mercado (market range) para ordens de mercado. A opção --limit-range aplica-se apenas a ordens stop-limit.
  • As ordens pendentes colocadas através do cTrader CLI não expiram; a data de validade (good till date) e a seleção do método de ativação do stop não estão atualmente disponíveis.
  • Atualmente, o cTrader CLI não permite definir nem alterar etiquetas e comentários de negociação, mas consegue lê-los e apresentá-los ao listar posições, ordens e histórico de negociação. Os cBots executados através do cTrader CLI podem adicionar etiquetas através do seu próprio código. Nas aplicações cTrader para Windows e Mac, ative as colunas Etiqueta e Comentário para apresentar ambos os elementos no painel Trade Watch.
  • O cTrader CLI suporta um único nível de stop loss e um único nível de take profit. O trailing stop loss, a proteção de break-even e vários níveis de take profit não estão atualmente disponíveis.

Aviso

Um assistente de IA é uma ferramenta de apoio, não uma autoridade. A responsabilidade por cada comando executado na sua conta continua a ser sua.