Documentação operacional · leitura aproximada de 20 minutos

Manual completo da ferramenta

Como a plataforma transforma evidências sobre eventos geopolíticos em risco marítimo e comercial, exposição do Brasil e leitura setorial — sempre separando observação, cálculo, estimativa e cenário.

01

Conceito

O que a ferramenta faz

A plataforma é um sistema de inteligência geopolítica orientado à transmissão econômica. Ela acompanha como uma tensão pode alcançar uma passagem marítima, uma rota, um fluxo comercial, uma commodity e, finalmente, dependências e setores brasileiros.

O que aconteceu?

Eventos consolidados a partir de evidências, com severidade, confiança, localização e relevância.

Como o risco se propaga?

Relações entre eventos, chokepoints, segmentos, rotas, fluxos e commodities.

Quem é mais afetado?

Exposição por rota, produto, dependência e setor, com atenção específica ao Brasil.

O que pode acontecer?

Cenários e alertas estruturados, claramente separados de fatos observados.

Princípio central

A ferramenta organiza evidência e calcula exposição. Ela apoia julgamento analítico; não substitui confirmação de fonte, decisão humana ou previsão econômica formal.

02

Fluxo do sistema

Da evidência ao impacto econômico

Cada camada recebe uma saída da anterior, aplica regras próprias e preserva rastreabilidade. Isso evita tratar uma notícia como impacto econômico ou um cenário como fato.

Fontes

GDELT · NewsAPI · ACLED · Ailin

Eventos

ingestão · agrupamento · deduplicação · confiança

GGTRI

risco geopolítico global

Camada marítima

chokepoints · segmentos · rotas · AIS

GTARI

comércio global em risco

BEI

exposição específica do Brasil

Transmissão

setores · custos · efeitos compensatórios

Motor de eventos

As fontes enviam candidatos. O motor classifica, agrupa por tipo e âncora, remove repetições, mede corroboração e só publica com confiança suficiente.

Risco e transmissão

O evento alimenta o GGTRI; chokepoints e fluxos alimentam o GTARI; dependências brasileiras transformam a exposição em BEI e leitura setorial.

03

Disciplina de evidência

Como interpretar o que aparece

Antes de interpretar qualquer número, identifique sua natureza. Um valor pode ser real enquanto sua rota é inferida; por isso uma tela pode aparecer como PARTIAL.

OBSERVED / REAL

Dado observado

Registro trazido de uma fonte identificada, com período e atualização. Não significa que toda a tela seja observada.

MODEL OUTPUT

Saída de modelo

Resultado calculado pelos motores a partir das entradas disponíveis. É análise, não observação direta.

ESTIMATED / INFERRED

Estimado ou inferido

Derivação transparente, como distância, tempo de trânsito ou rota provável, quando não existe observação direta.

SCENARIO ASSUMPTION

Premissa de cenário

Hipótese escolhida para simulação. Nunca deve ser interpretada como fato ocorrido ou previsão.

DEMO

Demonstração

Estrutura sintética usada para testar cobertura e funcionamento. Não deve sustentar decisão operacional.

PARTIAL

Cobertura parcial

Combina partes reais com partes estimadas, inferidas ou demonstrativas. Abra a linhagem antes de citar o número.

Severidade ≠ confiança

Severidade é gravidade; confiança é força do suporte. Um evento pode ser grave e ainda ter baixa confiança.

Risco ≠ impacto marginal

Um evento severo pode mover pouco o índice se outro já domina o mesmo canal. O contrafactual mede a diferença.

Exposição ≠ previsão de perda

GTARI e BEI indicam vulnerabilidade relativa. Não estimam automaticamente preços, inflação, PIB ou lucro.

Como auditar um número

Clique em valores com sublinhado pontilhado ou abra Fontes de Dados. Confirme fonte, período, atualização, metodologia e qualidade.

04

Núcleo quantitativo

GGTRI → GTARI → BEI

GGTRI

Global Geopolitical Tension & Risk Index

01

Qual é o nível de tensão geopolítica global?

Consolida eventos ativos: conflito militar, tensão política, escalada, sanções, segurança marítima, contágio e importância sistêmica.

A severidade de um evento não é sua contribuição ao índice. A contribuição também considera confiança, atualização temporal e posição relativa.

GTARI

Global Trade at Risk Index

02

Quanto o comércio monitorado está exposto?

