Um agente de trading com IA, mais cedo ou mais tarde, vai propor uma operacao que nao deveria fazer. Nao porque o modelo esteja quebrado — porque um modelo de linguagem pode estar confiantemente errado, e confianca nao e um controle de risco. A pergunta que realmente importa nao e "quao bom e o raciocinio do modelo", e "o que impede que uma proposta ruim se torne uma operacao ruim".
E disso que trata este artigo: gestao de risco para agentes de trading como disciplina de engenharia, nao como uma caixinha de compliance. Cobrimos a stack concreta de guardrails para agentes de trading — regras de dimensionamento de posicao agente ia, limites de posicao agente de trading no nivel de portfolio, um circuit breaker de drawdown maximo bot de trading, rate limits contra overtrading, verificacoes de sanidade pre-execucao, e kill switches — e como realmente testa-los em vez de simplesmente esperar que funcionem. Se voce ainda nao leu a visao geral da categoria, comece por O Que E Trading Agentico?; este artigo e o mergulho profundo na unica parte dessa anatomia que um prompt ruim nao consegue consertar: a camada de risco.
Verdade basica antes de continuar lendo: todo exemplo aqui roda contra o ambiente de paper trading da CoinRithm. Os agentes operam com mUSD virtual contra precos de mercado reais — nunca com dinheiro real. Nao ha teatro de avisos pre-execucao no que segue; isto e orientacao de engenharia para construir um controle, nao um aviso legal sobre como usa-lo.
TL;DR
- O principio central: guardrails vivem em codigo que roda fora do modelo, nao em instrucoes de prompt nas quais confiamos que o modelo vai seguir. Um prompt e uma sugestao; uma verificacao do lado do runner e uma rejeicao.
- Dimensionamento de posicao: limites de fracao fixa, dimensionamento escalado por volatilidade, e um teto rigido por mercado — escolha pelo menos um, idealmente dois.
- Limites de portfolio: um numero maximo de posicoes abertas, um teto de exposicao por classe de ativo, e consciencia basica de correlacao para que cinco posicoes "diferentes" nao sejam uma unica aposta escondida.
- Controles de perda: um stop-loss obrigatorio em toda entrada, um limite de perda diario/semanal, e um circuit breaker de drawdown maximo que interrompe o agente — nao apenas a operacao.
- Rate limits: um teto de operacoes por hora/dia. Overtrading e seu proprio modo de falha, independente de qualquer operacao individual parecer razoavel.
- Verificacoes de sanidade: cotacao-antes-de-escrever, verificacoes de desvio de preco, e deteccao de dados obsoletos capturam as falhas que nao parecem nada com uma "estrategia ruim" e tudo com um "input ruim".
- Teste os proprios guardrails em paper trading alimentando deliberadamente casos extremos. Um guardrail nao testado e uma esperanca, nao um controle — e o paper trading tambem nao consegue testar slippage real, liquidez real, ou estresse real.
Indice
- Por Que Guardrails Vivem no Codigo, Nao em Prompts
- A Stack de Guardrails
- Guardrails Especificos para Mercados de Previsao
- Testando Seus Guardrails em Paper Trading
- O Que o Paper Trading Nao Testa
- Como a CoinRithm Se Encaixa
- Perguntas Frequentes (FAQ)
Por Que Guardrails Vivem no Codigo, Nao em Prompts
Aqui esta o principio do qual tudo mais neste artigo decorre: um prompt bem escrito e necessario e nunca suficiente. Um prompt pode dizer a um modelo "nunca arrisque mais de 2% do saldo em uma operacao", e na maioria das vezes ele vai obedecer. Mas "na maioria das vezes" e exatamente a brecha que um guardrail existe para fechar. Um modelo pode interpretar mal seu proprio saldo em tempo real, esquecer uma instrucao anterior sob uma janela de contexto longa, ser empurrado para fora de suas regras por um input incomum ou adversarial, ou simplesmente cometer um erro aritmetico enquanto soa completamente seguro sobre o numero. Nada disso exige um modelo "ruim" — exige apenas as formas comuns e bem documentadas pelas quais qualquer modelo de linguagem pode estar confiantemente errado sobre um numero especifico em um momento especifico.
A solucao e arquitetural, nao motivacional: separar proposta de execucao. O trabalho do modelo e propor uma acao — um lado, um tamanho, um stop, uma razao. Uma segunda camada, deterministica — codigo puro, nao outra chamada a um modelo — revalida essa proposta contra limites numericos rigidos antes que qualquer coisa chegue ao mercado. Se a proposta esta dentro dos limites, ela executa. Se nao esta, e rejeitada, ponto final, sem negociacao e sem "deixa eu reconsiderar". Esta e a mesma ideia coberta no nivel de implementacao em Como Criar Seu Proprio Agente de Trading Cripto: limites que vivem no runner, nao no modelo, sobrevivem a uma alucinacao, a uma tentativa de prompt injection, ou a um erro honesto exatamente da mesma forma — por nunca serem consultados para pedir permissao em primeiro lugar.
Trate isso como o principio estrutural para tudo o que vem a seguir: todo guardrail neste artigo so e real se for aplicado por codigo que roda independentemente de o modelo concordar com ele.
A Stack de Guardrails
Uma camada de risco de nivel de producao nao e uma unica verificacao — e uma stack, porque cada camada captura um modo de falha diferente. Pular uma nao torna as outras redundantes; apenas deixa aberto aquele buraco especifico.
Regras de Dimensionamento de Posicao
A primeira linha de defesa controla quanto do saldo uma unica operacao pode tocar, e existem tres abordagens comuns, usaveis sozinhas ou combinadas:
- Dimensionamento de fracao fixa. A regra mais simples e auditavel: nunca colocar mais de uma porcentagem fixa do saldo atual em uma posicao (ex.: 5%). E facil de raciocinar e facil de verificar em uma linha de log.
- Dimensionamento escalado por volatilidade. Dimensiona de forma inversa a volatilidade recente — um ativo mais calmo recebe uma alocacao maior, um mais agitado recebe uma menor, para o mesmo risco-alvo. Isso responde melhor as condicoes, mas exige que o agente calcule ou obtenha uma estimativa de volatilidade de forma confiavel, o que e, por si so, algo a verificar (veja abaixo).
- Tetos por mercado. Um teto rigido na exposicao a qualquer simbolo ou evento individual, independente da formula de dimensionamento usada para chegar ate ali — de modo que um bug de dimensionamento em um calculo nao possa concentrar silenciosamente todo o book em um unico nome.
Os numeros especificos importam menos do que a propriedade: o limite e um numero que o codigo verifica, nao um alvo que o modelo mira. "Nunca arrisque mais de 2% por operacao" como instrucao de prompt e orientacao; a mesma regra como uma verificacao pre-execucao que rejeita a ordem e um guardrail.
Limites no Nivel de Portfolio
O dimensionamento de posicao controla uma operacao. Os limites de portfolio controlam a soma de todas as operacoes abertas:
- Maximo de posicoes simultaneas. Um numero rigido — ex.: nao mais que 3-5 posicoes abertas ao mesmo tempo — impede que um agente se espalhe em uma longa cauda de apostas pequenas e dificeis de monitorar que individualmente passam em toda verificacao de tamanho.
- Exposicao maxima por classe de ativo. Um teto na exposicao total a, digamos, um setor ou um grupo correlacionado de ativos, de modo que o agente nao consiga maximizar cinco tetos por mercado separados que sao, na pratica, a mesma operacao.
- Consciencia de correlacao. O modo de falha mais sutil aqui: cinco posicoes "diferentes" que se movem todas juntas em um drawdown nao sao cinco apostas independentes, sao uma aposta concentrada usando cinco rotulos. Mesmo uma regra grosseira — limitar a exposicao combinada a ativos marcados como correlacionados — fecha a maior parte dessa brecha sem precisar de um modelo completo de covariancia.
Controles de Perda
O dimensionamento limita quanto pode ser perdido por operacao isoladamente. Os controles de perda limitam quanto pode ser perdido no agregado antes que o agente seja forcado a parar:
- Um stop-loss obrigatorio em toda entrada. Nao opcional, nao "geralmente" — uma ordem sem stop-loss simplesmente nao deveria ser uma ordem valida que o runner vai colocar.
- Limites de perda diarios e semanais. Uma vez que as perdas realizadas em uma janela movel ultrapassam um limiar, nenhuma nova operacao abre ate que a janela reinicie ou um humano reative o agente.
- Um circuit breaker de drawdown maximo. Este e o backstop acima de todos os outros: se o drawdown acumulado (realizado mais nao realizado) ultrapassar um limiar rigido, o agente para completamente — nao apenas a proxima operacao, o loop inteiro — ate que um humano revise e reative. Este e o guardrail que existe precisamente para o cenario em que cada verificacao menor passou individualmente e o resultado agregado ainda assim e ruim.
Limites de Taxa e Frequencia
Overtrading e seu proprio modo de falha — independente de qualquer operacao individual parecer razoavel. Um modelo pode se convencer de "so mais uma operacao pequena" indefinidamente, e taxas mais slippage se acumulam contra um agente de alta frequencia mais rapido do que a maioria dos prompts contempla. Um teto concreto de operacoes por hora e por dia forca uma pausa entre decisoes independente de quao convincente soe a ultima justificativa do modelo.
Duas coisas vale a pena notar: esse teto e sobre a disciplina do proprio agente, e e separado dos rate limits do proprio venue — uma API de trading tera seus proprios orcamentos de requisicoes e taxa de escrita (expostos via headers como RateLimit-* na API de agentes da CoinRithm), e um agente bem construido deveria respeitar ambos independentemente. Atingir o rate limit do venue e um sinal de que o guardrail de frequencia esta configurado frouxo demais, nao um problema para contornar.
Verificacoes de Sanidade Antes da Execucao
Algumas das piores falhas nao parecem nada com uma estrategia ruim — parecem um input ruim sobre o qual o agente raciocinou com confianca. Tres verificacoes capturam a maioria delas antes que uma ordem seja colocada:
- Cotacao-antes-de-escrever. Busque uma cotacao fresca e nao-mutante imediatamente antes de cada operacao, e recuse executar se a cotacao nao for elegivel ou estiver obsoleta. Uma cotacao nunca muda o estado, entao nao ha custo em verificar toda vez.
- Verificacoes de desvio de preco. Se o preco sobre o qual o agente esta raciocinando difere significativamente da cotacao recem-buscada, isso e um sinal de que algo a montante esta obsoleto ou errado — rejeite e busque novamente em vez de operar sobre a discrepancia.
- Deteccao de dados obsoletos. Uma verificacao de timestamp nos dados de mercado subjacentes. Um agente raciocinando brilhantemente sobre um preco de vinte minutos atras esta raciocinando brilhantemente sobre o mundo errado.
Kill Switches e Escalonamento Humano
Todo guardrail acima e uma regra que rejeita uma acao ruim especifica. Um kill switch e diferente: e a regra que para o agente, nao apenas a operacao, e devolve o controle a um humano. As condicoes que vale a pena conectar a um kill switch: o circuit breaker de drawdown disparando, uma sequencia de falhas consecutivas do modelo ou propostas malformadas, uma sequencia de propostas rejeitadas consecutivas (um sinal de que o modelo saiu de sincronia com seus proprios limites), ou pressao sustentada de rate limit vinda do venue.
A pergunta honesta de design nao e "o agente algum dia vai atingir um desses" — ele vai, eventualmente — e "quando isso acontecer, o sistema falha para uma parada, ou falha para um dar de ombros?" Um guardrail que registra uma rejeicao e deixa o loop continuar sem mudanca nao escalou nada de fato. O agente deveria parar, e um humano deveria ter que reativa-lo explicitamente — essa friccao e o objetivo, nao um bug do fluxo de trabalho.
Guardrails Especificos para Mercados de Previsao
Posicoes em mercados de previsao precisam de tudo acima mais tres verificacoes especificas de como esses mercados realmente se resolvem — cobertas com mais profundidade em Como Agentes de IA Operam Mercados de Previsao:
- Consciencia da data de resolucao. Um mercado proximo de sua data de resolucao se comporta de forma diferente de um com semanas de prazo — o pouco tempo restante muda o quanto um movimento de preco realmente significa. Um guardrail que trata todo mercado aberto igualmente vai dimensionar da mesma forma em um mercado que, na pratica, ja esta decidido.
- Verificacoes de elegibilidade e estado de liquidacao. Nem todo evento listado e realmente negociavel em um sentido significativo — alguns estao em um estado disputado ou intermediario entre o fechamento e a liquidacao final. Um guardrail deveria verificar o estado real de elegibilidade do mercado antes de dimensionar nele, nao apenas se ele aparece em uma lista de eventos "abertos".
- Limites de tamanho para books rasos. O tamanho de uma posicao em mercado de previsao deveria diminuir, com forca, quando o book por tras dela e raso. Um preco cotado contra muito pouco volume real pode ser movido pela propria posicao — um teto de tamanho que ignora a profundidade de liquidez pode transformar uma pequena posicao de paper naquilo que define o novo preco.
Testando Seus Guardrails em Paper Trading
Um guardrail que voce so leu, nunca acionou, e uma esperanca — nao um controle. A unica forma de saber se um limite realmente rejeita o que deveria rejeitar e tentar deliberadamente quebra-lo.
Concretamente, isso significa alimentar o agente (ou sua camada de validacao diretamente) com os casos extremos que ele deveria capturar: uma proposta ligeiramente acima do teto de tamanho, uma muito acima, uma proposta sem stop-loss anexado, uma rajada de propostas feita para testar o rate limit, uma cotacao intencionalmente obsoleta, uma sequencia de perdas feita para se aproximar do limiar de drawdown. Confirme que a rejeicao acontece, confirme que acontece pela razao correta declarada no log, e confirme que o kill switch realmente interrompe o loop em vez de apenas registrar que deveria te-lo feito.
O paper trading e o lugar certo para fazer isso precisamente porque uma proposta rejeitada nao custa nada aqui. Rode os mesmos casos adversariais que te deixariam nervoso em um ambiente ao vivo, de proposito, ate que os limites tenham sido de fato exercitados — nao apenas declarados — antes de confia-los a uma execucao autonoma real.
O Que o Paper Trading Nao Testa
Nada do acima deveria ser lido como "se passa no paper trading, os guardrails estao provados". O paper trading e honesto sobre o que verifica e igualmente honesto sobre o que nao consegue:
- Slippage real. Execucoes simuladas preenchem no preco cotado ou perto dele; uma ordem real em um livro de ofertas real e raso pode mover o preco contra o qual esta tentando preencher — algo que um teste de guardrail em paper nunca vai revelar.
- Liquidez real. Um venue de paper nao fica sem contrapartes. Mercados reais podem, especialmente os rasos contra os quais um guardrail e especificamente pensado para proteger.
- Estresse real. Os momentos em que guardrails mais importam — um mercado se movendo rapido, um feed de dados atrasando, varias condicoes de risco disparando ao mesmo tempo — sao exatamente os momentos mais dificeis de ensaiar totalmente em um simulador. Testar em paper prova que a logica esta conectada corretamente; nao prova que o sistema se comporta da mesma forma sob pressao de tempo real e falhas reais de infraestrutura.
Enquadramento honesto: testar em paper te diz que o guardrail dispara. Nao te diz que o guardrail e suficiente para capital real. Sao afirmacoes diferentes, e confundi-las e exatamente o tipo de excesso de confianca que este artigo inteiro esta tentando prevenir por engenharia.
Como a CoinRithm Se Encaixa
A superficie de trading agentico da CoinRithm incorpora o principio de "limites no runner, nao no modelo" como o padrao, nao como um adicional opcional. No runner de self-host coinrithm-agent (coberto passo a passo em Como Criar Seu Proprio Agente de Trading Cripto), toda acao proposta e revalidada contra limites declarados — alavancagem, tamanho por operacao, margem aberta agregada, maximo de posicoes, escritas por dia, escritas por ciclo, um limite de perda diario, e um stop-loss obrigatorio ciente do lado — antes que possa executar. Dry-run e o estado padrao; escritas exigem uma flag --live explicita. Uma cotacao e buscada e verificada quanto a elegibilidade imediatamente antes de cada operacao. Um kill switch desativa o agente em caso de drawdown, falhas repetidas do modelo, ou ciclos rejeitados repetidos.
Tudo isso roda contra um unico saldo de paper compartilhado entre spot, futuros, e mercados de previsao — mUSD simulado, nunca fundos reais — o mesmo ambiente descrito em o que e trading agentico. Uma vez que seus limites estao conectados e testados, a mesma chave e o mesmo conjunto de guardrails funcionam seja voce operando manualmente, atraves do Claude/MCP, ou atraves do runner autonomo. Agentes de trading que optam pelo Agent Arena publico sao classificados por PnL de paper realizado, entao um conjunto de guardrails que realmente se sustenta aparece como consistencia ao longo do tempo — nao apenas como uma afirmacao em um README. Para o design de estrategia depois que sua camada de risco estiver pronta, veja Estrategias para Agentes de Trading IA; para testar qualquer coisa disso voce mesmo primeiro como humano, comece com paper trading.
Perguntas Frequentes (FAQ)
Por que agentes de trading precisam de guardrails fora do proprio modelo?
Porque um LLM pode estar confiantemente errado — interpretando mal seu proprio saldo, se desviando de uma instrucao anterior, ou simplesmente cometendo um erro de dimensionamento enquanto soa seguro. Uma regra no nivel de prompt e orientacao que o modelo pode nao seguir corretamente; um guardrail no nivel de codigo revalida toda proposta contra limites numericos rigidos e rejeita qualquer coisa que os exceda, independente de como o modelo justificou.
O que e um circuit breaker de drawdown maximo e como funciona?
E o guardrail de backstop: uma vez que o drawdown acumulado — realizado mais nao realizado — ultrapassa um limiar preestabelecido, o agente para completamente, nao apenas a proxima operacao. Ele existe para o caso em que cada verificacao menor (tamanho de posicao, stop por operacao) passou individualmente e o resultado agregado ainda assim e ruim. Reativar o agente apos disparar deveria exigir uma decisao humana explicita, nao um reset automatico.
Quanto de um saldo de paper uma operacao deveria arriscar?
Nao ha um numero universal, mas uma disciplina inicial comum e uma pequena fracao fixa por operacao (frequentemente citada em torno de 1-2% arriscado, com um teto ligeiramente maior no tamanho total da posicao), aplicada como uma verificacao rigida em vez de uma meta. Os numeros exatos importam menos do que a propriedade de que uma segunda camada deterministica os verifica antes da execucao — veja a secao de dimensionamento de posicao acima para as abordagens de fracao fixa versus escalada por volatilidade.
O que e overtrading e como rate limits o previnem?
Overtrading e colocar mais operacoes do que a vantagem de uma estrategia — se houver alguma — consegue sustentar, muitas vezes porque um modelo se convence repetidamente de "so mais uma operacao pequena". Um teto rigido de operacoes por hora ou por dia forca uma pausa independente de quao convincente soe a ultima justificativa, e e separado dos proprios rate limits do venue, que um agente tambem deveria respeitar.
Quais guardrails sao especificos de mercados de previsao?
Tres, alem da stack geral: consciencia da data de resolucao (um mercado perto do fechamento se comporta de forma diferente de um com semanas pela frente), verificacoes de elegibilidade e estado de liquidacao (alguns eventos listados estao disputados ou ja efetivamente decididos), e limites de tamanho para books rasos (um preco cotado contra muito pouco volume real pode ser movido pela propria posicao). Veja Como Agentes de IA Operam Mercados de Previsao para o panorama completo.
O paper trading testa completamente meus guardrails antes de eu confia-los a uma execucao ao vivo?
Ele testa se a logica dispara corretamente — alimentando deliberadamente casos extremos (tamanhos acima do teto, stops faltando, cotacoes obsoletas, sequencias de perdas) e confirmando que a rejeicao e o kill switch se comportam como projetados. Ele nao testa slippage real, liquidez real, ou estresse real de infraestrutura, todos ausentes por design de um simulador. Trate um guardrail verificado em paper como provado quanto a disparar corretamente, nao como provado quanto a ser suficiente para capital real.
Continue lendo: Como Usar Agentes de IA para Paper Trading Cripto — o guia pratico passo a passo para conectar um agente e colocar esses guardrails para funcionar.
Aviso legal: Este artigo e apenas para fins educacionais e informativos e nao constitui aconselhamento financeiro ou de investimento. Todo o trading descrito aqui usa USD ficticio simulado (mUSD) na CoinRithm; nenhum dinheiro real, carteira, ou conta de exchange esta envolvido em nenhuma etapa. Nada neste artigo prediz ou garante o desempenho de qualquer agente, e os resultados — de paper ou de outra forma — nao devem ser tratados como uma previsao de resultados futuros.
