Bağlam boyutu

Seçili bağlam ve sağlayıcı rehberi kaynak paketlerini, tam ham çıktı kurtarmayı, açık model profillerini ve isteğe bağlı aday worker işlemlerini anlatır. Bu komutlar yayımlanmış CLI içindedir; önce kurulu sürümü ve ilgili yardım çıktısını kontrol edin.

token estimate

Görevden önce dosyalar veya açık stdin ile seçilmiş bilinen metni, bee token estimate komutuyla tahmin edin. Token ön kontrol kılavuzu, bağlam seçimlerini karşılaştırmayı, --calls ile aynı girdiyi tekrarlamayı, çıktı bütçesi ayırmayı ve --limit 0 ile toplamları korumayı gösterir. Bee 1.0.0-beta.16 veya üzeri gerekir.

Bağlamı seçin, tahmin edin, yeterliliğini inceleyin ve görevi ayrıca yürütün. Küçük seçim tek başına kalite veya tasarruf kanıtlamaz. Sonrasında açıkça seçilmiş desteklenen günlük için aşağıdaki ölçülmüş kullanım akışını kullanın; ön kontrol sayıları gerçek çıktıyı, akıl yürütmeyi, önbellek kullanımını veya sağlayıcı tüketimini göstermez.

budget –by-item

bee budget "catalog validation" --path src/Catalog/Product.cs --by-item --json

Örnek bir prompt için Bee’nin oluşturacağı bağlamı önizleyin. --by-item, her kuralı, hafızayı ve diğer öğeleri gerçek UTF-16 karakter katkısına göre listeler. Bölüm başlıkları ve bağlamı çevreleyen işaretler ayrıca hesaplanır. Öğelerin içeriğini tekrar yazdırmaz. Bu komut Bee kurulumu ve yapılandırılmış MongoDB gerektirir.

Token tahmini ceil(UTF-16 karakter / 4) hesabıdır; model kullanım veya faturalandırma kaydı değildir. Öğeler ayrı yuvarlandığından tahminlerinin toplamı genel toplamdan farklı olabilir. Bütçe önizlemesi teslim kaydı oluşturmaz.

context audit

bee context audit --from AGENTS.md --against docs --root . --json

Açıkça seçilen Markdown kaynağını bir dosya veya dizinle karşılaştırın. Denetim dosya hash’lerini, boyutları, kaynak bölümlerinin konumlarını ve normalize edilmiş tekrar adaylarını gösterir. Yapılandırma ve MongoDB erişiminden önce çevrimdışı çalışır; kaynak dosyaları değiştirmez.

Kaynak envanteri tekrar olmasa da gövdesi en büyük olandan başlayarak en fazla 200 bölümü listeler. Gövde sayıları normalize metni ölçer; başlıklar ve sınır karakterleri özgün dosya boyutundan ayrı hesaplanır.

En az 64 normalize karakter içeren birebir bloklar tekrar adayıdır. BOM ve satır sonları normalize edilir; paragraf sınırları ve ATX başlıkları eşleştirmeye katılmaz. Diğer boşluklar, kod, harf büyüklüğü ve noktalama korunur. Eşleşme, bir yükümlülüğün güvenle silinebileceğini kanıtlamaz.

Okuma ve çıktı sınırlandırılmıştır. Yollar seçilen kökün içinde kalmalıdır; sembolik bağlantılar ve normal olmayan dosyalar reddedilir. Okunamayan, değişen veya sınırı aşan girdi eksik rapor üretir. macOS’ta /tmp bağlantısı yerine /private/tmp gibi fiziksel yolu kullanın.

Çıkış kodları: 0 tamamlandı, aday yok; 1 tamamlandı, aday var; 4 geçersiz argüman; 5 eksik analiz. Raporu kapsamlı kabul etmeden gösterilmeyen sonuç sayılarını kontrol edin.

test summarize

bee test summarize TestResults/results.trx --json

Mevcut bir TRX test raporunu, XML’in tamamını ajanın bağlamına taşımadan okuyun. Bee toplamları, tek tek başarısız testleri, sınırlı hata ayrıntılarını ve raporun hash’ini gösterir. Test çalıştırmaz, ek dosyaları okumaz ve servise bağlanmaz; kurulum veya MongoDB gerektirmez. İlk okuyucu düz sonuçlar içeren UTF-8 TRX dosyalarını kabul eder; iç içe InnerResults açıkça desteklenmiyor olarak belirtilir ve eksik rapor üretir.

