Transparência Radical: Publicando a Taxa Real de Acertos da Nossa API

A Verdade Incômoda Sobre os Dados do Agente de IA

Quando um agente de IA te diz "o melhor preço para o Jetson Nano é $249", como você sabe que ele está dizendo a verdade? Como o agente sabe?

Ele não sabe. Ele chuta. Ele confia na API que chamou.

Eu administro AgentShare.dev – uma API de infraestrutura de preços para agentes de IA. E percebi algo incômodo:

A maioria das APIs não publica suas taxas de falha. A maioria não informa aos agentes quando os dados estão desatualizados ou fora de cobertura.

Então, decidi fazer algo diferente.

Nossa Promessa de Transparência Radical

A partir de hoje, cada resposta da API AgentShare informa aos agentes:

• data_status: fresco, desatualizado, pendente_de_crawl ou fora_de_cobertura
• data_age_seconds: quão antigo é o preço
• trust_{endpoint}_hit_rate: nossa taxa de sucesso histórica

Mas isso não é tudo.

Também publicamos um endpoint de qualidade de dados público, ao vivo e não editado:
GET https://agentshare.dev/api/v1/public/data-quality

Qualquer um – humano ou agente – pode verificar nosso desempenho real a qualquer momento.

Aqui Estão Nossos Dados Reais (Sem Filtragem)

Em 10 de maio de 2026, isso é o que o endpoint retornou:

{
  "overall": {
    "signals_total": 9,
    "outcome_ok": 1,
    "hit_rate": 0.1111,
    "coverage_tier": "insufficient_sample"
  },
  "endpoints": [
    {"endpoint": "/api/v1/search", "signals_total": 4, "hit_rate": 0.25},
    {"endpoint": "/api/v1/offers/best", "signals_total": 3, "hit_rate": 0.0},
    {"endpoint": "/api/v1/offers/best-under-budget", "signals_total": 2, "hit_rate": 0.0}
  ],
  "category_breakdown_meta": {"state": "building"}
}

O que esses dados honestos te dizem:

• Estamos na fase de construção – apenas 9 sinais em 7 dias
• Taxa de acerto geral inicial: 11%
• /api/v1/search está liderando com 25%
• Ainda não temos dados suficientes para fazer afirmações firmes

Mas Aqui É Onde Fica Interessante

Enquanto nosso tráfego medido ainda é pequeno, nosso sistema está configurado para cobrir categorias específicas bem.

{
  "category": "ai_hardware",
  "hit_rate": 0.78,
  "confidence": "spec_estimate",
  "coverage_spec_quality": "high"
}

Com base em nossa cobertura