Tüm Ürünler
Search
Belge Merkezi

AgentLoop:Bellek çıkarma ve depolama stratejilerini yapılandırın

Son Güncelleme:Oct 14, 2026

Çıkarma stratejisi, girdilerden hangi gerçeklerin korunacağını belirler; depolama stratejisi ise bu gerçeklerin uzun süreli bellekler olarak nasıl sürdürüleceğini tanımlar. Stratejileri oluşturma sihirbazında ayarlayabilir veya mevcut bir bellek deposunun Strategy sekmesine giderek yapılandırmayı değiştirebilir, örnekleri önizleyebilir ve sürüm geçmişini görüntüleyebilirsiniz.

Çıkarma stratejisini yapılandırın

Bir çıkarma ön ayarı seçin


Ön Ayar


Senaryo


Öneri


Fact extraction


Genel konuşmalardaki nesnel gerçekler ve tercihler


İlk doğrulama için bu ön ayarla başlayın.


Consumer user profile


Kişisel alışkanlıklar, tercihler ve uzun vadeli arka plan bilgileri


Farklı kullanıcıların bilgilerinin karışmasını önlemek için sabit kullanıcı kimlikleri kullanın.


Enterprise digital twin


Kurumsal müşteriler, iş durumu ve ilişkiler


İş nesnelerini ve korunacak bilgileri tanımlayın.


Custom instruction


Alana veya işe özel çıkarma kuralları


Özel talimat gereklidir. Çıkarma kapsamını ve dışlamaları belirtin.

Örneğin, bir yaşam tarzı asistanı aşağıdaki özel talimatı kullanabilir:

Extract long-term dietary preferences that the user explicitly states, including flavors the user likes and dislikes.
Do not record suggestions made by the assistant but not confirmed by the user as user preferences.
Do not generalize temporary requirements for the current order into long-term habits.

Özel bir talimat en fazla 8.000 karakter içerebilir. Talimat, çıkarma hedeflerini açıklar ancak iş kimliğini, erişim izinlerini veya kapsam yapılandırmalarını yerine koyamaz.

Kategoriler, dışlama kuralları ve model

  • Categories: Gerektiğinde preference ve profile gibi kategorileri belirtin. Kategori listesi boş değilse yalnızca listedeki kategorilere sahip olan gerçekler tutulur ve kategorisi olmayan sonuçlar da elenir. Kategorilerin beklentilerinizi karşılayıp karşılamadığını kontrol etmek için önizlemeyi kullanmanızı öneririz.

  • Exclusion rules: Geçici doğrulama kodları gibi çıkarmak istemediğiniz içeriği açıklayın. Uygulama, girdiler işlenmeden önce gerekli veri filtrelemesini yapmalıdır. Hassas bilgileri korumak için yalnızca model talimatlarına güvenmeyin.

  • Extraction model: Konsolda sunulan bir model seçeneği kullanın. Mevcut model qwen3.8-flash modelidir.

Depolama stratejisini yapılandırın

Event append

Çıkarılan her gerçek yeni bir bellek olarak eklenir; bu yaklaşım olay geçmişini tutmak için uygundur. Deduplication özelliğini etkinleştirdikten sonra aynı iş kapsamına, kaynağa ve gerçek anahtarına sahip yinelenen sonuçlar atlanır. Farklı kaynaklardan gelen benzer açıklamalar yine de ayrı ayrı depolanabilir.

Örneğin, aynı müşteri tarafından iki hizmet oturumu sırasında yapılan talepler daha sonraki izleme amacıyla ayrı ayrı tutulabilir.

Merge update

Sistem önce aynı iş kapsamındaki mevcut bellekleri arar ve ardından girdiye göre hangi eylemlerin yapılacağına karar verir. Bu mod, kullanıcı tercihleri ve müşteri durumu gibi değişen bilgileri sürdürmek için uygundur.


Yapılandırma öğesi


Açıklama


Merge key


Semantic similarity, içerik benzerliğine göre arama yapar. factKey, gerçek anahtarına göre arama yapar. factKey + semantic ise her iki yöntemi birleştirir.


Similarity threshold


Geçerli değerler: 0 ile 1. Varsayılan değer: 0,4. Bu eşik, ilgili mevcut bellekleri bulmak için kullanılır. Uygulama geri çağırması tarafından döndürülen sonuçlar için puan eşiği değildir.


Allowed actions


Otomatik olarak gerçekleştirilebilecek eylemleri seçin: ADD, UPDATE, MERGE ve DELETE. En az bir eylem seçili kalmalıdır.

factKey, belirli bir kullanıcının beslenme tercihleri gibi bir gerçek türünü tanımlar. Aşağıdaki tabloda eylemler açıklanmıştır.


Eylem


Açıklama


ADD


Bellek ekler.


UPDATE


Mevcut bir belleği günceller.


MERGE


İlgili bellekleri birleştirir.


DELETE


Yeni gerçeklere dayanarak artık geçerli olmayan eski bellekleri işler. Gerçek depolama işlemi, kayıt durumuna ve denetimlere tabidir.

