afrom letta import Client, Agent, Tool
client = Client(api_key=os.environ.
## Menggunakan Letta ADE (Laluan Tanpa Kod/Kod Rendah)
Jika anda lebih suka membuat prototaip visual, ADE membolehkan anda mengarang ejen, memori dan alatan tanpa menulis kod.
- Mulakan projek ejen baharu dalam ADE.
- Tentukan peranan (gesaan sistem), nada, sempadan ejen.
- Konfigurasikan ketekalan memori dan strategi mendapatkan semula.
- Tambah alatan dengan memilih daripada penyambung atau mentakrifkan tindakan tersuai.
- Uji perbualan sebaris, perhatikan penulisan memori, laraskan ambang.
- Eksport atau serahkan kepada pembangun sebaik sahaja prototaip anda berkelakuan dengan betul.
Lihat pengumuman dan tutorial ADE untuk panduan dan video pengenalan ringkas.
## Mereka Bentuk Ejen Letta yang Hebat: Amalan Terbaik Berpendapat
1) Mulakan dengan kerja-untuk-dilakukan
- Tentukan skop yang sempit (cth., “tiket sokongan triaj untuk ralat web”), bukan generalis yang samar-samar.
2) Kodkan prosedur pengendalian
- Masukkan SOP anda ke dalam gesaan sistem. Contoh: “Apabila triaj mencadangkan impak pengeluaran, tingkatkan dan tetapkan keutamaan=tinggi. Sentiasa sertakan langkah penghasilan semula jika tersedia.”
3) Jadikan skema alatan ketat
- Kuatkuasakan enum dan medan yang diperlukan. Ini mengurangkan parameter yang dihalusinasi.
4) Anggap memori seperti permukaan produk
- Tentukan perkara yang patut diingati (kenalan, keutamaan, resolusi terdahulu) dan perkara yang patut bersifat sementara (pengiraan sekali sahaja). Periksa kesan memori dengan kerap.
5) Uji dengan data sebenar
- Benihkan ejen dengan tiket, dokumen dan contoh yang tanpa nama. Perhatikan mod kegagalan (konteks yang hilang, keutamaan yang salah) dan perhalusi gesaan/alatan.
6) Rel pengawal > pembersihan selepas fakta
- Tambah pengesahan dalam alatan. Jika ejen mencadangkan input yang tidak sah, pengendali anda harus menangkap dan membalas dengan panduan.
7) Instrumental segalanya
- Log panggilan alatan, penulisan memori dan telemetri peringkat mesej. Cipta papan pemuka untuk metrik utama (kadar kejayaan, masa untuk penyelesaian).
8) Versikan ejen anda
- Jejaki perubahan pada gesaan, alatan dan dasar memori. Sematkan versi yang diketahui baik untuk pengeluaran, ulang dalam pementasan.
## Aliran Kerja Biasa Yang Boleh Anda Hantar dengan Letta
- Sokongan Pelanggan
- Ringkaskan bebenang, cadangkan resolusi, cipta tiket, maklumkan pihak berkepentingan.
- Pembantu Penyelidikan
- Rancangkan pertanyaan, cari sumber, sintesis, simpan nota sumber dalam memori.
- Operasi Jualan/CS
- Huraikan nota panggilan, ekstrak langkah seterusnya, kemas kini CRM melalui alatan, susulan dengan e-mel bertemplat.
- Automasi Dalaman
- Pantau baris gilir, cetuskan buku jalanan, fail kemas kini status dan kekalkan konteks merentas syif.
## Penyelesaian Masalah: Apabila Perkara Tidak Berkelakuan
- Ejen melupakan perkara
- Sahkan memori didayakan dan ambang mendapatkan semula adalah sesuai. Semak jika item anda sebenarnya sedang dikekalkan.
- Panggilan alatan cacat
- Ketatkan skema, tambahkan enum dan pulangkan ralat berstruktur dengan pembayang pembetulan.
- Ejen terlalu bertele-tele atau terlalu ringkas
- Laraskan panduan gaya gesaan sistem dan berikan 2–3 contoh sebaris.
- Arahan yang bercanggah
- Gabungkan peraturan pengendalian anda. Gunakan keutamaan eksplisit: “Sentiasa lakukan X sebelum Y.”
- Hanyut selepas kemas kini
- Versi-kunci dalam pengeluaran. Lancarkan perubahan dengan kenari.
## Nota Pantas Keselamatan dan Pematuhan
- Anggap alatan sebagai laluan kod yang dipercayai—sahkan dan skopkannya.
- Sunting data sensitif sebelum mencatat kesan memori.
- Pertimbangkan PII dalam memori: dasar pengekalan, kawalan akses, penyulitan.
## Dari Prototaip ke Pengeluaran: Senarai Semak Ringkas
- OKR yang jelas untuk ejen (apakah kejayaan?).
- Skop sempit dan gesaan sistem yang dipacu SOP.
- Skema alatan yang ketat dengan pengesahan dan ujian.
- Strategi memori didokumenkan dan disahkan dengan tugas sebenar.
- Kebolehcerapan (log, metrik, amaran) disambungkan.
- Versi dan pelan gulung balik.
- Persekitaran pementasan dan pengeluaran diasingkan.
## Sumber Pembelajaran Tambahan
- Video pengenalan: cipta ejen berterusan pertama anda.
- Panduan permulaan pantas (Python/TS) dengan coretan kod.
- Seni bina ejen dan amalan terbaik.
- Pengumuman dan panduan ADE.
- Nota penamaan semula pakej dan keserasian.
- Repo sumber terbuka dan latar belakang.
## Dengan cara ini: Ulangan lebih pantas dengan [Sider.AI](https://sider.ai)
Jika anda mendokumentasikan gesaan, menguji contoh atau membandingkan output merentas versi ejen, adalah berguna untuk menyimpan artifak bersebelahan dan berulang dengan cepat. Perlu diingatkan, [Sider.AI](https://sider.ai) (https://sider.ai/) boleh membantu pasukan menangkap gesaan, nota dan perbezaan semasa anda membina dan menguji ejen—berguna apabila berbilang orang memperhalusi SOP atau menilai skema alatan.
## Pengajaran Utama
- Letta membantu anda membina ejen berkeadaan dengan memori, alatan dan keadaan berterusan.
- Mulakan dengan kerja-untuk-dilakukan yang sempit dan skema yang ketat untuk kestabilan.
- Gunakan SDK untuk aliran kerja pertama kod atau ADE untuk prototaip visual.
- Instrumental, versi dan uji dengan data sebenar sebelum beroperasi.
- Manfaatkan panduan permulaan pantas dan ejen rasmi untuk kekal selaras dengan amalan terbaik.
### Soalan Lazim
S1: Apakah itu Letta dan bagaimana ia berbeza daripada chatbot biasa?
Letta ialah platform untuk membina ejen AI berkeadaan dengan memori berterusan dan orkestrasi alatan, bukan sekadar pembungkus sembang tanpa keadaan. Ia menyimpan keadaan ejen, menguatkuasakan skema alatan dan membolehkan anda mengurus memori dan aliran kerja merentas sesi.
S2: Bagaimana saya boleh mula menggunakan Letta dengan cepat?
Ikuti panduan permulaan pantas pembangun untuk Python atau TypeScript untuk mencipta ejen pertama anda dan menambah alatan. Jika anda lebih suka laluan visual, gunakan ADE untuk mengkonfigurasi memori, gesaan dan alatan sebelum mengeksport persediaan anda.
S3: Bolehkah Letta mengingati pilihan pengguna dan tugas yang lalu?
Ya. Letta menyokong memori berterusan supaya ejen boleh menyimpan pilihan, keputusan dan hasil, kemudian mendapatkannya semula secara kontekstual dalam interaksi masa hadapan. Konfigurasikan dasar memori dan sahkan dengan tugas sebenar.
S4: Bagaimana alatan berfungsi dalam ejen Letta?
Anda mendaftarkan fungsi dengan skema input yang ketat supaya ejen boleh memanggilnya dengan pasti. Tambahkan pengesahan, gunakan enum dan pulangkan ralat berstruktur untuk membimbing tingkah laku pembetulan apabila input dimatikan.
S5: Adakah Letta sama dengan MemGPT?
Letta dibina berdasarkan penyelidikan dan ekosistem MemGPT tetapi merupakan platform dan pakej semasa yang patut anda gunakan. Nota penamaan semula pakej dan repo terbuka menerangkan peralihan dan API yang dikemas kini.