Memory Store'a genel bakış - AgentLoop - Alibaba Cloud Dokümantasyon Merkezi

AgentLoop Memory Store (MemoryStore), AI ajanlarının oturumlar arasında yeniden kullanabileceği gerçekleri, tercihleri ve iş bağlamını depolar. Konuşmaları API aracılığıyla yazabilir veya ajan izlerinden ya da bir Veri Kümesinden sürekli olarak girdiler alabilirsiniz. Memory Store, stratejilere dayalı olarak uzun süreli anıları çıkarır ve uygulama yeni bir soruyu ele aldığında ilgili bilgileri alır. Örneğin, bir kullanıcı yaşam tarzı asistanına önce "Hafif, az baharatlı yemeklerden hoşlanırım" der ve daha sonra "Son zamanlarda şeker tüketimini azaltıyorum" ifadesini kullanır. Memory Store bu tercihleri korumaya devam edebilir. Uygulama bir akşam yemeği önermeden önce, kullanıcının ilgili anılarını alır ve sonuçları mevcut soruyla birlikte ajana sunar.

Memory Store hangi sorunları çözer

Senaryo	Depolanabilen anılar	Kullanım şekli
Kişisel asistan	İlgi alanları, alışkanlıklar, iletişim tarzı ve uzun vadeli tercihler	Yeni bir oturum başladığında ilgili bağlamı alarak tekrarlanan soruları azaltın
Müşteri hizmetleri	Kullanıcıların sağladığı ürün kullanım geçmişi, hizmet talepleri ve iletişim tercihleri	Mevcut sorun için kullanıcı bağlamını tamamlayın
Kurumsal iş asistanı	Müşterilerin, projelerin veya iş nesnelerinin durumu ve ilişkileri	Sonraki görevlerde referans almak üzere mevcut bilgileri sonraki etkileşimlere göre güncelleyin
Geçmiş verilerin kullanımı	Toplanan izlerde ve hazırlanmış veri kümelerindeki yeniden kullanılabilir gerçekler	Her kayıt için yazma API'sini çağırmadan girdileri filtreleyin ve anıları sürekli olarak çıkarın

İş etkileşimleri devam ettikçe anılar birikir. Alma işlemi sırasında, kullanıcı, uygulama veya ajan gibi iş kapsamına bağlı olarak ilgili bilgiler seçilir. İzlenebilir olması gereken olaylar için bunları ekleme modunda depolayabilirsiniz. Zamanla değişen tercihler ve iş durumu için bunları birleştirme güncelleme modunda yönetebilirsiniz.

Temel kavramlar

Kavram	Açıklama
Memory Store	Bir ajan alanında oluşturulan ve yönetilen bir kaynaktır. Bir veri kaynağı, çıkarma stratejisi, depolama stratejisi ve uzun süreli anılar içerir.
Veri kaynağı	Anı çıkarma işlemi için giriş kaynağıdır; manuel yazma, ajan izleri ve Veri Kümesi dahil olmak üzere çeşitli kaynaklardan oluşur.
Uzun süreli anı	Daha sonra alınmak üzere girdilerden çıkarılan veya doğrudan yazılan içeriktir (örneğin, "Kullanıcı hafif yiyecekleri tercih eder").
Çıkarma stratejisi	Hangi gerçeklere odaklanılacağını, bunların nasıl kategorize edileceğini ve hangi içeriğin hariç tutulacağını belirler.
Depolama stratejisi	Yeni anıların eklenip eklenmeyeceğini veya mevcut anılara göre anıların eklenmesi, güncellenmesi, birleştirilmesi ya da silinmesi işlemlerini belirler.
İş kapsamı (scope)	Anıları kullanıcı ID'si, ajan ID'si, uygulama ID'si ve çalıştırma ID'si kullanarak ilişkilendirir. Alma işlemi sırasında belirtilen tüm koşullar kapsamı birlikte sınırlar.
Strateji sürümü	Çıkarma ve depolama gibi strateji yapılandırmaları kaydedildiğinde oluşturulan bir sürüm kaydını ifade eder. Yapılandırma değişikliklerini izlemek için kullanılır.
Geri çağırma (Recall)	Mevcut soruya ve iş kapsamına dayalı olarak ilgili anıları alır ve uygulamaya döndürür.

Bir veri kaynağı seçin

Veri kaynağı	Uygun senaryo	Hazırlanması gerekenler
Manuel yazma	Uygulama, bir konuşma sona erdikten sonra mesajları aktif olarak gönderebilir.	Yazma API'si, bir Memory Store API anahtarı ve kararlı iş kullanıcı tanımlayıcıları
Ajan izi	Ajan çalışma zamanı verileri zaten AgentLoop'a alınmıştır ve hazırlanmış izleri yeniden kullanmak istersiniz.	Mevcut ajan alanındaki ajan izleri ve hizmet adı ile ajan adı gibi filtre koşulları
Veri Kümesi	İş bilgileri, veri işleme yoluyla yapılandırılmış girdiler halinde düzenlenmiştir.	`MemorySourceV1` alan gereksinimlerini karşılayan, aynı ajan alanındaki bir veri kümesi