Örneğin, yeni bir girdi "tatlı içecekleri sever" ifadesinden "artık şekersiz içecekleri tercih ediyor" ifadesine dönüşürse sistem bir güncelleme veya ekleme önerebilir. Gerçek eylem; kapsama, mevcut içeriğe, stratejiye ve çıkarma sonucuna bağlıdır. Otomatik değişikliklere izin vermeden önce önerilen eylemleri gözlemlemek için örnekleri kullanın.

Manuel düzenleme koruması ve saklama süresi

Manual edit protection varsayılan olarak etkindir. Otomatik çıkarma işleminin manuel olarak revize edilmiş bir belleği değiştirmesi gerekirse sistem mevcut içeriği korur ve değişikliği inceleme bekliyor olarak kaydeder. Belleğin inceleme durumu ve ilgili denetimler, yeni içeriğin neden doğrudan eski içeriğin üzerine yazmadığını belirlemenize yardımcı olur.

Expiration days negatif olmayan bir tamsayı olmalıdır. 0 değeri, belleklerin süresiz olduğunu gösterir. Pozitif bir değer, bundan sonra yazılan bellekler için saklama süresini ayarlar. Bu yapılandırmayı değiştirmenin tüm geçmiş kayıtları geriye dönük olarak temizlediğini varsaymayın.

İş kapsamını ve denetimi yapılandırın


Yapılandırma öğesi


Açıklama


Required scope for recall


userId, agentId, appId ve runId seçeneklerinden birini seçebilirsiniz. Bir istek, seçilen boyutlardan en az birini içermelidir. Bu parametre boş bırakılırsa ek bir gereksinim uygulanmaz.


Audit retention days


Geçerli değerler: 1 ile 180. Varsayılan değer: 30.


Query logging mode


Log Original Text, sorgu metnini depolar. Log HMAC Only, sorgu özetini depolar ve denetim sayfası orijinal sorgu metnini görüntülemez.


Log discarded candidates


Gerektiğinde, nihai olarak döndürülmeyen adayları kaydeder; böylece filtrelemenin hangi aşamada gerçekleştiğini analiz etmenize yardımcı olur.

İş kapsamı koşulları, sorgulanacak nesneleri kısıtlar; API anahtarları ise erişim kimlik doğrulaması için kullanılır. Uygulama, güvenilir bir iş bağlamından sorgulanabilen kimlikleri belirlemelidir. Bir sorgu birden çok kimlik sağlarsa tümünün eşleşmesi gerekir.

Denetim ayarlarının nasıl kullanılacağı hakkında bilgi için bkz. Bellek denetimlerini ve istatistiklerini görüntüleyin.

Stratejileri örneklerle kontrol edin

  1. Oluşturma sihirbazındaki Preview and Confirm bölümünde veya mevcut bir depodaki Strategy > Sample Preview alanında bir veya daha fazla örnek yapıştırın. En fazla 20 örnek yapıştırabilirsiniz.

  2. Run Preview seçeneğine tıklayın.

  3. Her örneğin Extracted Facts, Storage Action ve Skip Reason alanlarını kontrol edin. Gerçeklerin doğru olup olmadığına, kategorilerin gerekli bilgileri koruyup korumadığına ve beklenmeyen güncellemeler veya silme işlemlerinin gerçekleşip gerçekleşmediğine özellikle dikkat edin.

Aşağıdaki örnek, önizleme giriş kutusuna yapıştırılabilir. Önizleme, iş kapsamını temsil etmek için iç içe geçmiş scope alanını kullanır. Dataset kaynaklarının düz alan biçimi hakkında bilgi için bkz. Bellek deposu kullanma.

[
  {
    "sourceId": "preview-001",
    "scope": {"userId": "user-001"},
    "messages": [{"role": "user", "content": "I like light, mildly spicy home-style dishes"}]
  }
]

Trace veya Dataset kaynakları için örnekleri boş bırakabilirsiniz; bu durumda sistem yapılandırılmış veri kaynağından örnek veriler çeker. Manuel yazma kaynakları için örnekleri yapıştırmanız gerekir. Önizleme, mevcut formdaki yapılandırmayı kullanır ve önceden kaydetmenizi gerektirmez. Önizleme, resmi bellekleri yazmaz veya resmi çıkarma ve depolama için denetim kayıtları oluşturmaz.

Stratejiyi kaydedin ve sürümleri görüntüleyin

Önizleme sonucunu kontrol ettikten sonra Save Strategy seçeneğine tıklayın. Strateji kaydedildikten sonra Version History bölümünde mevcut sürümün strateji özeti ve oluşturma zamanı gibi bilgileri doğrulayın.

Sayfadaki Reset seçeneği, kaydedilmemiş form değişikliklerini atar ve şu anda kaydedilmiş yapılandırmayı geri yükler. Sürüm geçmişi, mevcut kayıtları görüntülemek için kullanılır. Bir stratejinin kaydedilmesi, tüm geçmiş verilerin otomatik olarak yeniden çıkarılmasına neden olmaz.