Avalia cada fluxo por risco geopolítico, dependência de chokepoints, disrupção, substituição, custo de desvio e concentração.

Cada fluxo entra uma única vez, mesmo quando cruza vários chokepoints. Valor comercial pondera o índice; volume e valor expostos aparecem separados.

BEI

Brazil Exposure Index

03

Quanto desse risco é relevante para o Brasil?

Traduz o risco para Energia, Agricultura, Fertilizantes, Indústria e Logística, considerando dependências, rotas, commodities, fornecedores e substituição.

Mede exposição, não perda econômica prevista. Pressões negativas e efeitos compensatórios aparecem separadamente.

GTAR

Valor comercial em risco

Medida absoluta em dólares ou toneladas; diferente do GTARI normalizado.

EWS

Alerta antecipado

Observa sinais, velocidade e aceleração antes dos índices estruturais.

Momentum

Direção recente

Classifica deterioração, estabilidade ou melhora com base no histórico.

Confidence

Confiança

Resume a força das entradas e deve acompanhar a pontuação.

05

Navegação

Guia seção por seção

As áreas formam um fluxo de investigação. Cada uma responde a uma pergunta diferente.

01

Central de Inteligência Geopolítica

Abrir área

Visão executiva do sistema inteiro e principal ponto de entrada.

Pergunta respondida: O que move o risco, quais fluxos estão expostos e como isso pode chegar ao Brasil?

  • Comece pelos três índices e pelo briefing.
  • Use os drivers para filtrar a página por chokepoint.
  • Ative no mapa apenas as camadas necessárias.
  • Consulte a matriz para separar commodities e universos de cobertura.

Atenção: O mapa reúne camadas de naturezas diferentes. Confira o selo de cada bloco.

02

Inteligência de Eventos

Abrir área

Transforma evidências dispersas em eventos consolidados e rastreáveis.

Pergunta respondida: O que aconteceu, quantas fontes sustentam o evento e qual é a confiança?

  • Fontes alimentam candidatos; itens irrelevantes não avançam.
  • O agrupamento reúne relatos sobre o mesmo tipo e âncora.
  • A deduplicação evita repetir links ou manchetes equivalentes.
  • CREATED já virou evento; MERGED foi incorporado como duplicata.
  • Abra o detalhe para revisar evidências, países e chokepoints.

Atenção: Abaixo do limiar de confiança, o candidato fica pendente e não entra no risco.

03

Motor de Risco

Abrir área

Explica o cálculo e a propagação GGTRI → GTARI → BEI.

Pergunta respondida: Por que os índices estão nesse nível e quais eventos contribuem marginalmente?

  • Leia os três índices como cadeia.
  • Compare componentes, pesos e entradas.
  • Não confunda severidade bruta com impacto marginal.
  • O contrafactual recalcula sem um evento.
  • O simulador injeta uma hipótese rotulada e recalcula os motores.

Atenção: Sem variação pode indicar que outro risco já é vinculante para o fluxo.

04

Rede Global de Rotas Marítimas

Abrir área

Mostra o caminho dos fluxos e o risco aplicado por segmento.

Pergunta respondida: Por onde o comércio passa, quais chokepoints são necessários e que alternativas existem?

  • Selecione um fluxo para ver origem, destino e segmentos.
  • O risco colore o trecho afetado, não necessariamente a rota inteira.
  • INFERRED usa rede e geografia; OBSERVED exige AIS.
  • Desvios mostram distância, dias e pressão estrutural estimada.

Atenção: Uma rota inferida não representa a trajetória de um navio específico.

05

Cobertura de Rotas

Abrir área

Audita quanto da rede está observado, inferido ou sem cobertura.

Pergunta respondida: Quais rotas e segmentos têm evidência suficiente?

  • Compare cobertura de fluxos, segmentos e chokepoints.
  • Separe OBSERVED de INFERRED.
  • Leia lacunas como limites, não como ausência de risco.
06

Exposição do Brasil & Transmissão

Abrir área

Explica como um choque externo pode chegar aos setores brasileiros.

Pergunta respondida: O que aconteceu, como chega ao Brasil, quem é afetado e qual a consequência estrutural?

  • Separe BEI observado, simulado e delta.
  • Siga evento → chokepoint → fluxo → commodity → mercado → Brasil → setor.
  • Clique em nós e conexões para direção, magnitude, confiança e defasagem.
  • Compare impactos negativos e compensatórios.
  • Filtre a matriz por evento, setor, canal e horizonte.

