OKF (Open Knowledge Format) nedir? Yapı, uygulama ve GEO için anlamı

OKF (Open Knowledge Format), bilgiyi YAML başlıklı Markdown dosyalarından oluşan bir klasör olarak temsil eden açık bir formattır 1 . Google Cloud, formatın 0.1 sürümünü 12 Haziran 2026'da duyurdu; güncel sürüm 0.2'dir ve kendi GitHub deposunda Apache 2.0 lisansıyla yayımlanıyor 3 2 . Her dosya bir "kavramdır" (concept) ve zorunlu tek alanı type'tır 1 . OKF bir sıralama faktörü değildir. Ama sayfalarının Markdown sürümlerini zaten üreten bir site, çok düşük bir maliyetle yapay zekâ ajanlarının okuyup gezebileceği tipli bir bilgi paketi yayımlayabilir. Bu rehber formatı birincil kaynaklardan anlatıyor ve örnek olarak roicool.com'un kendi OKF çıktısını kullanıyor.

OKF nedir?

OKF, Google Cloud'un Data Cloud ekibinin yazdığı, satıcıdan bağımsız bir bilgi temsil formatıdır. Duyuru yazısı OKF'i "LLM-wiki desenini taşınabilir, birlikte çalışabilir bir formata dönüştüren açık bir spesifikasyon" olarak tanımlıyor 3 . Spesifikasyonun kendi cümlesiyle format "kasıtlı olarak minimaldir": YAML başlıklı Markdown dosyalarından oluşan bir klasör. Şema kaydı, merkezi bir otorite ya da zorunlu bir araç yoktur 1 .

Format üç temel kavram üzerine kurulu 1 :

• Paket (bundle): kendi içinde bütün, hiyerarşik bir bilgi belgeleri koleksiyonu. Dağıtım birimidir.
• Kavram (concept): paketteki tek bir bilgi birimi, tek bir Markdown belgesi. Bir tabloyu, bir API'yi, bir metriği ya da bir iş sürecini anlatabilir.
• Kavram kimliği: dosyanın paket içindeki yolu, .md uzantısı olmadan.

Depoda spesifikasyonun yanında BigQuery veri setlerinden OKF paketi üreten bir referans ajan, paketi etkileşimli bir grafik olarak gösteren bir görselleştirici ve GA4, Stack Overflow, Bitcoin ve Acme Retail örnek paketleri bulunuyor. README bu ajanı açıkça bir "kavram kanıtı" (proof of concept) olarak tanımlıyor; asıl katkı formatın kendisi 2 .

OKF neden ortaya çıktı?

OKF'in çözmeye çalıştığı sorun web araması değil, kurum içi bağlamdır. Google'ın duyurusuna göre yapay zekâ ajanlarının ihtiyaç duyduğu bilgi büyük ölçüde kurum içidir: bir tablonun şeması, bir metriğin şirketteki anlamı, bir olayın çözüm kılavuzu. Bu bilgi metadata kataloglarına, wikilere, kod yorumlarına ve birkaç kıdemli mühendisin aklına dağılmış durumda 3 .

Çıkış noktası Andrej Karpathy'nin "LLM Wiki" notudur. Karpathy, bir dil modelinin kaynakları okuyup birbirine bağlı Markdown dosyalarından oluşan kalıcı bir wikiyi kendisinin yazıp güncel tuttuğu bir düzen anlatıyor 5 . Google'ın tespiti şu: bu desen Obsidian kasalarında, AGENTS.md benzeri dosyalarda ve "kod olarak metadata" depolarında tekrar tekrar ortaya çıkıyor, ama her biri kendine özgü. Hangi alanların zorunlu olduğu ya da hangi dosya adının ne anlama geldiği konusunda ortak bir cevap yok 3 . OKF bu ortak cevabı vermeye çalışıyor.

