🔑 Guia de Configuração de Tokens - Cidadão.AI¶

Autor: Anderson Henrique da Silva Data: 2025-10-03

✅ Token Dados.gov.br Configurado!¶

📊 Seu Token¶

Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJIQWdqOVpsVDdTZmFUcXc5RTNIRHFXV25nWE9lYjlZTVlnSVQ2bi11bVd1bVpkVlV2Umd6UnhXQmk5YVVYYmxBaFZqRC1JeTlsOV84cXFfSSIsImlhdCI6MTc1OTQxODI5MX0.AembeD3MtWXbYKtrfyQPfKByMYiUjyvoA0XZzMYTQts
Usuário: ANDERSON HENRIQUE DA SILVA (@andersonhs90@hotmail.com)
CPF: 109.472.466-14
Criado em: 02/10/2025 15:17:09

✅ Já Configurado no `.env`¶

DADOS_GOV_API_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJIQWdqOVpsVDdTZmFUcXc5RTNIRHFXV25nWE9lYjlZTVlnSVQ2bi11bVd1bVpkVlV2Umd6UnhXQmk5YVVYYmxBaFZqRC1JeTlsOV84cXFfSSIsImlhdCI6MTc1OTQxODI5MX0.AembeD3MtWXbYKtrfyQPfKByMYiUjyvoA0XZzMYTQts

🎯 Tokens Configurados¶

Token	Status	Observação
DADOS_GOV_API_KEY	✅ Configurado	Token JWT do Portal Brasileiro de Dados Abertos
TRANSPARENCY_API_KEY	✅ Configurado	Chave e24f842355f7211a2f4895e301aa5bca
GROQ_API_KEY	⚠️ Pendente	Necessário para agentes IA funcionarem

🚀 Próximo Passo: Configurar GROQ¶

O único token faltante é o GROQ_API_KEY para os agentes IA funcionarem.

Como Obter (GRÁTIS):¶

Acesse: https://console.groq.com/
Crie uma conta (grátis)
Vá em "API Keys"
Clique "Create API Key"
Copie a chave (começa com gsk_)

Adicione no `.env`:¶

GROQ_API_KEY=gsk_sua_chave_aqui_xxxxxxxxxxxxx

Limites Gratuitos:¶

✅ 30 requests/minuto
✅ ~14,400 tokens/minuto
✅ Modelos rápidos: Llama 3, Mixtral, Gemma

📦 O Que Cada Token Faz¶

1. DADOS_GOV_API_KEY (dados.gov.br)¶

Permite acesso a: - 📊 16,000+ datasets de dados governamentais abertos - 🏛️ Organizações do governo federal - 📑 Recursos e arquivos de dados públicos - 🏷️ Tags e categorias de datasets

Usado pelos agentes: - 🏜️ Lampião - Análise regional com dados IBGE - 🔍 Zumbi - Detecção de anomalias em dados públicos - 📊 Anita - Análise de padrões em séries temporais - 📝 Tiradentes - Geração de relatórios com dados reais

Endpoints disponíveis:

# Buscar datasets
GET /api/3/action/package_search?q=educação

# Detalhes de dataset
GET /api/3/action/package_show?id={dataset_id}

# Listar organizações
GET /api/3/action/organization_list

# Listar tags
GET /api/3/action/tag_list

2. TRANSPARENCY_API_KEY (Portal da Transparência)¶

Limitações conhecidas: - ✅ 22% dos endpoints funcionam - ❌ 78% retornam 403 Forbidden

Endpoints que funcionam:

# Contratos (com codigoOrgao)
GET /contratos?codigoOrgao=123456

# Servidores (por CPF)
GET /servidores?cpf=12345678900

3. GROQ_API_KEY (LLM para Agentes)¶

Usado para: - 🤖 Inteligência dos 13 agentes - 💬 Chat conversacional - 📊 Análise de dados com IA - 📝 Geração de relatórios - 🎯 Roteamento semântico

🧪 Testando a Configuração¶

Teste 1: Verificar .env¶

grep "DADOS_GOV_API_KEY" .env
grep "TRANSPARENCY_API_KEY" .env
grep "GROQ_API_KEY" .env

Teste 2: Executar o sistema¶

make run-dev
# ou
python -m src.api.app

Teste 3: Acessar documentação¶

http://localhost:8000/docs

Teste 4: Testar endpoint dados.gov.br¶

curl http://localhost:8000/api/v1/dados-gov/datasets/search?q=educacao&rows=5

🔒 Segurança¶

⚠️ NUNCA COMMITAR O .ENV!¶

O .env está no .gitignore. Verifique:

git check-ignore .env
# Deve retornar: .env

🔐 Regenerar Token¶

Se precisar regenerar o token dados.gov.br:

Acesse: https://dados.gov.br (logado)
Vá em "Minha Conta"
Seção "TOKEN API"
Clique "Regerar"
Copie o novo token
Atualize no .env

✅ Checklist Final¶

Token dados.gov.br obtido
Token dados.gov.br configurado no .env
Token Portal da Transparência configurado
Token GROQ obtido
Token GROQ configurado no .env
Sistema testado com make run-dev
Agentes respondendo corretamente

🎉 Pronto!¶

Com todos os tokens configurados, você terá:

✅ 13 agentes IA operacionais
✅ Acesso a 16,000+ datasets do governo
✅ Análises regionais com dados IBGE
✅ Detecção de anomalias em dados reais
✅ Chat conversacional inteligente
✅ Relatórios automáticos com dados governamentais

Dúvidas? Consulte: - Documentação dados.gov.br - Documentação GROQ - README do projeto