Ek · Bölüm 37
Yapay zekâ ajanları için
Bu dokümantasyonu bir öğrenme kaynağı olarak kullanan ajanlar için giriş haritası, makine okunur kaynaklar ve davranış sözleşmesi.
Bu bölüm bir insan için de okunabilir, ama asıl muhatabı sistemle çalışan yapay zekâ ajanlarıdır: Cowork'ün kendisi, kod yazan ajanlar ve dışarıdan bağlanan istemciler.
Giriş noktaları
| Kaynak | Nerede | Ne içerir |
|---|---|---|
search-index.json | yayımlanır | Aranabilir başlık ve gövde indeksi |
llms.txt | depoda, docs-private/ | Kitabın haritası: her bölüm, özeti ve adresi |
llms-full.txt | depoda, docs-private/ | Kitabın tamamı, tek düz metin dosyasında |
modules.json | depoda, docs-private/_data/ | Kurulu her modülün künyesi, modelleri, rotaları, test sayısı |
| Geliştirici modül referansı | depoda, docs-private/dev-reference/ | Aynı verinin insan okunur hâli |
Bir ajan için önerilen sıra: önce llms.txt ile haritayı al, sorunun hangi bölüme düştüğünü belirle, o bölümü oku. Tüm kitabı yüklemek gerekiyorsa llms-full.txt tek istektir.
Modül verisi kaynaktan üretilir
modules.json elle yazılmaz; kaynak ağacı taranarak üretilir. Her kayıt şunları taşır: teknik ad, sürüm, kategori, özet, bağımlılıklar, tanımladığı modeller, genişlettiği modeller, HTTP rotaları, test sayısı, satır sayısı.
Bu, bir ajanın "hangi modül neyi yapıyor" sorusunu tahminle değil veriyle cevaplamasını sağlar.
Sistemle çalışırken geçerli sözleşme
Cowork ve benzeri ajanlar için bağlayıcı kurallar:
- Yetki devri yoktur. Araçlar çağıran kullanıcının yetkisiyle koşar. Bir ajanın kendi yetkisi yoktur ve olmamalıdır.
- Dosya adı içerik kanıtı değildir. Bir eşleşmenin adından mı içerikten mi geldiği ayrı raporlanır.
- Söz, araç çağrısıyla tutulur. Metinde verilen ve karşılığında eylem bulunmayan taahhütler yakalanır.
- Yazma işlemleri geri alınabilir kaydedilir. Değişikliğin farkı saklanır.
- Dış ağa çıkış tek kapıdan geçer ve denetlenir; sertifika doğrulaması atlanamaz.
- Bilinmeyen, sıfır değildir. Fiyatı bilinmeyen model "ücretsiz" değil "fiyatlandırılmamış"tır; fiyatı girilmemiş ürün
0,00değil "fiyatlandırılacak"tır.
Bu sistem hakkında iddiada bulunurken
36. bölümdeki on hata sınıfı, aynı zamanda bir ajanın kendi çıktısını denetleme listesidir. Özellikle üç tanesi ajan üretimi metinlerde sık görülür:
- Sınıf 1 — ölçtüğünü sandığın şeyi ölçmemek. Bir aracın döndürdüğü sonuç, sorulan sorunun cevabı olmayabilir.
- Sınıf 2 — sessiz başarısızlık. Boş dönen bir arama "kayıt yok" demek değildir; "aramam kayıt bulamadı" demektir ve ikisi farklıdır.
- Sınıf 8 — dürüstlük kapısı. Bilmediğini söylemek, akıcı bir tahminden değerlidir.
Terminoloji
Sistemin kendi sözlüğü 38. bölümde. İki not:
- Ürün adları markadır: SODOO (sistem), SODOOC (ofis katmanı), Cowork (yapay zekâ), SOTION, SODRAW. Bunlar çevrilmez.
- Kullanıcıya görünen metinlerde "Odoo" değil "SODOO", "ONLYOFFICE" değil "SODOOC" yazılır.
Bu dokümantasyon nasıl güncelleniyor
Kitap Markdown kaynaklardan derlenir; derleyici HTML'i, arama indeksini, llms.txt ve llms-full.txt dosyalarını birlikte üretir. Modül referansı ayrı bir üretici tarafından kaynak ağacından oluşturulur.
Yani bir bölümü güncellemek, kaynağı düzenleyip derleyiciyi çalıştırmaktır; üretilen dosyaların elle düzenlenmesi bir sonraki derlemede kaybolur.