Spesifikasyon 0.2'de bir adım daha atıyor. Bilgi artık çoğu zaman ajanlar tarafından yazılıp güncelleniyor; okuyan tarafın beş sorusu var: bu neye dayanıyor, ne kadar güvenebilirim, hâlâ doğru mu, güncel sürüm mü, bu sayı söylendiği gibi mi üretildi 1 ? 0.2'nin yeni alanları bu soruları başlık bloğunda cevaplanabilir kılıyor.

OKF, GEO ve yapay zekâ görünürlüğü için neden önemli?

Dürüst cevap: bugün doğrudan bir görünürlük kazancı yok, ama bir hazırlık değeri var. Bunu üç gerçekten çıkarıyoruz.

1. OKF bir web standardı olarak yazılmadı. Spesifikasyon depolama, sunum ve sorgulama altyapısı tanımlamayı açıkça hedef dışı bırakıyor 1 . Bir HTTP yolu, bir keşif dosyası ya da llms.txt ve schema.org'a bir atıf içermiyor. Örnek paketler web siteleri değil, veri setleri 2 .

2. Arama motorları ek dosya istemiyor. Google, AI Overviews ve AI Mode'da görünmek için yeni makine okunur dosyalar, yapay zekâ metin dosyaları ya da işaretleme oluşturmanız gerekmediğini yazıyor 8 . Ekim 2026 itibarıyla ChatGPT, Gemini, Perplexity ya da Google'ın yapay zekâ özellikleri için web sitelerindeki OKF paketlerini okuduğunu söyleyen bir belgeye rastlamadık.

3. Ajanlar Markdown okuyor ve OKF bunu düzenli hale getiriyor. llms.txt önerisi, ajanların artık web sitelerini rutin olarak kullandığını ve sayfaların temiz Markdown sürümlerinin .md uzantılı adreslerde sunulmasını öneriyor 6 . OKF bu Markdown sürümlerine üç şey ekler: bir type alanı, kavramlar arası bağlantılardan oluşan bir grafik ve kaynak ile güncellik bilgisi 1 . Google ayrıca Knowledge Catalog ürününü OKF içe alabilecek şekilde güncellediğini açıkladı 3 . Yani formatı okuyan gerçek bir tüketici var, ama şimdilik kurum içi veri dünyasında.

Bu yüzden OKF'i şöyle konumluyoruz: zaten Markdown sürümleri üreten bir site için birkaç saatlik ek iş, ajan çağına hazırlık. Görünürlük için önceliği almamalı. Önce sayfa içeriği, schema.org işaretlemesi, tarayıcı erişimi ve üçüncü taraf kaynaklar gelir; bunların listesi GEO kontrol listemizde. OKF'i SEO açısından ele alan bir Türkçe yazı da OKF'in schema işaretlemesinin yerini almadığını, onu tamamladığını vurguluyor 14 . Bu noktada aynı görüşteyiz.

OKF paketinin yapısı

Bir OKF paketi, Markdown dosyalarından oluşan bir klasör ağacıdır. Klasör yapısı alandan bağımsızdır; kavramları üretici istediği gibi düzenler 1 .

paket/
  index.md          # isteğe bağlı: klasör dizini
  log.md            # isteğe bağlı: değişiklik kaydı
  kavram.md         # kökte bir kavram
  alt-klasor/
    index.md
    kavram.md

Ayrılmış dosya adları. index.md (klasör dizini) ve log.md (değişiklik kaydı) hiyerarşinin her seviyesinde ayrılmıştır ve kavram dosyası olarak kullanılamaz 1 . Paket bir git deposu (önerilen), bir tarball ya da zip arşivi veya daha büyük bir deponun alt klasörü olarak dağıtılabilir 1 .

Kavram dosyası. Her kavram iki parçalı bir UTF-8 Markdown dosyasıdır: --- satırları arasında bir YAML başlık bloğu ve serbest bir Markdown gövdesi 1 . YAML'ın kendisi ayrı bir spesifikasyondur; güncel 1.2.2 revizyonu YAML'ı JSON'un katı bir üst kümesi yapmayı hedefliyor 13 . Bu yüzden JSON tırnaklı bir metin, geçerli bir YAML değeridir.

