Por que o Open Knowledge Format do Google é importante
A maioria das equipes não carece de dados. Elas carecem de contexto compartilhado.
Definições e regras de uso costumam ficar escondidas em wikis, tickets ou na cabeça das pessoas. Essa fragmentação prejudica os humanos e confunde agentes de IA. Quando o contexto está ausente, os agentes de IA tentam adivinhar. Adivinhações levam a respostas erradas e automações quebradas.
O Open Knowledge Format (OKF) do Google resolve isso. Ele empacota o contexto como um conjunto de arquivos que tanto humanos quanto IAs podem ler.
What is OKF?
Não é uma nova plataforma ou um banco de dados complexo. É uma maneira de empacotar o conhecimento como um diretório de arquivos Markdown.
- Usa Markdown para facilitar a leitura.
- Usa YAML frontmatter para metadados estruturados.
- É neutro em relação a fornecedores.
- Funciona com Git e fluxos de trabalho de desenvolvedores existentes.
Why developers should care:
O OKF separa dados de contexto. Dados são o seu esquema ou contrato de API. Contexto é a definição, a propriedade e o guia de "como usar isso com segurança".
With OKF, you can:
- Usar o Git para gerenciar o conhecimento. Você pode revisar alterações via pull requests.
- Evitar tarefas de "arqueologia". Você não precisará mais vasculhar o Slack para encontrar a definição de uma métrica.
- Fundamentar agentes de IA. Os agentes podem recuperar arquivos específicos e etiquetados para fornecer respostas precisas.
- Garantir portabilidade. Como são "apenas arquivos", você pode mover seu conhecimento entre diferentes ferramentas sem precisar reescrevê-lo.
How to start:
Não tente documentar tudo de uma vez. Comece onde as lacunas de contexto causam mais problemas.
- Escolha uma área de alto valor, como métricas executivas ou runbooks de sobreaviso (on-call).
- Defina um pequeno conjunto de tipos (ex: métrica, tabela, runbook).
- Use tags e padrões de capitalização consistentes.
- Adicione verificações simples de CI para evitar links quebrados ou metadados incorretos.
O OKF transforma notas dispersas em uma base de conhecimento consultável. Ele torna a inteligência organizacional durável e portátil.
Optional learning community: https://t.me/GyaanSetuAi