Atenção: Câmbio é multicausal; não há previsão macroeconômica determinística.

07

Fertilizantes

Abrir área

Aprofunda dependência brasileira, origens e risco logístico da cadeia.

Pergunta respondida: Quais produtos e fornecedores concentram a dependência e por quais rotas?

  • Compare produtos sem agregar unidades incompatíveis.
  • Observe fornecedor, participação, período e evidência.
  • Conecte a exposição com rotas, custos e agricultura.

Atenção: Dependência comercial não equivale a ruptura física de oferta.

08

Sistema de Alerta Antecipado

Abrir área

Detecta aceleração de sinais antes que o risco estrutural necessariamente mude.

Pergunta respondida: Onde a tensão ganha velocidade e quais sinais acompanhar?

  • Compare nível, velocidade em 24h, 7d e 30d.
  • A aceleração mostra ganho ou perda de força.
  • O EWS combina sinais, evidência, geografia, anomalia e escalada.
  • Surprise risk destaca aceleração com nível ainda não elevado.

Atenção: Horizontes do EWS são experimentais; não são previsão causal.

09

War Room Executiva

Abrir área

Organiza uma crise em uma visão única para decisão.

Pergunta respondida: O que aconteceu, por que importa, o que está ameaçado e como cenários alteram a exposição?

  • Escolha um tema prioritário.
  • Revise evento, evidências, rotas, comércio e Brasil.
  • Compare desescalada, caso-base e escalada como hipóteses.
  • Registre decisão e sinais a monitorar.
10

Relatório Diário

Abrir área

Resume índices, rotas, chokepoints, commodities e Brasil.

Pergunta respondida: Qual é o quadro operacional do dia?

  • Comece pelo destaque e resumo calculado.
  • Revise rotas por estresse e chokepoint dominante.
  • Use a versão em texto para compartilhar.
  • Leia as ressalvas incluídas.

Atenção: Pressão de custo é proxy estrutural, nunca cotação ou previsão.

11

Cobertura Mensal

Abrir área

Acompanha histórico de GTAR/BEI e suficiência temporal.

Pergunta respondida: Há histórico para comparar mês a mês ou ano contra ano?

  • Compare apenas quando houver observação anterior.
  • Variações anuais exigem o mês do ano anterior.
  • Meses ausentes não são preenchidos.
  • O aviso de histórico insuficiente bloqueia conclusões indevidas.
12

Analista IA

Abrir área

Responde perguntas usando o contexto registrado na plataforma.

Pergunta respondida: Como sintetizar eventos, rotas e Brasil para uma pergunta específica?

  • Defina objeto, região, canal ou setor.
  • A resposta consulta eventos, fluxos, dependências e índices.
  • DEMO e ESTIMADO devem ser identificados.
  • Revise incertezas e lacunas.

Atenção: É saída de modelo via AI Gateway; não cria evidência nem substitui fontes.

13

Fontes de Dados & Linhagem

Abrir área

Mostra disponibilidade, frescor, erros, cobertura e origem.

Pergunta respondida: Qual fonte alimentou o número e há limitação ativa?

  • HEALTHY é sucesso; STALE é envelhecido; ERROR exige revisão; WAITING_FOR_CREDENTIALS indica acesso ausente.
  • Abra valores para ver fonte, período, atualização e método.
  • Uma falha reduz atualidade, mas não apaga dados anteriores.
  • Consulte antes de citar números como atuais.
14

Metodologia

Abrir área

Registra versões, componentes e regras dos modelos.

Pergunta respondida: Quais princípios sustentam os resultados?

  • Consulte versões de GGTRI, GTARI e BEI.
  • Revise confiança, decaimento e dupla contagem.
  • Use junto do Motor: uma explica a regra; o outro mostra a execução.
06

Uso prático

Quatro rotinas recomendadas

Monitoramento diário

  1. 1Abra a Central e leia os índices e drivers.
  2. 2Consulte o Alerta Antecipado.
  3. 3Revise o Relatório Diário.
  4. 4Confirme frescor em Fontes de Dados.

Investigar um evento

  1. 1Confira confiança e diversidade das evidências.
  2. 2Abra o detalhe do evento.
  3. 3Compare severidade e impacto marginal no Motor.
  4. 4Abra a War Room para propagação e cenários.

