Como usar

A forma mais rápida de conhecer a Acácia é pelo playground de busca, em /search. Ele é a interface visual sobre a mesma API que responde às integrações.

Escrevendo uma consulta

Escreva como você perguntaria a uma pessoa. A busca é semântica — ela entende o sentido da pergunta, não apenas palavras-chave:

risco de estresse hídrico em Salvador
segurança alimentar no sertão baiano em 2022
capacidade de resposta da saúde a desastres

Quando a consulta menciona um município ou um ano, a Acácia interpreta a frase, resolve o geocode IBGE do território e filtra os valores automaticamente. A interpretação aparece no painel esquerdo, abaixo das configurações — você sempre vê o que foi entendido.

Modos de busca

O controle deslizante "Modo de busca" muda o pipeline de verdade:

Modo	O que faz	Quando usar
Rápida	Pula a interpretação por LLM; só busca vetorial.	Consultas sem município/ano, ou quando latência importa.
Auto	Pipeline completo: interpretação + busca + valores ao vivo.	O padrão recomendado.
Profunda	Amplia a varredura: mais indicadores e mais valores por indicador.	Exploração de um tema, análises comparativas.

Configurações

Número de resultados — limite total de linhas retornadas (até 50).
Categoria — restringe a busca vetorial a uma categoria do catálogo (Água, Segurança alimentar, Desastres hidrológicos…).
Ano — fixa o período, sobrepondo o que a interpretação extrair.

Lendo um resultado

Cada card de resultado traz:

Indicador e categoria — o nome canônico e a categoria de origem.
Território — município + UF, derivados do geocode IBGE.
Valor e classe — o número reportado pelo provedor e sua classificação qualitativa (Muito baixo → Muito alto), exibida no medidor de cinco níveis.
Fonte — publicador, licença e citação pronta, no rodapé do card.

A resposta em JSON

A aba JSON do painel de saída mostra a resposta canônica completa — o mesmo objeto que uma integração receberia. O botão "Copiar para IA" copia esse JSON para a área de transferência, pronto para colar em um chat ou pipeline.

{
  "query": "risco de estresse hídrico em Salvador",
  "extracted": {
    "municipality": "Salvador",
    "geocode": "2927408",
    "year": null
  },
  "tookMs": 1174,
  "results": [ ... ]
}

A estrutura de cada item de results está documentada em Formato de dados.