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âmetrosoptimizeou 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.
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.
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.
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-rangeaplica-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.