Open Knowledge Format (OKF)

O conhecimento que os agentes conseguem ler: anatomia do Open Knowledge Format

O Open Knowledge Format (OKF) é uma especificação aberta publicada pela Google Cloud em 12 de junho de 2026 no repositório público knowledge-catalog do GitHub (https://github.com/GoogleCloudPlatform/knowledge-catalog; especificação em https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md). Atualmente na versão 0.2 — lançada ainda em 2026 com a adição de trust signals aos metadados [1][2][3] — o OKF define como unidade fundamental o knowledge bundle: uma coleção hierárquica e autocontida de arquivos Markdown com metadados YAML no frontmatter, projetada para ser publicada, revisada e consumida por agentes de IA [2]. A diferença real entre o OKF e um diretório comum de Markdown com frontmatter YAML é que o OKF padroniza o conjunto, não apenas o arquivo: ele estabelece como os arquivos se organizam em bundles, como as referências entre conceitos são declaradas no frontmatter e quais metadados mínimos usar (título, descrição, tipo do ativo, etiquetas), transformando o diretório em um grafo navegável por máquinas [4]. Em relação a JSON-LD e RDF, a diferença é estrutural: o OKF não emprega triplas nem semântica formal de relações, não impõe ontologias e não possui registro de esquemas; uma referência no frontmatter apenas assinala que dois conceitos estão ligados, sem declarar o tipo da relação [2][7]. É a escolha deliberada de trocar expressividade semântica por acessibilidade.

O que é o OKF, quem o propôs e qual problema ele resolve

O OKF nasceu dentro do ecossistema Google Cloud e foi anunciado oficialmente em 12 de junho de 2026 [1][11]. A especificação se autodefine como um formato "aberto, amigável a humanos e a agentes" para representar conhecimento: metadados, contexto e conteúdo curado [2]. O problema que o formato ataca pode ser enunciado em uma frase: agentes de IA precisam de contexto, e o contexto das organizações está em silos. A documentação corporativa típica de 2026 combina páginas em ferramentas proprietárias, bases de dados com esquemas privados e arquivos legados — conteúdo que um humano encontra com esforço e um agente encontra com erro. O blog da Google Cloud descreve o OKF como uma resposta a esse impasse, padronizando a forma como equipes compartilham e documentam dados [1]. A decisão de projeto mais reveladora, porém, é a escolha de convenções mínimas: sem registro de esquemas, sem autoridade central e sem ferramentas obrigatórias [2]. A tese defendida aqui é dupla: o OKF representa uma aposta deliberada na simplicidade como estratégia de interoperabilidade — e é precisamente essa superficialidade, não a sofisticação semântica da Web Semântica, que merece exame sério.

Um dos argumentos centrais dos defensores do formato é a portabilidade: o OKF é um formato portátil que qualquer pessoa pode produzir e qualquer pessoa pode consumir, sobrevivendo à migração entre sistemas e vivendo no controle de versão ao lado do código e dos dados que descreve [12]. Em um cenário em que cada ferramenta de documentação tenta aprisionar o conhecimento em seu próprio esquema, essa neutralidade é uma proposta de valor concreta — ainda que, como se verá, o mesmo atributo que facilita a adoção também dificulta a padronização.

Arquitetura técnica: bundles, ativos e o grafo mínimo

Tecnicamente, o OKF é quase agressivamente simples: um diretório de arquivos Markdown, cada um com um bloco de metadados YAML no frontmatter [2][5]. O Markdown garante duas coisas que os formatos concorrentes frequentemente sacrificam — legibilidade humana sem ferramentas especiais e parseabilidade trivial por modelos de linguagem. O YAML carrega o que o corpo do texto não pode expressar: título, descrição, tipo do ativo, etiquetas e, crucialmente, referências a outros arquivos do bundle. São essas referências que transformam um diretório em um grafo: cada conceito aponta para conceitos relacionados, e um agente pode navegar de um ativo a outro como quem percorre uma enciclopédia desenhada para máquinas [4].

O anúncio original descrevia a versão 0.1 como um diretório de arquivos Markdown com YAML frontmatter e um pequeno conjunto de convenções acordadas [1]. A especificação da v0.2 insiste que o formato serve para representar "os metadados, o contexto e o insight curado que circundam dados e sistemas" [2] — ou seja, exatamente o que o Markdown puro, sem frontmatter, não consegue capturar.

A escolha por referências explícitas no frontmatter, em vez de uma camada de grafo separada, é a decisão arquitetônica central do formato. Em contraste com JSON-LD, que expressa conhecimento como triplas RDF embutidas em documentos JSON, o OKF não define uma semântica formal de relações: um campo de referência diz que dois conceitos estão ligados, mas não declara formalmente o tipo da relação nem impõe uma ontologia [7]. A versão 0.2 introduziu os trust signals — campos que sinalizam quão confiável é um bundle, como metadados de autoria, data de atualização e procedência — mas permanecem declarações, não verificações [3]. A limitação é evidente: sem um registro de esquemas, dois produtores podem usar convenções divergentes para o mesmo conceito, e a validação fica a cargo de ferramentas externas que ainda estão sendo construídas [5]. O que o formato ganha em acessibilidade, perde em rigor — e essa troca é o coração do debate sobre o OKF.

O OKF diante das alternativas: do PKM à Web Semântica

O OKF entra em um território já disputado por ferramentas de gestão de conhecimento pessoal e por padrões da web semântica. Ele não compete diretamente com essas ferramentas; antes, oferece um alvo de exportação que qualquer delas poderia adotar [5]. A tabela abaixo resume as principais diferenças.

Como observa Idehen [7], a objeção da comunidade semântica é tecnicamente correta. A pergunta incômoda é por que, se a Web Semântica resolveu o problema, o problema continua existindo.

Casos de uso: pesquisa, corporações, wikis e o consumo por LLMs

Os casos de uso do OKF se organizam em quatro frentes, todas ainda em estágio embrionário. Na pesquisa científica, a promessa é a de bundles reproduzíveis: um experimento documentado como diretório de Markdown com metadados de procedência, que um revisor humano lê e um agente verifica — uma resposta concreta ao problema da reprodutibilidade que o formato PDF tornou crônica. Na documentação corporativa, o formato aparece como camada para catálogos de dados "agent-ready": a Google Cloud o descreve como um meio de melhorar o compartilhamento de dados entre equipes, padronizando a documentação que acompanha cada ativo de dados [1]. Ferramentas de catálogo já discutem o OKF como alternativa de exportação para bases de conhecimento inteiras, em que cada arquivo do bundle corresponde a um conceito do domínio [4].

No universo dos wikis pessoais, o OKF oferece o que Obsidian e similares sempre prometeram e nunca entregaram por completo: portabilidade sem atrito. Um vault em Markdown que segue as convenções do OKF pode ser lido por qualquer agente, sem integração personalizada — e os próprios agentes podem escrever de volta, atualizando conceitos como quem edita um verbete [9]. Um relato técnico de 2026 descreve um bundle mantido por agente como, simultaneamente, cache, sistema de publicação e estado compartilhado sensível à segurança — uma tríade de papéis que nenhum formato anterior ocupou [9]. No consumo por LLMs, o formato alimenta pipelines de geração aumentada por recuperação (RAG) com conhecimento curado, e analistas de SEO já o tratam como uma camada de "acessibilidade para agentes", sucessora do SEO tradicional [6][10]. A ressalva é obrigatória: todos esses casos são descrições de promessas, não evidências de adoção em escala. Nenhum estudo controlado mediu, até aqui, se bundles OKF melhoram a precisão factual de agentes em relação a alternativas — o que torna o entusiasmo prematuro e a crítica necessária.

Estado atual em 2026: adoção, críticas e a aposta na superficialidade

A adoção do OKF em 2026 é real, mas concentrada. A especificação 0.2 adicionou trust signals, e a comunidade técnica respondeu com ferramentas de autoria, validação, lint e visualização de bundles no GitHub, além de comparações explícitas com padrões vizinhos como Model Context Protocol (MCP) e Skills [3][9]. Analistas de busca e marketing digital, um termômetro confiável de hype, já o tratam como fator de ranqueamento futuro para agentes [10]. Nada disso, porém, equivale a adoção madura: não há, ainda, um ecossistema de bibliotecas, nem métricas públicas de uso, nem evidência empírica de que agentes consomem bundles OKF melhor do que consomem JSON-LD ou bancos vetoriais.

É aqui que este artigo assume uma posição deliberadamente desconfortável. A crítica mais comum ao OKF — de que ele é raso demais, uma regressão diante de 25 anos de Web Semântica [7] — é, ao mesmo tempo, a mais verdadeira e a mais irrelevante. A Web Semântica otimizou por expressividade e pagou o preço em adoção: seus padrões resolvem o problema de forma tecnicamente superior e socialmente inviável. O OKF otimiza por acessibilidade, e essa é uma escolha estratégica, não um defeito acidental. A obsessão atual com grafos de conhecimento formais está mal direcionada: o problema real de 2026 não é a ausência de semântica, é a ausência de conhecimento em qualquer formato legível por máquinas. Pode ser que o OKF, ao rebaixar a barreira de entrada, faça pela estruturação do conhecimento o que o Markdown fez pela escrita: democratizar o ato. O risco simétrico, porém, é tão real quanto a promessa. Sem um registro de esquemas, cada organização pode criar seu próprio sabor de frontmatter, produzindo uma nova Torre de Babel de convenções incompatíveis; e trust signals meramente declarativos, sem verificação criptográfica ou institucional, podem ser manipu

lados por produtores de conteúdo de baixa qualidade [3]. A superficialidade é a força do OKF e sua vulnerabilidade — raramente uma especificação carregou os dois fardos tão explicitamente.

Discussão: tensões e lacunas

As tensões que atravessam o OKF são estruturais e não serão resolvidas por uma versão 0.3. A primeira é a dicotomia simplicidade versus expressividade: quanto mais simples o formato, maior a base de adoção e menor a precisão semântica; a Web Semântica percorreu o caminho oposto e naufragou na adoção, mas isso não prova que a direção do OKF seja correta — apenas que é a única ainda inexplorada. A segunda tensão é de governança: um formato "aberto e neutro" publicado por uma das maiores empresas de nuvem e IA do mundo, no repositório da própria Google Cloud, cria um conflito de interesses discreto — quem define o padrão que os agentes consomem define, em parte, o que os agentes enxergam [1]. A terceira é a confiança: trust signals declarativos respondem à necessidade de credibilidade, mas sem mecanismos de verificação, um agente que confia em um bundle falso propaga o erro em escala, transformando o formato em vetor de desinformação estruturada [9].

As lacunas empíricas são igualmente gritantes. Não há estudos publicados comparando a qualidade de respostas de agentes alimentados por bundles OKF contra alternativas; não há métricas de interoperabilidade entre implementações; não há, sequer, um consenso sobre o vocabulário mínimo de metadados. O que existe é um formato elegante, uma especificação honesta sobre seus próprios limites e um ecossistema de ferramentas ainda amadoras. O OKF está, em 2026, exatamente onde o HTTP estava em 1992: simples o bastante para ser copiado, aberto o bastante para ser adotado e imaturo o bastante para ser subestimado.

Conclusão

O Open Knowledge Format vence — se vencer — não por elevar o padrão técnico, mas por rebaixar a barreira de entrada para a estruturação de conhecimento. Sua tese é que a portabilidade do conhecimento se conquista com convenções mínimas e legibilidade universal, não com ontologias abrangentes; e a história da Web Semântica sugere que essa aposta, por mais contraintuitiva que pareça aos especialistas, é a única com chance de escala. Três direções definirão o destino do formato: primeiro, a criação de mecanismos de verificação de confiança que transformem trust signals declarativos em credenciais auditáveis; segundo, pontes de importação e exportação com ferramentas de PKM e bancos de grafos, para que o OKF não vire mais um silo; terceiro, mapeamentos formais para RDF e JSON-LD nos casos em que a semântica importa, convertendo a crítica da comunidade semântica em interoperabilidade, em vez de competição. Se essas três frentes avançarem, o OKF poderá ser lembrado não como o formato que reinventou a roda, mas como aquele que finalmente a colocou para rodar em estrada aberta.

Críticas, riscos e o problema da adoção

O primeiro obstáculo à adoção do OKF não é técnico, é social. O mercado de formatos de conhecimento está saturado: JSON-LD, RDF, llms.txt, MCP, Skills e dezenas de esquemas proprietários disputam a atenção das mesmas equipes, e cada novo padrão impõe um custo de avaliação que os adotantes relutam em pagar. A fadiga de padrões torna qualquer especificação recém-publicada suspeita — e o OKF não é exceção. Além disso, formatos de conhecimento exibem forte efeito de rede: um bundle só é útil se existirem ferramentas e agentes capazes de consumi-lo, e essas ferramentas só são construídas se existirem bundles em quantidade suficiente. Esse ciclo de arranque é o mesmo que deixou iniciativas tecnicamente superiores pelo caminho; a simplicidade do OKF reduz a barreira de entrada, mas não elimina o custo de coordenação necessário para o ecossistema decolar.

O risco de fragmentação é a outra face da moeda. Como o OKF não define um registro central de esquemas, cada organização pode — e provavelmente vai — criar seu próprio sabor de frontmatter: um campo para "autor", outro para "owner", outro para "responsável". A proliferação de convenções divergentes pode produzir exatamente o cenário que o formato pretendia evitar: uma Torre de Babel em Markdown. Há um cenário de consolidação possível: os validadores e linters comunitários [5] podem funcionar como uma camada informal de padronização, e os trust signals declarativos [3] podem evoluir para convenções de fato. Mas nada disso é automático, e a história da Web Semântica sugere que a fragmentação é o resultado mais provável quando a especificação é mínima demais para impor coerência.

A pergunta mais honesta é a mais incômoda: se um LLM moderno consegue processar Markdown puro, por que precisamos de um formato novo? Como resume Marie Haynes, o OKF é uma forma padronizada de agentes acessarem conhecimento por meio de diretórios muito simples de arquivos Markdown [6]. Um modelo com contexto suficientemente longo pode ler um repositório inteiro de Markdown sem frontmatter e extrair as relações relevantes por conta própria. Nesse cenário, o OKF seria redundante — uma camada de metadados que o LLM poderia inferir.

A defesa do formato, porém, não se baseia em capacidade de processamento, mas em eficiência e confiabilidade. O frontmatter YAML fornece uma âncora explícita: o agente não precisa adivinhar qual arquivo descreve qual conceito, nem qual campo significa o quê. Em tarefas de RAG em larga escala, essa âncora reduz trabalho de parsing e pode melhorar a precisão da recuperação. Mas isso é uma vantagem empírica, não lógica — e até hoje não há estudos que a comprovem. Se um LLM com contexto grande e Markdown puro produzir resultados equivalentes, o OKF se torna um padrão desnecessário. A resposta honesta é que ainda não sabemos.

O destino do OKF dependerá menos de sua qualidade técnica do que de fatores sociais: se o ecossistema de ferramentas amadurecer, se as convenções se consolidarem e se os agentes realmente precisarem de metadados explícitos. Nenhuma dessas variáveis está sob controle do Google. O formato pode ser adotado por ser simples, ou ignorado por ser mais um padrão em um mercado saturado. A única previsão segura é que a resposta virá do uso, não da especificação.

Referências

[1] Google Cloud (2026). How the Open Knowledge Format can improve data sharing. Google Cloud Blog. https://cloud.google.com/blog/products/data-analytics/how-the-open-knowledge-format-can-improve-data-sharing

[2] Google Cloud Platform (2026). Open Knowledge Format (OKF) — Specification v0.2. GitHub (GoogleCloudPlatform/knowledge-catalog). https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md

[3] Google Cloud (2026). OKF v0.2 adds trust signals. Google Cloud Blog. https://cloud.google.com/blog/products/data-analytics/okf-v0-2-adds-trust-signals

[4] Mer, V. (2026). OKF Explained: Google Cloud Open Knowledge Format for Agent-Ready Data Catalogs. mer.vin. https://mer.vin/2026/07/okf-explained-google-cloud-open-knowledge-format-for-agent-ready-data-catalogs/

[5] GitBook (2026). What is OKF? Understanding Google's Open Knowledge Format. GitBook Blog. https://www.gitbook.com/blog/what-is-okf-open-knowledge-format

[6] Haynes, M. (2026). The Open Knowledge Format (OKF) from Google is a new layer for agents. Marie Haynes Consulting. https://www.mariehaynes.com/okf/

[7] Idehen, K. U. (2026). Comparação entre o Open Knowledge Format (OKF) e formatos baseados em RDF. LinkedIn. https://www.linkedin.com/posts/kidehen_cxo-cdo-caio-activity-7472425575257649152-QV5l

[8] Suganthan, S. (2026). Open Knowledge Format (OKF): Google's New Markdown Standard for AI Agents. suganthan.com. https://suganthan.com/blog/open-knowledge-format/

[9] Towards AI (2026). From Self-Updating OKF Wiki to Production Trust System. Towards AI — Publications. https://pub.towardsai.net/from-self-updating-okf-wiki-to-production-trust-system-b014dbd12149

[10] Semrush (2026). Google Launches Open Knowledge Format, an AI Standard. Semrush Blog. https://www.semrush.com/blog/google-launches-open-knowledge-format-for-ai-agents/

[11] Flowtivity (2026). Google Open Knowledge Format: How Plain Markdown Standardizes Knowledge for AI Agents. Flowtivity Blog. https://flowtivity.ai/blog/google-open-knowledge-format/

[12] Balarabe, T. (2026). What is Open Knowledge Format (OKF)? Medium. https://medium.com/@tahirbalarabe2/what-is-open-knowledge-format-okf-270b20791802