AI Discovery Layer
Recursos para agentes de IA
O Polyapoio expõe uma pilha de descoberta para modelos e agentes: um primer do domínio, um catálogo hierárquico dinâmico (atualizado com a sync TSE) e contratos JSON para ontologia, schema tipado, exemplos e capacidades.
Quando usar cada arquivo
- llms.txt — entender o domínio e as regras (apoio ≠ pesquisa).
- llms-full.txt +
/llms/{ano}/…— navegar estados, cargos e listas de candidatos. - ontology / schema — modelar entidades e tipos de campos.
- examples — mapear perguntas para rotas e filtros.
- APIs — /api/markets e /api/tse/candidates.
Arquivos
discovery.json
Manifesto com entrypoints (human, primer, catalog, machine, api).
/ai/discovery.json
.well-known/discovery.json
Alias automático — muitos agentes consultam /.well-known/ primeiro.
/.well-known/discovery.json
llms.txt
Primer do domínio: o que é mercado, ranking, glossário, prioridade de fontes e FAQ.
/llms.txt
llms-full.txt
Catálogo hierárquico (anos → estados → cargos). Use depois do primer.
/llms-full.txt
ontology.json
Entidades com URI + aliases (pt/en), relações e prioridade de fontes.
/ai/ontology.json
schema.json
Esquema tipado dos recursos (estilo OpenAPI) e mapeamento página → entidade.
/ai/schema.json
examples.json
Roteamento com URLs reais do banco + filtros (ex.: partyAcronym=PL).
/ai/examples.json
prompts.txt
Checklist descritivo para agentes (não específico de um modelo).
/ai/prompts.txt
capabilities.json
text-search, slug-resolution, ranking, filtros UF/cargo/partido, APIs.
/ai/capabilities.json
policy.json
Permissões para treino/retrieval/indexação, contato e restrições de citação.
/ai/policy.json
version.json
Versões dos contratos + freshness dos dados (útil para cache).
/ai/version.json
HTML indexável também está em /sitemap.xml. Esta camada complementa SEO clássico e JSON-LD nas páginas de candidato, mercado e plano.