Guia de Configurações da IA
Entenda cada parametro e como ele afeta as decisões de trading da sua IA.
Configs IA e um recurso Pro. Usuarios Free operam com defaults do sistema somente no Fast Path de replay.
Como Funciona
Cada usuario Pro tem sua propria configuração de IA, carregada como snapshot imutavel ao iniciar uma sessão no playground. Mudanças feitas durante uma sessão so entram em vigor na proxima.
A config sobrescreve os defaults do sistema em 5 areas: Agentes (indicadores tecnicos e consenso), Risco (limites de posição e circuit breakers), Grounding (validação de qualidade de dados), Confiança (pipeline de força do sinal), e Evolução (ciclo de vida das skills).
Limites de segurança impedem valores extremos. Por exemplo, voce nao pode definir max_position_pct acima de 50% ou o threshold de consenso abaixo de 50%. Esses limites hard protegem contra misconfiguração catastrofica.
Aba Agentes
Agente Tecnico
| Parametro | Padrão | Faixa | O que faz |
|---|---|---|---|
| rsi_oversold | 30 | 10–45 | Nivel de RSI abaixo do qual um ativo e considerado sobrevendido (sinal potencial de compra). Menor = menos sinais de compra, so quedas profundas. Maior = sinais de compra mais frequentes. |
| rsi_overbought | 70 | 55–90 | Nivel de RSI acima do qual um ativo e considerado sobrecomprado (sinal potencial de venda). Menor = vende mais cedo. Maior = segura mais antes de vender. |
| rsi_period | 14 | 5–50 | Numero de candles usados para calcular RSI. Menor = mais reativo, mais ruido. Maior = mais suave, mais lento para reagir. |
| adx_trend_threshold | 25 | 15–40 | Valor minimo de ADX para considerar o mercado em tendencia. Menor = detecta tendencias mais fracas. Maior = so tendencias fortes geram sinais. |
| adx_period | 14 | 5–50 | Numero de candles para calculo do ADX. Menor = reage mais rapido a mudanças de tendencia. Maior = confirma tendencias mais fortes. |
| macd_fast / slow / signal | 12/26/9 | 3–60 | Periodos das EMAs fast/slow/signal do MACD. Fast/slow menores = mais sensivel a movimentos de curto prazo. Maiores = filtra ruido, captura movimentos maiores. |
| bb_period / bb_std_dev | 20 / 2.0 | 5–50 / 1–4 | Periodo e desvio padrao das Bandas de Bollinger. Bandas mais largas (std maior) = menos sinais de rompimento. Mais estreitas = mais sinais mas mais falsos positivos. |
Motor de Consenso
| Parametro | Padrão | O que faz |
|---|---|---|
| threshold | 0.66 | Concordancia minima ponderada entre agentes para executar um trade. Maior = precisa de concordancia mais forte (menos trades, mais seletivo). Menor = opera com consenso mais fraco. |
| high_confidence_override | 0.85 | Se qualquer agente individual tiver confiança acima deste nivel, ele pode sobrescrever o consenso e forçar um trade. Maior = mais dificil de sobrescrever. |
| high_confidence_single | 0.75 | Quando somente um agente tem sinal, esta e a confiança minima necessaria para agir sozinho (sem precisar que outros agentes concordem). |
| low_confidence_cutoff | 0.50 | Sinais abaixo deste nivel de confiança sao ignorados completamente — nem contam na votação de consenso. |
Meta Agent e Staleness
Staleness do score (segundos): Apos tantos segundos sem atualização, o score de um agente e considerado obsoleto e descontado no consenso. Menor = requisito de frescor mais rigoroso.
Max registros shadow: Numero maximo de registros de comparação do modo shadow. Maior = mais dados historicos para analise Deep Path vs Fast Path, porem mais uso de memoria.
Aba Risco
Parametros de risco definem limites hard que nenhum sinal pode ultrapassar. São sua rede de segurança contra perdas catastroficas.
| Parametro | Padrão | O que faz |
|---|---|---|
| max_position_pct | 10% | Porcentagem maxima do portfolio que pode ser alocada em um unico trade. Menor = mais diversificado, menos risco por trade. |
| max_daily_loss | 5% | Se as perdas realizadas no dia excederem esta porcentagem, TODO o trading e parado pelo resto do dia. Seu freio de emergencia. |
| max_trades_per_day | 20 | Numero maximo de trades permitidos por dia. Previne overtrading em mercados volateis. |
| min_confidence | 0.50 | Confiança minima do sinal necessaria para abrir um trade. Maior = somente trades de alta convicção passam. |
| min_consensus | 0.66 | Score minimo de consenso multi-agente necessario. Funciona com o threshold de consenso dos Agentes mas esta e a aplicação na camada de risco. |
| max_drawdown_pct | 15% | Se o drawdown do portfolio a partir do pico exceder isto, o circuit breaker para TODO o trading. Requer reset manual ou por tempo. |
Aba Grounding
Grounding mede quão confiaveis sao seus dados de mercado. Dados obsoletos, inconsistentes ou esparsos sao penalizados. Se o score de grounding for muito baixo, sinais sao bloqueados.
| Parametro | Padrão | O que faz |
|---|---|---|
| block_threshold | 0.60 | Score de grounding abaixo disto = sinal BLOQUEADO (nunca chega ao motor de trading). Menor = mais permissivo, aceita dados de menor qualidade. |
| warn_threshold | 0.75 | Score de grounding abaixo disto (mas acima do block) = modo WARN: tamanho da posição reduzido em 50%. Menor = menos warnings, opera com tamanho cheio com dados de menor qualidade. |
Aba Confiança
O pipeline de confiança transforma sinais brutos de indicadores em um score normalizado (0.0 a 1.0). O CryptSwarms suporta pipelines Gaussian (padrao) e Linear.
Floor e o output minimo possivel de confiança. Ceiling e o maximo. Uma faixa mais apertada (ex: 0.50–0.65) comprime mais o output — pequenas mudanças nos indicadores nao balançam a confiança. Uma faixa mais ampla permite mais diferenciação entre sinais fortes e fracos.
Aba Evolução
Controla como a IA evolui skills ao longo do tempo. O Deep Path (LLM) analisa performance e sugere mutações. Estes parametros limitam ate onde a evolução pode ir.
| Parametro | Padrão | O que faz |
|---|---|---|
| max_generation | 5 | Numero maximo de gerações evolutivas que uma skill pode passar. Maior = permite mais iterações de melhoria. Menor = preserva a estrutura original da skill. |
| monitor_min_trades | 10 | Numero minimo de trades fechados antes do monitor de saude avaliar uma skill. Maior = mais dados antes de julgar (mais preciso mas feedback mais lento). Menor = feedback mais rapido mas conclusões potencialmente prematuras. |
Presets
Presets aplicam um conjunto curado de mudanças de parametros em um clique. Eles so modificam valores especificos — todo o resto permanece na sua config atual.
Conservador
RSI mais aberto (25/75), consenso mais alto (0.75), posições menores (5%), perda diaria mais apertada (3%). Menos trades, mais convicção necessaria. Melhor para traders cautelosos ou mercados volateis.
Equilibrado
Defaults do sistema. RSI 30/70, consenso 0.66, 10% max posição, 5% perda diaria. Um bom ponto de partida para a maioria das condições de mercado.
Agressivo
RSI mais apertado (35/65), consenso mais baixo (0.55), posições maiores (15%), tolerancia maior a perda diaria (8%). Mais trades, aceita sinais mais fracos. Maior risco, maior potencial de retorno.
Scalper
RSI muito aberto (20/80), MACD rapido (8/17/5), mais trades por dia (50), perda menor por trade (1%). Projetado para estrategias de alta frequencia e curto prazo.