Avaliar impacto no Brasil

  1. 1Siga a cadeia causal no módulo Brasil.
  2. 2Separe observado, modelo e cenário.
  3. 3Revise dependências, defasagens e compensações.
  4. 4Aprofunde fertilizantes quando aplicável.

Testar um choque

  1. 1Escolha evento, severidade e duração.
  2. 2Leia a hipótese antes de executar.
  3. 3Compare estado atual, cenário e delta.
  4. 4Confirme rotas e setores que realmente mudaram.

Quando usar o Analista IA

Use depois de identificar a questão e revisar os dados. Delimite evento, rota, setor ou horizonte e confirme a síntese nas telas e fontes.

07

Uso responsável

Limites, governança e interpretação

Cobertura não é o universo inteiro

Os índices refletem o escopo monitorado. Ausência da base não prova ausência de risco.

Atualização depende das fontes

Limites, credenciais ou atraso podem deixar uma fonte STALE ou ERROR.

Modelos têm versão

Pesos, decaimento e componentes são versionados; compare séries compatíveis.

Cenários não são previsões

Respondem “o que muda se esta premissa ocorrer?”, sem atribuir probabilidade.

Rotas podem ser inferidas

Sem AIS suficiente, a geometria usa portos, segmentos e caminho calculado.

Efeito econômico é estrutural

Organiza canais, direção, magnitude, confiança e defasagem sem inventar impactos.

IA interpreta, não cria fatos

Ailin trata evidências; o Analista IA usa AI Gateway. Ambos dependem das fontes.

A decisão continua humana

O analista deve confrontar fontes, contexto e informações externas.

Não use isoladamente para decisão financeira, logística ou de segurança.

Confirme atualidade, cobertura, premissas e evidências.

08

Referência rápida

Glossário de termos e siglas

ACLED

Armed Conflict Location & Event Data

Base estruturada de conflitos e violência política; depende de acesso configurado.

AI Gateway

Acesso a modelos de IA

Serviço usado pelo Analista IA para interpretar o contexto registrado.

Ailin

Inteligência textual

Fonte e análise especializada de evidências; não calcula os índices econômicos.

AIS

Automatic Identification System

Sinal de embarcações que, quando disponível, sustenta trajetórias observadas.

BEI

Brazil Exposure Index

Exposição do Brasil ao risco transmitido por comércio, rotas e dependências, de 0 a 100.

Chokepoint

Ponto de estrangulamento

Passagem marítima estreita e sistemicamente relevante.

Comex Stat

Comércio exterior brasileiro

Fonte oficial brasileira de importações e exportações.

Confiança

Força do suporte

Medida separada da severidade; considera fontes e corroboração.

Contrafactual

Reexecução sem um elemento

Retira um evento para medir sua contribuição marginal.

Created

Status de evidência

O candidato foi convertido em evento e vinculado ao registro consolidado.

Deduplicação

Remoção de repetição

Evita que o mesmo relato conte várias vezes.

EIA

U.S. Energy Information Administration

Fonte oficial de energia dos Estados Unidos.

EWS

Early Warning Score

Alerta antecipado baseado em sinais, velocidade, aceleração e evidência.

GDELT

Global Database of Events, Language and Tone

Fonte global de notícias e sinais para candidatos de evidência.

GGTRI

Global Geopolitical Tension & Risk Index

Índice de tensão e risco geopolítico global, de 0 a 100.

GTAR

Global Trade at Risk

Valor ou volume absoluto exposto, diferente do índice GTARI.

GTARI

Global Trade at Risk Index

Índice normalizado do risco sobre fluxos monitorados, de 0 a 100.

Linhagem

Proveniência do dado

Fonte, período, atualização, método e qualidade de um número.

NewsAPI

Agregador de notícias

Fonte de candidatos; depende de plano e credencial.

Rerroteamento

Desvio de rota

Alternativa calculada com distância e tempo adicionais estimados.

Severidade

Gravidade do evento

Não equivale ao impacto marginal no GGTRI nem ao efeito no Brasil.

UN Comtrade

Base de comércio da ONU

Fluxos internacionais por produto e país.

USDA

U.S. Department of Agriculture

Fonte oficial de dados agrícolas.

Pronto para começar?

Abra a Central ou consulte a metodologia dos cálculos.