Agent kullanım kılavuzu

Agentlara kararlı rotalar, kararlı JSON ve net sonraki adımlar verin.

Bu sayfa agentların tarayıcı durumuna, gizli bağlama veya private panel erişimine ihtiyaç duymadan LogBrew'u nasıl okuması gerektiğini açıklar.

İlk güvenli okuma
logbrew status --json

Yerel status ile başlayın, sonra auth ve erişilebilirlik netleştiğinde logları, sorunları, aksiyonları, izleri, sürümleri ve projeleri okuyun.

Giriş noktaları

Öngörülebilir public URL'ler kullanın

Agentlar public LogBrew bağlamını kararlı lokalize sayfalar, Markdown aynaları, llms.txt, robots.txt ve sitemap.xml üzerinden bulmalıdır.

  • Düz metin en güvenli girdi olduğunda /en/agents.md kullanın.
  • Komut ve API rota bağlamı için /en/docs.md kullanın.
  • Public agent kaynaklarını keşfetmek için /llms.txt kullanın.

CLI toparlanması

Token güvenli status ile başlayın

CLI, token bilgisini göstermeden yerel auth, API erişimi ve toparlanma adımlarının hazır olup olmadığını agentlara anlatmalıdır.

  • Proje okumalarından önce logbrew status --json çalıştırın.
  • Tahmin etmek yerine JSON ve insan çıktısındaki sonraki adımları izleyin.
  • Token bilgisini promptlardan, loglardan, ekran görüntülerinden ve public sayfalardan uzak tutun.

Okuma yolları

Kaynak bazlı okumaları tercih edin

Agentlar logları, sorunları, aksiyonları, izleri, sürümleri ve projeleri insanların kullandığı aynı kaynak sözlüğüyle okumalıdır.

  • Sürüm, ortam, proje, iz, seviye, durum, ad ve kullanıcı filtrelerini kullanın.
  • Bir tanımlayıcı biliniyorsa sorun ve iz detay rotalarını kullanın.
  • Public bağlam için Markdown aynalarını, private proje verisi için kimliği doğrulanmış API'yi kullanın.

Sınırlar

Private veriyi auth arkasında tutun

Public agent yüzeyleri okunabilir kalmalı, panel ve proje verisi ise backend auth ve noindex metadata ile korunmalıdır.

  • Geçerli kullanıcı oturumu olmadan panel verisini taramayın.
  • Private proje adlarını, tokenları, izleri veya dağıtım detaylarını yayımlamayın.
  • Genel öğrenme için public sayfaları, kapsamlı kullanıcı verisi için kimliği doğrulanmış rotaları kullanın.