Tablodaki kurallar spesifikasyonun 4.1 bölümünden 1 . Gövde için zorunlu bir bölüm yok; ama # Schema, # Examples ve # Computation başlıklarının geleneksel anlamı var ve yapısal Markdown (başlık, liste, tablo, kod bloğu) düz metne tercih ediliyor 1 .

0.2'nin yeni alan aileleri. Hepsi isteğe bağlı; yoklukları da bir anlam taşır 1 .

Aktör kuralı. generated.by ve verified[].by alanları üç biçimden birini kullanır: araçlar ve ajanlar için <üretici>/<sürüm>, insanlar için human:<id>, otomatik süreçler için process:<id> 1 . Güven sınıflandırması human: önekine baktığı için, elle yazılmış ya da insan onaylı içerik bu öneki kullanmak zorundadır 1 .

Zaman damgaları. OKF'teki her zaman değeri, açık bir saat dilimi farkı taşıyan ISO 8601 tarih-saatidir: 2026-06-30T14:00:00Z gibi 1 . Yalnızca tarih (2026-06-30) yazmak, farklı saat dilimlerinde farklı anlara denk geldiği için geçerli değil.

index.md. Her klasörde bulunabilir ve ajanın dosyaları açmadan neyin olduğunu görmesini sağlar ("kademeli açılım"). Gövde, başlık altında * [Başlık](göreli-adres) - kısa açıklama satırlarından oluşur. index.md başlık bloğu taşımaz; tek istisna, paketin hedeflediği sürümü bildiren kök index.md'deki okf_version alanıdır 1 .

Bağlantılar. Kavramlar standart Markdown bağlantılarıyla birbirine bağlanır. Paket köküne göre mutlak yol (/tablolar/musteriler.md) önerilen biçimdir, göreli yol da geçerlidir. Hedefi olmayan bir bağlantı hatalı sayılmaz; henüz yazılmamış bir bilgiyi gösterebilir 1 .

Gerçek bir örnek: roicool.com'un OKF çıktısı

roicool.com'daki her sayfanın bir Markdown ikizi var: sayfanın adresine .md eklenen bir dosya. OKF paketi bu ikizlerden üretiliyor ve /okf/ klasöründe yayımlanıyor. Paketin kök dizini /okf/index.md, İngilizce dizin /okf/en/index.md. Aşağıdaki iki blok, sitenin kod tabanındaki üreticinin (Next.js uygulamasında lib/markdown) çıktısıdır; uzun listeler kısaltıldı.

Kök dizin, /okf/index.md:

---
okf_version: "0.2"
---

# Roicool

> Roicool, dinamik ve hedef odaklı markalar için dijitalde sürdürülebilir büyüme sağlar.

# Sayfalar

* [Ana sayfa](home.md)

# Bölümler

* [Hizmetler](hizmetler/index.md)

# Diller

* [English](en/index.md)

Bir kavram, /okf/hizmetler/geo-ajansi.md (kısaltılmış):

---
type: "Service"
title: "GEO Ajansı"
description: "Roicool, markaların ChatGPT, Gemini, Perplexity ve Google AI Overviews cevaplarında kaynak gösterilmesini ve önerilmesini sağlayan bir GEO (Generative Engine Optimization) ajansıdır."
url: "https://www.roicool.com/hizmetler/geo-ajansi"
lang: "tr"
dateModified: "2026-10-16"
resource: "https://www.roicool.com/hizmetler/geo-ajansi"
alternates:
  en: "https://www.roicool.com/en/services/geo-agency.md"
generated: { by: "process:roicool-cms", at: "2026-10-16T09:30:00.000Z" }
related:
  - { title: "AI görünürlük analizi", resource: "https://www.roicool.com/hizmetler/ai-gorunurluk-analizi.md" }
  - { title: "GEO uyumlu içerik", resource: "https://www.roicool.com/hizmetler/geo-uyumlu-icerik.md" }