Ayrıştırmanın eksiksiz olması ile test sonucu ayrı bilgilerdir. Bozuk, yarım kalmış veya desteklenmeyen rapor başarı kanıtı değildir. Hiç test içermeyen rapor da başarılı sayılmaz. Test sürecinin özgün çıkış kodu bilinmez: komut seçilen raporu anlatır, mevcut checkout’un yeniden doğrulandığını göstermez.

Varsayılan çıktı yalnız başarılı olmayan testlerin ayrıntılarını gösterir. Başarılı testleri de görmek için --include-passed kullanın. --limit kayıt sayısını, --budget çıktı karakterlerini sınırlar; sınır nedeniyle gösterilmeyen sonuçlar ile bilerek dışarıda bırakılan başarılı sonuçlar ayrı sayılır.

Aynı adlı sonuçların ayrı çalıştırma kimlikleri korunur. Uzun hata metinlerinin kısaltıldığı ve sonuçların gösterilmediği açıkça belirtilir. Ham raporu okuma kararını bu bilgilere göre verin; özet bütün XML’i veya yakalanan standart çıktıyı tekrar üretmez. Sınırlar ve çıkış kodları için bee test summarize --help kullanın.

Daha küçük bir yanıt seçin

Ajanın bütün kaynakları, günlükleri ve raporları okumadan kanıt edinmesi gerektiğinde bu araçları kullanın. Aşağıdaki çevrimdışı örnekler temsili veri kullanır. budget --by-item yapılandırılmış depoyu gerektirir; ölçülmüş sağlayıcı kullanımı değil, tahmindir.

Çıktı	Sınır ve birim	Kontrol edilecek alan
graph outline --compact --budget N	Varsayılan 12.000; 2.048–65.536 UTF-16 kod birimi; son satır sonu hariç	Sütun satırları bildirim alanlarını korur; counts, omittedMetadata, güncellik ve kapsam
Graf ilişkilerinde --output-budget-chars N	En az 256 UTF-16 kod birimi; son satır sonu dahil; --json gerekir	output.omittedItems, omittedByPath, legacyComplete ve sorgu kırpılması
test summarize --budget N	Varsayılan 16.000; 2.048–65.536 UTF-16 kod birimi; son satır sonu hariç	Döndürülen/atlanan kayıtlar, dışlanan başarılı sonuçlar ve kısaltılan tanılar
code runs list/show --budget N	Varsayılan 16.000; 2.048–65.536 UTF-16 kod birimi; son satır sonu dahil	Bütünlük, asıl analiz sonucu ve atlanan kayıtlar

UTF-16 birimi UTF-8 baytı veya sağlayıcı token’ı değildir: A bir birim, birçok emoji iki birim kullanır. Eski graf sorgusu --budget, nominal token başına üç karakter kullanır ve tüm JSON yerine sorgu sonucunu sınırlar. Outline’ın karakter bütçesiyle karıştırmayın. Zorunlu meta veri sığmazsa tüm çıktı bütçesi çıkış 4 üretir; eksik yanıtı kabul etmek yerine bütçeyi artırın.

Kompakt outline, result.columns ve result.idPrefix alanlarını paylaşır; tam kimlik = önek + satır eki. Tekrarlanan yapı azalırken bildirim alanları korunur. İlişki sorgularındaki --compact ise açıklayıcı liste alanlarını çıkarır. Hiçbiri daha düşük ücret veya daha hızlı sorgu garantisi vermez. Gerçek outline’dan satır seçmek için kodlama örneğini izleyin.

Güncelliği varsaymadan yeniden kullanın

Graf yerelde saklanır; --no-refresh yoksa ilişki sorguları graf oluşturabilir/güncelleyebilir. Outline hiçbir zaman güncellemez. Derleyici analizini kaydetmek açık bir seçimdir:

bee code analyze --engine roslyn --save-run --json
bee code runs list --json --limit 10 --budget 4096
bee code runs show <run-id> --json --limit 20 --budget 8192

