LAB · AÇIK KAYNAK
Kod Örnekleri
Rehberlerde anlatılan erişimli üretim ve araç çağıran ajan mimarilerinin en küçük çalışır karşılıklarını tek bir ağaç altında toplayan derlemenin tasarımı. Her örneğin hangi kararı yalıttığı, neyin bilinçli olarak dışarıda bırakıldığı ve üretime taşınırken nelerin eklenmesi gerektiği ayrıca yazılır.
Durum
GeliştiriliyorBu projenin girdi tanımları, arayüz tasarımıyla birlikte yayımlanacak.
Kod Örnekleri henüz yayında değil
Bu proje geliştirme listesinde. Yayına girdiğinde bültenle duyurulacak; çalışan araçları Lab sayfasından görebilirsiniz.
Projenin içi
Kurulum, varsayımlar, ölçüm düzeni ve sınırlılıklar.
Kısa cevap
Rehberlerdeki mimarilerin en küçük çalışır karşılıklarını tek ağaç altında toplamayı planlayan bir derlemenin kapsam ve kurulum tasarımı — dizindeki örneklerden hiçbiri yazılmış değil.
Ne çözüyor?#
Rehber metni bir mimariyi anlatırken kaçınılmaz olarak ayrıntıyı atar, okuyucu da eksik parçayı kendi varsayımıyla doldurur. Bu derleme her rehber kararının yanına o kararı tek başına gösteren en küçük çalışır kodu koymayı hedefler. Örnekler birbirine benzemek için değil, kararları yalıtmak için bölünür: getirme sırasını gösteren örnek ajan döngüsünü göstermez. Her örneğin yanında neyin bilinçli olarak dışarıda bırakıldığı yazılıdır.
Bileşenler#
- Ortak çalıştırıcı: her örneği aynı komutla başlatan ince bir kabuk; örnekler kendi bağımlılık ağacını kurmaz
- Örnek dizinleri: her biri tek oturumda okunabilecek boyutta, kendi kısa açıklamasıyla
- Yapılandırma katmanı: sağlayıcı, depo ve günlükleme seçimleri örnek kodunun dışında toplanır
- Yerel veri kümesi: örneklerin koşması için yeterli, küçük ve lisansı açık bir metin kümesi
- Sözleşme testleri: örnek kodun rehberdeki adım sırasını izlediğini doğrulayan denetim
Örnek dizini#
| Örnek | Yalıttığı karar | Bilinçli olarak yok |
|---|---|---|
| Erişimli üretim iskeleti | Parçalama ve getirme sırasının cevaba etkisi | Yeniden sıralama katmanı |
| Getirme denetimi koşusu | Getirilen parçanın soruyu kapsayıp kapsamadığının ölçülmesi | İnsan etiketleyici akışı |
| Araç çağıran ajan döngüsü | Durma koşulunun ve adım bütçesinin nereye yazıldığı | Paralel araç çağrısı |
| Araç şeması doğrulaması | Modelin ürettiği çağrının şemaya karşı sınanması | Şema sürümleme ve geriye uyum |
| Yinelenen istek ve önbellek | Aynı isteğin iki kez sorulmasının nasıl engellendiği | Dağıtık önbellek ve geçersizleştirme |
Kurulum akışı#
- 1Kaynağı yerel makineye alma
Derleme yayımlandığında tek ağaç halinde alınır; her örnek kendi dizinindeki kısa açıklamayla başlar.
- 2Anahtarları çevreye yazma
Sağlayıcı anahtarları yalnızca ortam dosyasına girer. Örnek kodu anahtar tutmaz ve anahtar bulunamazsa açık bir hatayla durur.
- 3Veri kümesini hazırlama
Yerel metin kümesi indekse alınır; parçalama ayarı yapılandırmadan gelir, örnek koduna gömülmez.
- 4Tek örneği koşturma
Çalıştırıcı örnek adını alır ve o örneği yalıtılmış koşar; birden çok örneği zincirlemek tasarımın dışındadır.
- 5Çıktıyı okuma
Her koşu adımlarını sırayla yazar ve rehberdeki adım etiketlerini kullanır; böylece kod ile metin aynı yerden okunur.
Yapılandırmaya bırakılan kararlar#
| Karar | Seçenekler | Neye göre |
|---|---|---|
| Vektör deposu | Süreç içi bellek veya ayrı çalışan hizmet | Örneğin tek dosyada okunabilir kalması mı, üretime yakınlık mı öncelikli |
| Parçalama stratejisi | Sabit uzunluk, başlık sınırı veya cümle sınırı | Kaynak belgenin taşıdığı yapı |
| Model erişimi | Sağlayıcı istemcisi veya yerel ara katman | Anahtar yönetiminin nerede duracağı |
| Araç çağrısı onayı | Otomatik veya her çağrıda kullanıcı onayı | Aracın yan etkisi olup olmadığı |
| Günlükleme | Konsol veya yapılandırılmış kayıt dosyası | Örneğin derste mi, boru hattında mı koşacağı |
Üretime taşırken eklenecekler#
- 01Kimlik doğrulama ve yetkilendirme: örnekler tek kullanıcı varsayar
- 02Hata ve yeniden deneme politikası: örnekte ilk hata koşuyu durdurur
- 03Oran sınırı ve eşzamanlılık denetimi: örnekler sıralı tek istek üzerine kuruludur
- 04Kalıcı depolama ve göç düzeni: örnekteki indeks süreç sonunda kaybolur
- 05Gözlemlenebilirlik: adım günlüğü yetmez, izleme ve ölçüm eklenir
- 06Değerlendirme koşusu: çalışan bir örnek, çıktının doğruluğu hakkında bir şey söylemez
Kapsam dışı#
Derleme bir çatı katmanı değildir ve öyle kullanılmak üzere tasarlanmaz: örnekler birbirini çağırmaz, ortak bir soyutlama sunmaz. Ölçek, dayanıklılık ve güvenlik kararları bilinçli olarak dışarıda bırakılır, çünkü örneğin yalıttığı kararı gölgeler. Derleme bir sağlayıcı karşılaştırması da yapmaz; hangi modelin kullanıldığı yapılandırma ayrıntısıdır.
Aracın arkasındaki kavramlar
Hesaplayıcı bir kararı hızlandırır; kararın nedenini kavram girdileri anlatır.
- Large Language ModelsRetrieval-Augmented GenerationDil modelinin cevap üretmeden önce harici bilgi kaynaklarından ilgili bilgiyi getirip oluşturduğu bağlama eklediği yapay zekâ mimarisidir.
- AI AgentsAI AgentBir hedefi gerçekleştirmek için plan kuran, araç çağıran ve ara sonuçlara göre kendi adımlarını güncelleyen yapay zekâ sistemidir.
Uygulamaya geçmek için
- RAG · 7 adımKurumsal RAG mimarisi nasıl kurulur?Kurumsal RAG mimarisi; belge ayrıştırma, parçalama, gömme, dizinleme, yeniden sıralama ve değerlendirme katmanlarının erişim denetimi korunarak birleştirilmesiyle kurulur.
- RAG · 8 adımHibrit arama kurulumuHibrit arama, anlamsal benzerlik skorunu lexical eşleşme skoruyla birleştirip tek bir sıralama üretir.
Lab'dan
- AraçÇalışıyorAI ROI HesaplayıcıSüre tasarrufu ve hata azaltma üzerinden yatırım geri dönüşü tahmini.
- AraçÇalışıyorAjan Adım MaliyetiBir ajan döngüsünün adım sayısı, biriken bağlamı ve kendi fiyatlarınızla toplam token faturasını hesaplar. Adım sınırının neden bir maliyet kararı olduğunu ve bağlam penceresinin kaçıncı adımda dolduğunu görünür kılar.
- DeneyYakındaAjan Bellek Mimarisi DeneyiÖzetleme, vektör belleği ve kayan pencere yaklaşımlarını aynı uzun ajan görevinde karşılaştıran ölçüm düzeni. Bellek mimarisi seçimini karara bağlamak isteyen ekipler için, bilgi kaybının hangi turda başladığını görünür kılacak denetim noktaları üzerine kurulur.
- Açık KaynakYakındaAjan İzleme KitiAjan döngüsünün her turunu — araç çağrısını, dönen yanıtı ve büyüyen bağlamı — tek bir iz kaydında toplayan kit. Başarısız bir koşunun hangi adımda saptığını sonradan yeniden oynatarak görebilmek için kurulur.
- DemoYakındaAjan Plan Görünümü DemosuAjanın planını adımlar yürümeden önce gösteren, her adımın gerekçesini ve plan değişikliklerini iz bırakacak biçimde tutan arayüz taslağı. Müdahale ve geri sarma noktalarının nereye konması gerektiğini tartışır.
- DeneyYakındaAkıl Yürütme Bütçesi DeneyiDüşünme bütçesi kademe kademe yükseltildiğinde doğruluk kazancının nerede düzleştiğini arayan ölçüm düzeni. Bütçeyi görev türüne göre ayarlamak isteyen ekipler, ek bütçenin karşılığı olup olmadığını kendi görev kümesinde görebilir.
BUILD
Hesap tuttu, sıra uygulamada
Aynı hesabı kendi verinizle yapıp mimariyi kurmak için kurumsal destek alabilirsiniz.