---

# GEO Ajansı Roicool: Yapay Zekâ Cevaplarında Önerilen Marka Olun

Roicool, markaların ChatGPT, Gemini, Perplexity ve Google AI Overviews cevaplarında kaynak gösterilmesini ve önerilmesini sağlayan bir GEO (Generative Engine Optimization) ajansıdır.

## Hizmetler
…

Bu örnekte spesifikasyonun hangi kuralının nerede karşılandığı:

Blog yazılarında bir alan daha var: sources. Yazının numaralı "Kaynaklar" listesi başlığa - { id: "1", resource: "…", title: "…" } girdileri olarak yazılıyor. Böylece metindeki " 1 ." işareti ile id: "1" aynı kaynağı gösteriyor 1 .

OKF adım adım nasıl uygulanır?

Bir web sitesi için en kısa yol, OKF'i ayrı bir içerik olarak yazmak değil, mevcut içerikten üretmektir. Aşağıdaki sıra bizim izlediğimiz yol.

1. Kapsamı belirleyin. Pakete yalnızca yayımlanmış ve dizine eklenebilir sayfalar girsin. Taslaklar, noindex sayfalar, örnek veri taşıyan sayfalar ve iç notlar dışarıda kalsın. En pratik kaynak site haritasıdır.
2. Her sayfa için temiz bir Markdown sürümü üretin. Menü, alt bilgi ve çerez bandı olmadan; başlık, tanım, bölümler, tablolar ve SSS ile. llms.txt önerisinin .md uzantısı kuralı bu sürümler için iyi bir adres düzenidir 6 .
3. Bir type sözlüğü yazın. CMS koleksiyonlarını türlere eşleyin: hizmet, sektör, vaka çalışması, blog yazısı, sözlük terimi. Türler serbest metindir, ama sitenin içinde her tür tek bir yazımla geçmeli 1 .
4. Başlık bloğunu doldurun. type ilk satırda, ardından title, description ve resource. Sayfanın kanonik adresi iyi bir resource değeridir 1 .
5. Kaynak ve güncelliği ekleyin. generated: { by, at } ile dosyayı kimin ürettiğini ve içeriğin son anlamlı değişikliğini; kaynaklı içerikte sources ile dayanakları yazın. Doğrulama tarihi kaydetmiyorsanız verified yazmayın 1 .
6. Paket yollarını kurun. Paketi ayrı bir kökte (/okf/ gibi) yayımlayın ve index.md adını alan bir sayfa varsa yeniden adlandırın. Ayrılmış ad kuralı her klasör için geçerlidir 1 .
7. Her klasöre index.md üretin. Başlık altında * [Başlık](göreli-adres) - açıklama satırları; açıklama, kavramın description alanından gelsin 1 .
8. Kök dizine sürümü yazın. Yalnızca kök index.md'nin başına okf_version: "0.2" 1 .
9. Keşif ekleyin. Spesifikasyon keşif tanımlamadığı için bunu web'in kendi araçlarıyla yapın: llms.txt'den paket dizinine bir bağlantı, sayfa <head>'inde bir <link> öğesi ve robots.txt içinde bir izin satırı. llms.txt'nin 2. sürümü Markdown sürümleri için rel="alternate" type="text/markdown" ve llms.txt için rel="describedby" ilişkilerini, <link> öğesi ya da HTTP Link: başlığı olarak öneriyor 6 7 . HTTP Link: başlığının sözdizimi RFC 8288'de 11 , Markdown'ın text/markdown medya türü RFC 7763'te tanımlı 12 .
10. Doğrulayın ve tekrarlayın. Her içerik yayınından sonra paketi baştan sona gezen bir kontrol çalıştırın (aşağıdaki bölüm).

OKF, llms.txt, schema.org ve Markdown ikizleri: farkları

Dördü de "yapay zekâya içeriğinizi anlatmak" başlığı altında anılıyor, ama farklı katmanlarda çalışıyor.