Dönen runId değerini kullanın. show çıkış 0, analysisExitCode 1 veya 5 olsa bile kayıtlı dosyanın okunduğunu gösterir. integrity: verified, bugünkü kaynak/araç/ayar eşleşmesini değil kayıtlı baytları denetler. İlgili değişikliklerden sonra yeniden analiz edin; analiz geçmişine bakın. Kayıt okumak analizi yeniden çalıştırmaz; sağlayıcının prompt önbelleğini kullandığını kanıtlamaz.

Tek günlükten ölçülmüş kullanım

Desteklenen yerel Codex günlüğü ve tam yerel thread UUID’si elinizdeyse kullanın. Başlatma veya servis gerekmez. İki satırlık temsili rollout.jsonl, desteklenen sayaç biçimini gösterir:

{"timestamp":"2026-09-22T12:00:00Z","type":"session_meta","payload":{"id":"11111111-1111-4111-8111-111111111111","cli_version":"0.155.0","originator":"codex_exec"}}
{"timestamp":"2026-09-22T12:00:01Z","type":"event_msg","payload":{"type":"token_count","info":{"total_token_usage":{"input_tokens":100,"cached_input_tokens":60,"output_tokens":20,"reasoning_output_tokens":5,"total_tokens":120},"last_token_usage":{"input_tokens":100,"cached_input_tokens":60,"output_tokens":20,"reasoning_output_tokens":5,"total_tokens":120},"model_context_window":258400}}}

bee budget --measured --harness codex --session 11111111-1111-4111-8111-111111111111 --log rollout.jsonl --json

Örnek çıkış 0 ve schema 2 döndürür: history.latest.cumulative içinde input 100, cached input 60, uncached input 40, output 20 ve total 120 bulunur. Reasoning 5, output’un alt kümesidir; cached input zaten input’a dahildir. Response akışı boştur. cost, requestCount, usage ve lastRequestUsage null’dır. Bu sayılar tasarruf ölçümü değildir.

response ve history ayrı tutulmalıdır; akışları, anlık görüntüleri veya segmentleri toplamayın. context_estimate, context_window_synthesis ve history_with_estimated_baseline, tahmini geçmiş tabanlarını açıkça etiketler. Sayısal tutarlılık ücretlendirmeyi, tüm isteklerin kaydını, modelin dikkatini veya Bee kaynaklı tasarrufu kanıtlamaz. complete verilen dosya anını tanımlar; oturumun bittiği bilinmez ve alt thread’ler otomatik dahil edilmez.

Üç seçici de zorunludur. Yalnızca desteklenen Codex kayıt biçimleri kabul edilir; diğer ajan ortamları çıkış 5 üretir. Yanlış thread, değişen/bozuk girdi ve desteklenmeyen kayıtlar eksik (5), yanlış seçenekler geçersizdir (4). Fiziksel normal dosya yolu kullanın; üst dizinlerdeki sembolik bağlar da reddedilir. Sınırlar dosya başına 32 MiB, satır başına 4 MiB, 100.000 satır ve 10.000 kullanım gözlemidir. Kesilmiş son satır, önceki gözlemler korunsa bile 5 üretebilir.

Başarısız test dosyasını okuyun

Bu temsili UTF-8 raporu failure.trx olarak kaydedin. Bir başarısızlığı tarif eder; çalıştırılmış test takımından alınmamıştır:

<TestRun id="33333333-3333-4333-8333-333333333333" xmlns="http://microsoft.com/schemas/VisualStudio/TeamTest/2010">
  <Results><UnitTestResult testId="11111111-1111-4111-8111-111111111111" executionId="22222222-2222-4222-8222-222222222222" testName="PriceTests.Total" outcome="Failed"><Output><ErrorInfo><Message>Expected 42; got 41.</Message></ErrorInfo></Output></UnitTestResult></Results>
  <ResultSummary outcome="Failed"><Counters total="1" executed="1" passed="0" failed="1" error="0" timeout="0" aborted="0" inconclusive="0" passedButRunAborted="0" notRunnable="0" notExecuted="0" disconnected="0" warning="0" completed="0" inProgress="0" pending="0"/></ResultSummary>
</TestRun>

bee test summarize failure.trx --limit 5 --budget 8000 --json

Sonuç parserStatus: complete, testVerdict: failed, bir kayıt ve çıkış 1 içerir. Tanı “Expected 42; got 41.” olur. producerExitCode null kalır. Run ID’yi kaldırmak desteklenmeyen biçim ve incomplete/5 üretir. Özet hash’i verilen baytları tanımlar; kaynağını veya güncelliğini değil.

