afrom letta import Client, Agent, Tool
client = Client(api_key=os.environ.
## Letta ADE Kullanımı (Kodsuz/Düşük Kodlu Yol)
Görsel prototip oluşturmayı tercih ediyorsanız, ADE kod yazmadan ajanları, hafızayı ve araçları bir araya getirmenizi sağlar.
- ADE’de yeni bir ajan projesi başlatın.
- Ajanın rolünü (sistem komutu), tonu, sınırları tanımlayın.
- Hafıza kalıcılığı ve getirme stratejilerini yapılandırın.
- Bağlayıcılardan seçim yaparak ya da özel eylemler tanımlayarak araç ekleyin.
- Konuşmaları satır içinde test edin, hafıza yazımlarını gözlemleyin, eşik değerlerini ayarlayın.
- Prototipiniz doğru çalıştığında dışa aktarın veya geliştiricilere devredin.
ADE duyurusu ve öğretici ile kısa bir tanıtım videosu için bakabilirsiniz.
## Harika Letta Ajanları Tasarlamak: Görüş Bazlı En İyi Uygulamalar
1) Yapalım işini tanımlayarak başlayın
- Belirgin bir kapsam belirleyin (örneğin, “web hataları için destek taleplerini önceliklendirme”) - belirsiz genelci olmasın.
2) İşleyiş prosedürlerini kodlayın
- SOP’lerinizi sistem komutuna koyun. Örnek: “Önceliklendirme üretim etkisi olursa, yükselt ve priority=high ayarla. Varsa tekrar üretim adımlarını da daima ekle.”
3) Araç şemalarını sıkı tutun
- Enum ve zorunlu alanları zorunlu kılın. Bu, hayal edilen parametreleri azaltır.
4) Hafızayı bir ürün yüzeyi gibi yönetin
- Nelerin hatırlanması gerektiğine (iletişimler, tercihler, önceki çözümler) ve nelerin geçici olduğuna (tek seferlik hesaplamalar) karar verin. Hafıza izlerini düzenli kontrol edin.
5) Gerçek verilerle test edin
- Ajanı anonimleştirilmiş destek talepleri, dokümanlar ve örneklerle besleyin. Hatalı durumları gözlemleyin (bağlam eksikliği, yanlış öncelik) ve promptları/araçları iyileştirin.
6) Koruyucu önlemler, sonrası temizlikten iyidir
- Araçlara doğrulama ekleyin. Ajan geçersiz girdiler önerirse, yöneticiniz bunları yakalayıp rehberlik sunmalı.
7) Her şeyi izleyin
- Araç çağrılarını, hafıza yazımlarını ve mesaj bazlı telemetriyi kaydedin. Başarı oranı, çözüm süresi gibi kilit metrikler için panolar oluşturun.
8) Ajanlarınızı versiyonlayın
- Promptlarda, araçlarda ve hafıza politikalarında yapılan değişiklikleri takip edin. Bilinen iyi versiyonları üretimde kullanın, geliştirmeleri aşamalarda deneyin.
## Letta ile Gönderebileceğiniz Yaygın İş Akışları
- Müşteri Desteği
- Konuşmaları özetleyin, çözüm önerin, talepler oluşturun, ilgilileri bilgilendirin.
- Araştırma Asistanı
- Sorguları planlayın, kaynakları arayın, sentezleyin, kaynak notlarını hafızaya kaydedin.
- Satış/Müşteri Başarı Operasyonları
- Çağrı notlarını ayrıştırın, sonraki adımları çıkarın, araçlarla CRM güncelleyin, e-posta şablonlarıyla takip edin.
- İç Otomasyon
- Kuyrukları izleyin, çalışma kitaplarını tetikleyin, durum güncellemeleri yapın ve vardiyalar arasında bağlamı koruyun.
## Sorun Giderme: Beklenmeyen Davranışlar
- Ajan unutkan davranıyor
- Hafıza etkin mi ve alma eşikleri doğru mu kontrol edin. Öğelerin gerçekten kalıcı hale getirilip getirilmediğini inceleyin.
- Araç çağrıları hatalı
- Şemaları sıkılaştırın, enumlar ekleyin, hata mesajlarını yapılandırıp rehberlik sunun.
- Ajan çok uzun veya çok kısa cevap veriyor
- Sistem komutu stil rehberini ayarlayın, 2-3 satır içi örnek sağlayın.
- Çelişkili talimatlar
- İş kurallarınızı konsolide edin. Açık öncelikler kullanın: “Her zaman X’i Y’den önce yap.”
- Güncellemeler sonrası sapmalar
- Üretimde versiyon kilidi uygulayın. Yenilikleri kademeli (canary) açın.
## Güvenlik ve Uyumluluk Hızlı Notlar
- Araçları güvenilen kod yolları gibi ele alın—doğrulama ve kapsam belirleyin.
- Hafıza izlerini kaydetmeden önce hassas verileri gizleyin.
- Hafızada Kişisel Tanımlayıcı Bilgiler (PII) için saklama politikaları, erişim kontrolleri ve şifrelemeyi dikkate alın.
## Prototipten Üretime: Kısa Kontrol Listesi
- Ajan için net OKR’ler (başarı nedir?).
- Dar kapsam ve SOP odaklı sistem komutu.
- Doğrulama ve testleri olan sıkı araç şemaları.
- Gerçek görevlerle dokümante edilmiş ve doğrulanmış hafıza stratejisi.
- İzlenebilirlik (loglar, metrikler, uyarılar) kurulumu.
- Versiyonlama ve geri dönüş planı.
- Ayrı staging ve üretim ortamları.
## Ek Öğrenme Kaynakları
- Tanıtım videosu: İlk kalıcı ajanınızı oluşturun.
- Kod parçacıkları ile hızlı başlangıç (Python/TS).
- Ajan mimarisi ve en iyi uygulamalar.
- ADE duyurusu ve anlatım.
- Paket yeniden adlandırma ve uyumluluk notları.
- Açık kaynak depo ve arka plan bilgisi.
## Bu arada: [Sider.AI](https://sider.ai) ile Daha Hızlı Yineleme
Eğer promptları dokümante ediyor, örnekleri test ediyor veya ajan versiyonları arasında çıktıları karşılaştırıyorsanız, yan yana artefakt tutup hızlı iterasyon yapmak faydalıdır. Unutmamak gerekir ki [Sider.AI](https://sider.ai) (https://sider.ai/) ekiplerin promptlar, notlar ve farkları tutmasına yardımcı olur—özellikle birden çok kişinin SOP'yi iyileştirmesi veya araç şemalarını değerlendirmesi durumunda.
## Önemli Çıkarımlar
- Letta, hafıza, araçlar ve kalıcı durumla stateful ajanlar oluşturmanıza yardımcı olur.
- Stabilite için dar kapsam ve sıkı şemalarla başlayın.
- Kod odaklı iş akışları için SDK'yı, görsel prototip için ADE'yi kullanın.
- Canlıya geçmeden önce gerçek verilerle izleyin, versiyonlayın ve test edin.
- Resmi hızlı başlangıç ve ajan kılavuzları ile en iyi uygulamalara uyun.
### SSS
S1: Letta nedir ve sıradan bir chatbot'tan farkı nedir?
Letta, kalıcı hafıza ve araç orkestrasyonu olan stateful AI ajanları oluşturmak için bir platformdur, sadece stateless sohbet arayüzü değildir. Ajan durumu depolar, araç şemalarını zorunlu kılar ve oturumlar arasında hafızayı yönetmenizi sağlar.
S2: Letta'yı hızlıca nasıl kullanmaya başlayabilirim?
İlk ajanın oluşturulması ve araçların eklenmesi için Python veya TypeScript geliştirici hızlı başlangıcını takip edin. Görsel yol tercih ederseniz, ADE ile hafıza, promptlar ve araçları yapılandırıp dışa aktarabilirsiniz.
S3: Letta kullanıcı tercihlerini ve geçmiş görevleri hatırlayabilir mi?
Evet. Letta, ajanların tercihler, kararlar ve sonuçları hafızada tutmasını ve gelecekteki etkileşimlerde bağlamsal şekilde getirmesini destekler. Hafıza politikalarını konfigüre edip gerçek görevlerle doğrulayın.
S4: Letta ajanlarındaki araçlar nasıl çalışır?
Ajana güvenilir şekilde çağrı yapması için sıkı giriş şemalarına sahip fonksiyonlar kaydedersiniz. Doğrulama ekleyin, enumları kullanın ve hatalı girişlerde yapıcı rehberlik için yapılandırılmış hatalar döndürün.
S5: Letta MemGPT ile aynı mı?
Letta, MemGPT araştırma ve ekosistemi üzerine inşa edilmiş ancak kullanılan güncel platform ve pakettir. Paket yeniden adlandırma notları ve açık kaynak ta geçiş ile yeni API’leri açıklamaktadır.
}