O que faltava entre o dado e o agente
Agentes não trabalham só com código. Para responder bem, eles precisam achar definições de métricas, schemas, caminhos de JOIN, decisões e runbooks. Esse conhecimento costuma existir, mas espalhado entre wikis, documentos, comentários e a memória de quem já está no time há mais tempo.
O Open Knowledge Format (OKF) entra nessa camada. A especificação aberta do Google Cloud, publicada na versão 0.1 em 12 de junho de 2026, define uma convenção simples para representar conhecimento organizacional em diretórios de Markdown com frontmatter YAML. Sem SDK obrigatório, sem runtime proprietário e sem vínculo com um fornecedor.
O formato formaliza uma ideia que ficou conhecida como LLM wiki: uma base de conhecimento que um agente pode percorrer em vez de receber um bloco enorme de contexto de uma vez.
A parte pequena que torna o formato útil
Um bundle OKF pode começar com muito pouco. O único campo obrigatório no frontmatter é type. A partir daí, o produtor pode acrescentar title, description, resource, tags e timestamp quando fizer sentido.
Os arquivos se conectam por links Markdown comuns. index.md organiza a descoberta progressiva; log.md registra mudanças. A estrutura continua legível para alguém no editor e navegável para um agente.
Não é uma plataforma tentando guardar todo o conhecimento da empresa. É um formato de troca: quem produz o conteúdo e quem o consome podem trabalhar de forma independente.
Tip
A regra central do OKF é deliberadamente modesta: padronizar o suficiente para permitir interoperabilidade, sem impor uma ferramenta, modelo ou banco de dados.
O projeto
Construí o OKF como uma referência independente para a especificação. O site roda em Astro e publica a mesma base em dois domínios:
O idioma é definido pelo domínio, não por um prefixo na rota. Além da documentação, o projeto inclui um validador que funciona no navegador, sem backend, e uma skill para agentes.
O objetivo não é competir com a documentação original. É reduzir a distância entre uma spec nova e alguém que precisa experimentá-la, especialmente para quem trabalha em português.
Onde isso se encaixa
Há uma diferença útil entre instruir um agente e dar a ele conhecimento para consultar. Arquivos como AGENTS.md e CLAUDE.md explicam como atuar dentro de um projeto. O OKF organiza o que esse agente pode descobrir sobre o negócio, os dados e os sistemas.
Um exemplo simples: um agente recebe uma tarefa sobre uma métrica. Em vez de depender de contexto colado manualmente, ele pode seguir um index.md, abrir a definição da métrica, encontrar o schema relacionado e chegar aos caminhos de JOIN documentados. Cada arquivo entrega só a próxima parte necessária.
Essa é a aposta do formato: Markdown continua sendo uma escolha prática para pessoas; com uma convenção mínima, também vira uma superfície de consulta para agentes.
Estado atual
O site e a documentação estão publicados em inglês e PT-BR. O repositório reúne também a especificação de produto, os conteúdos e a implementação em Astro.
Note
OKF ainda é uma especificação jovem. A versão apresentada aqui é a v0.1 publicada pelo Google Cloud, sem alegações de adoção ou de compatibilidade além do que a própria especificação define.
Visitar OKF em inglês · Acessar a versão em português · Ler a especificação original