Schema.org ve JSON-LD. Schema.org, web sayfalarında ve ötesinde yapılandırılmış veri şemaları oluşturan ortak bir topluluk çalışmasıdır; sözlüğü RDFa, Microdata ve JSON-LD ile kullanılabilir 10 . Google, yapılandırılmış veri için mümkünse JSON-LD'yi öneriyor 9 . Bu katman sayfanın içinde kalır ve arama motorunun sayfayı anlamasına hizmet eder. OKF bunun yerini almaz.

Markdown ikizi. Sayfanın tasarımsız metin sürümüdür. llms.txt önerisi bu sürümlerin sayfayla aynı adreste .md uzantısıyla sunulmasını öneriyor 6 . OKF kavramı, başlık bloğu eklenmiş bir Markdown ikizidir. Bu yüzden ikizleri olan bir site OKF'e en yakın sitedir.

llms.txt. Ajanların siteyi kullanması için kökte duran bir Markdown dosyası; kısa bir giriş ve ayrıntılı Markdown dosyalarına bağlantılar içerir 6 . llms.txt kendini bir öneri olarak tanımlıyor; 2. sürümü Ağustos 2026'da yayımlandı 7 . OKF'in kök index.md'si llms.txt'ye benzer bir iş görür, ama her klasörde tekrarlanır ve her girdinin arkasında tipli bir kavram vardır.

Sıralama önerimiz: önce schema.org ve sayfa içeriği, sonra Markdown ikizleri ve llms.txt, en son OKF. Her katman bir öncekinin üzerine kurulur.

OKF nasıl doğrulanır?

OKF'in uyumluluk kuralı kısadır. Bir paket şu üç koşulu sağlıyorsa 0.2 ile uyumludur 1 :

1. Ayrılmış adlar dışındaki her .md dosyası ayrıştırılabilir bir YAML başlık bloğu içerir.
2. Her başlık bloğunda boş olmayan bir type alanı vardır.
3. index.md ve log.md varsa 8. ve 9. bölümdeki yapıya uyar.

Tüketiciler esnek olmak zorundadır: eksik isteğe bağlı alanlar, bilinmeyen type değerleri, bilinmeyen anahtarlar, kırık bağlantılar ve eksik index.md dosyaları yüzünden bir paket reddedilemez 1 . Bu esneklik üreticiye bir hata payı tanımaz; hatalar sessizce kalır. Biz bu yüzden şunları ayrıca kontrol ediyoruz:

Bu kontrolleri, /okf/index.md'den başlayıp her bağlantıyı izleyen küçük bir Python betiğiyle yapıyoruz. YAML'ı ayrıştırmak için herhangi bir YAML 1.2 ayrıştırıcısı yeter 13 . Paketi görsel olarak denetlemek için OKF deposundaki referans görselleştirici de kullanılabilir: yerel bir paket klasöründen tek dosyalık etkileşimli bir grafik üretir 2 . Kopuk kavramlar ve yanlış türler grafikte hemen görünür.

Sık yapılan hatalar