Yukarıdaki context audit örneği, tamamlanmış incelemede tekrar adayları varsa 1 döndürür; totalFindings, returnedFindings, omittedFindings alanlarını inceleyin. Silmeden önce talimatın her iki yerde de gerekli olup olmadığını değerlendirin. Gereksiz kural iletimini azaltmak için davranış akışına geçin.

Kapsam raporunu inceleyin (beta.14)

Test çalıştırması bir kapsam dosyası ürettiyse ve sırada hangi kaynak satırlarını inceleyeceğinizi seçmek istiyorsanız kullanın. Bee 1.0.0-beta.14 veya üstü ve mevcut bir Cobertura, OpenCover ya da LCOV raporu gerekir. Başlatma, veritabanı veya model sağlayıcısı olmadan çevrimdışı çalışır. Küçük bir örnek için bu temsili raporu coverage.lcov olarak kaydedin; src/Calculator.cs rapordaki bir etikettir, ayrıştırma için dosyanın var olması gerekmez.

SF:src/Calculator.cs
DA:10,3
DA:11,0
LF:2
LH:1
BRDA:10,0,0,3
BRDA:10,0,1,0
BRF:2
BRH:1
end_of_record

bee code coverage import coverage.lcov --format lcov --json

Sonuçta status: complete, exitCode: 0 ve boş issues listesi bulunur. files içindeki src/Calculator.cs kaydının lines ve branches ölçümleri state: known, total: 2, covered: 1, percent: 50 değerlerini taşır. Bunlar ayrı ölçümlerdir: lineData, 10. satırda üç, 11. satırda sıfır çalıştırma; branchData, 10. satırda çalıştırılmış bir dal ve çalıştırılmamış bir dal gösterir. Bu inceleme kaynak dosyası açmadan veya test çalıştırmadan üretilir.

Gözlemleri kullanmadan önce status ve issues alanlarını okuyun. Eksik ölçüm unknown ve null yüzde; açıkça sıfır payda not-applicable ve yine null yüzde demektir. İkisi de %100 anlamına gelmez. Çıkış 0 yalnızca desteklenen alt kümede ayrıştırmayı gösterir; kapsam eşiğini veya güvenilir QA kabulünü değil. Çıkış 4 geçersiz kullanım; çıkış 5 eksik, güvensiz, desteklenmeyen, çelişkili veya sınırı aşan girdidir. Bozuk veya güvensiz girdide yalnız hata nesnesi dönebilir. Eksik raporda gözlemler korunmuşsa bunları tamamlanmış kapsam saymayın.

Girdi en fazla 8 MiB boyutunda, yolunun hiçbir yerinde sembolik bağlantı bulunmayan normal bir UTF-8 dosyası olmalıdır. Uygun --format seçin; ayrıştırma başarısızsa error veya issues alanını okuyun. Desteklenen alt kümede dışa aktarılmış rapor kullanın; yalnız çıkış 0 almak için çelişkili kayıtları silmeyin. Örneğin DTD içeren XML desteklenmez. Bee sonucu stdout’a yazar; import geçmiş kaydetmez, çalıştırmaları birleştirmez, kaynak okumaz veya test çalıştırmaz. Okuma, ayrıştırma ve çıktı sınırları vardır.

Baytlarını tanımlamak için rawSha256 değerini asıl raporla birlikte saklayın. --source-revision ve --source-snapshot gibi seçenekler doğrulanmamış beyanlardır: sourceBinding, not-established; checkedSource, not-read; qaAcceptance, not-assessed kalır. Bunlar güncel kaynakla eşleşmeyi veya yeni kod kapsamını belirlemez.

Ajanın sonraki adımı için önce raporun hangi kaynak revizyonundan üretildiğini belirleyin. Ardından raporlanan dosyada çalıştırılmamış satır için 11. satırı, dal davranışı için 10. satırı inceleyin. İlgili bildirimleri ve çağıranları seçmek için kodlama akışını kullanın; kapsamı yeterli doğrulamalar veya tüm depo dosyalarıyla bir tutmayın. Test sonuçlarını ve çalıştırıcının asıl çıkışını test özetleriyle ayrı saklayın. beta.14 notları, üç biçimin komutlarını ve tüm beyan seçeneklerini gösterir.