Memory Store oluştururken tek bir veri kaynağı seçin. Memory Store oluşturulduktan sonra veri kaynağı türü değiştirilemez. Veri Kümesi kaynağı kullanan bir Memory Store için de bağlı veri kümesi değiştirilemez. Farklı bir kaynak kullanmak isterseniz yeni bir Memory Store oluşturun.

Girdiden uygulama kullanımına

Girdileri alın: Uygulama konuşmaları gönderir veya Memory Store yapılandırılmış izlerden ya da Veri Kümesinden kayıtları alır.
Gerçekleri çıkarın: Korunacak bilgiler; gerçek çıkarma, tüketici kullanıcı profili, kurumsal dijital ikiz veya özel bir talimat temelinde çıkarılır.
Uzun süreli anıları yönetin: Sonuçlar, olay ekleme veya birleştirme güncelleme stratejisine göre depolanır; revizyonlar, kaynaklar ve stratejiler gibi bilgiler saklanır.
İlgili anıları alın: Uygulama veya konsol, mevcut soruyu ve iş kapsamını kullanarak anıları alır.
Ajan bağlamını oluşturun: Uygulama, faydalı anıları mevcut soru ve son konuşmalarla birlikte ajana sağlar.
Denetleyin ve ayarlayın: Örnek önizleme, anı düzenleme, denetim ayrıntıları ve istatistikleri kullanarak sonuçları kontrol edin ve ardından stratejileri ayarlayın.

Girdiler alındıktan sonra çıkarma ve uzun süreli anıya yazma işlemleri eşzamansız olarak işlenir. Uygulama, girdilerin alındığını, uzun süreli anıların alınabilir olduğunu ve döndürülen içeriğin ajan isteğine eklendiğini ayrı ayrı onaylamalıdır. Örnek önizleme, stratejilerin etkisini kontrol etmek için kullanılır ve resmi anılar yazmaz.

Konsol özellikleri

Giriş noktası	Yapabilecekleriniz
Memory Store Oluştur	"Veri kaynağı → Filtre / Şema → Strateji → Önizleme ve onay" sırasına göre yeni bir Memory Store yapılandırın
Genel Bakış	Temel bilgileri, veri kaynağını, tüketim ilerlemesini ve en son hatayı görüntüleyin. İz veya Veri Kümesi kaynakları için tüketimi duraklatın veya devam ettirin.
Uzun Süreli Anı Alma	Soru ve iş kapsamına göre anıları alın, anı içeriğini, revizyonları ve kaynakları görüntüleyin ve anıları düzenleyin veya silin
Strateji	Çıkarma ve depolama kurallarını, kapsamları ve denetim seçeneklerini yapılandırın, örnek önizlemeleri çalıştırın ve strateji sürüm geçmişini görüntüleyin
Yazma Olayları	Yazma olay günlüklerine sahip bir Memory Store için giriş olaylarını görüntüleyin
Denetim Ayrıntıları	Çıkarma, depolama ve geri çağırma ile ilgili olayları görüntüleyin ve geri çağırmanın ne döndürdüğünü izleyin
İstatistikler	Geri çağırma sayısı, boş olmayan geri çağırma oranı, gecikme süresi, çıkarma hunisi ve sıfır sonuçlu sorgular gibi ölçümleri görüntüleyin
API Anahtarı ve Entegrasyon	Erişim kimlik bilgilerini oluşturun ve mevcut bölge için HTTP API ve Python SDK entegrasyon örneklerini alın

Kullanım dikkat noktaları

Tanımlayıcıları tutarlı tutun: Yazma ve alma işlemleri için aynı iş tanımlayıcılarını kullanın. Birden fazla ID koşulu eklerseniz anıların bu koşulların tümünü karşılaması gerekir. Oturumlar arası sorgular için yalnızca tek bir çalıştırmaya ait olan bir çalıştırma ID'sini yanlışlıkla kullanmayın.
Gerçeklerin nasıl korunacağını seçin: Olay ekleme, bir sürecin geçmişini tutmak için uygundur; birleştirme güncellemesi ise değişen bilgileri yönetmek için daha uygundur. Bir stratejiyi değiştirmeden önce, temsilci örnekler kullanarak çıkarma sonuçlarını ve gerçekleştirilecek eylemleri kontrol edin.
Manuel revizyonları koruyun: Manuel düzenleme korumasını etkinleştirdikten sonra, otomatik çıkarma işlemi manuel olarak revize edilmiş içerikle karşılaştığında orijinal içeriği korur ve değişikliği incelemeye bekleyen olarak kaydeder.
Gerçek etkiyi değerlendirin: Geri çağırma puanları, boş olmayan geri çağırma oranı ve döndürülen sonuç sayısı geri çağırma davranışını yansıtır. Uygulama ayrıca döndürülen bilgilerin faydalı olup olmadığını ve ajanın bu bilgileri doğru kullanıp kullanmadığını belirlemelidir.

Kullanmaya başlayın

İlk kez entegrasyon yapıyorsanız Bellek deposu kullanma konusunu okuyun. Çıkarma kapsamını, depolama yöntemini veya saklama süresini ayarlamak için Anı çıkarma ve depolama stratejilerini yapılandırma bölümüne bakın. Sonuçları izlemek ve sorunları gidermek için Anı denetimlerini ve istatistikleri görüntüleme makalesini inceleyin.