• Bir kavrama index.md adını vermek. En sık rastlanan tuzak bu: web sitelerinde ana sayfanın Markdown sürümü genellikle /index.md'dir, ama OKF'te bu ad klasör dizinine ayrılmış 6 1 . Biz ana sayfaları pakette home.md olarak yayımlıyoruz.
• Alt klasör index.md'lerine başlık bloğu koymak. Başlık bloğu yalnızca kök index.md'de ve yalnızca okf_version için serbest 1 .
• Yalnızca tarih yazmak. stale_after: 2026-12-31 geçersiz; 2026-12-31T00:00:00Z geçerli 1 .
• Kaynakları gövdede bırakmak. 0.1'deki # Citations gövde listesinin yerini 0.2'de sources aldı 1 .
• Doğrulanmamış içeriğe verified yazmak. Güven sınıfı bu alandan türetiliyor; gerçek bir doğrulama olayı ve tarihi yoksa alanı hiç yazmayın 1 .
• Aynı türü iki farklı yazmak. "WebPage" ve "Web Page" bir tüketici için iki ayrı türdür. Kendi denetimimizde bu hatayı bir sayfada bulup düzelttik.
• Sitenin bir kısmını unutmak. Pakete yalnızca CMS kayıtlarını alıp koddan üretilen sayfaları atlamak kolaydır. Denetimimizde ücretsiz araçlarımızın ve marka kitimizin pakette olmadığını, bu sayfalara giden bağlantıların da başlık bloklarından düştüğünü bulduk.
• Taslakları ve noindex sayfaları pakete almak. Paket, HTML'de yayımlanmayan bir bilgiyi yayımlamamalı.
• OKF'i bir sıralama sihri olarak satmak. Google yapay zekâ özellikleri için ek dosya gerekmediğini açıkça yazıyor 8 . OKF'i görünürlük vaadiyle satan bir teklife şüpheyle yaklaşın.

Vaka: roicool.com'un OKF uygulaması

roicool.com'u yeniden kurarken her sayfa için bir Markdown ikizi zaten planlıyorduk. OKF 0.2 yayımlandığında karar basitti: ikizlere başlık bloğu ve klasör dizinleri ekleyip siteyi geçerli bir OKF paketi olarak da yayımlamak. Ayrı bir içerik yazılmadı; paket her istekte CMS'teki yayımlanmış içerikten üretiliyor.

Ne yayımlıyoruz?

Hangi türleri kullanıyoruz? CMS koleksiyonları türlere eşleniyor: Home Page, Service, Sector, Case Study, Project, Blog Post, Blog Category, Person, Glossary Term, Comparison, E-book, Podcast Episode, Job Posting, Press Mention, Partnership, Legal Page, Pricing Page, Collection Page (liste sayfaları) ve Tool (ücretsiz araçlar). Sitenin içinde her tür tek bir yazımla geçiyor.

Ajanlar paketi nasıl buluyor? Spesifikasyon keşif tanımlamadığı için üç yerde işaret bırakıyoruz. Her sayfanın <head>'inde <link rel="index" type="text/markdown" href="/okf/index.md"> var; index, IANA bağlantı ilişkileri kaydında tanımlı bir ilişki 15 . llms.txt'nin isteğe bağlı bölümünde paketin dizinine bir satır var. robots.txt'de /okf/ için açık bir izin ve dizin adresi yer alıyor. Sayfaların Markdown sürümleri ayrıca rel="alternate" type="text/markdown" ile işaretli 6 .

Bilerek yazmadığımız alanlar. verified yazmıyoruz, çünkü CMS bir inceleme tarihi tutmuyor ve güven sınıfı bu alandan türetiliyor 1 . stale_after ve log.md de yok: içerik her istekte yayımlanmış sürümden üretildiği için ikisi de şimdilik bilgi eklemiyor.

Denetimden çıkanlar (19 Ekim 2026). Paketi spesifikasyonun güncel sürümüne karşı yeniden denetledik. Format uyumluydu. İki hata bulup düzelttik: koddan üretilen sayfalar (araçlar, marka kiti) pakette yoktu ve bu sayfalara giden bağlantılar başlık bloklarından düşüyordu; bir sayfa da türünü diğerlerinden farklı yazıyordu. Blog yazılarına sources alanını ekledik ve doğrulama betiğine zaman damgası ile kaynak kontrollerini koyduk. Sıradaki adımlar arasında llms.txt 2. sürümünün describedby önerisi 7 ve paketin dışa aktarılabilir bir arşivi var.

Markanızın yapay zekâ cevaplarındaki yerini görmek isterseniz AI görünürlük analizi dört platformda temel çizgiyi çıkarır. Sayfalarınızın yapay zekâ tarafından alıntılanabilir biçimde yazılması için GEO uyumlu içerik, teknik katmanı da içeren sürekli çalışma için GEO ajansı sayfamıza bakabilirsiniz.