afrom letta import Client, Agent, Tool
client = Client(api_key=os.environ.
## Letta ADE használata (Lakcso/kódmentes útvonal)
Ha inkább vizuális prototípus-készítőt szeretnél, az ADE-ben kódírás nélkül komponálhatod az ügynököt, memóriát és eszközöket.
- Indíts új ügynök projektet az ADE-ben.
- Határozd meg az ügynök szerepét (rendszerprompt), stílusát és korlátait.
- Állítsd be a memória megőrzés és visszakeresési stratégiákat.
- Adj hozzá eszközöket csatlakozókból vagy egyedi műveleteket definiálva.
- Tesztelj beszélgetéseket azonnal, figyeld a memóriaírásokat, és állítsd be a küszöbértékeket.
- Exportáld vagy add át a fejlesztőknek, amikor a prototípus megfelelően működik.
Nézd meg az ADE bejelentését és oktatóanyagát egy részletes végigvezetéshez és rövid bemutató videóhoz.
## Ízléses Letta ügynökök tervezése: véleményezett legjobb gyakorlatok
1) Kezdd a megoldandó munkával
- Határozz meg szűk fókuszt (pl. „webes hibák támogatási jegyeinek triálása”), ne legyen homályos általános feladat.
2) Kódold bele az üzemeltetési eljárásokat
- Tedd a SOP-okat a rendszerpromptba. Példa: „Ha a triázs a produktív hatást javasolja, emeld a prioritást magasra, és mindig csatolj reprodukciós lépéseket, ha vannak.”
3) Tartsd szigorúan a tool sémákat
- Kötelezővé téve az enumerációkat és kötelező mezőket csökkentheted a hamisított paraméterek előfordulását.
4) Kezeld a memóriát, mint egy termék felületét
- Dolgozd ki, mi legyen megjegyzendő (kapcsolatok, preferenciák, korábbi megoldások) és mi lehessen átmeneti (egyszeri számítások). Rendszeresen vizsgáld a memóriabejegyzéseket.
5) Tesztelj valós adatokkal
- Tápláld az ügynököt anonimizált jegyekkel, dokumentumokkal és példákkal. Figyeld meg a hibamódokat (hiányzó kontextus, rossz prioritás), és finomítsd a promptokat, eszközöket.
6) Inkább megelőző védelmi mechanizmusok, mint utólagos takarítás
- Adj hozzá validációt az eszközökben. Ha az ügynök érvénytelen bemenetet javasol, a kezelőd fogja el és adjon útmutatást.
7) Minden eseményt mérj és naplózz
- Naplózd az eszközhívásokat, memóriaírásokat és üzenetszintű telemetriát. Készíts műszerfalakat kulcsfontosságú mutatókhoz (pl. sikerarány, megoldási idő).
8) Verziózd az ügynököket
- Kövesd nyomon a promptok, eszközök és memória szabályzatok változásait. Rögzítsd a jól bevált verziókat produkcióra, és iterálj a staging környezetben.
## Gyakori munkafolyamatok, amelyeket Lettával indíthatsz
- Ügyfélszolgálat
- Szálak összegzése, megoldási javaslatok, jegy létrehozása, érintettek értesítése.
- Kutatási asszisztens
- Lekérdezések tervezése, források keresése, szintetizálás, forrásjegyzetek tárolása a memóriában.
- Értékesítési/CS műveletek
- Hívás jegyzőkönyvek elemzése, következő lépések kivonása, CRM frissítése eszközökön keresztül, sablonos emailek küldése.
- Belső automatizálás
- Sorok monitorozása, futtatási könyvek indítása, állapotfrissítések, kontextus megőrzése műszakok között.
## Hibaelhárítás: Ha valami nem úgy működik, ahogy kellene
- Az ügynök elfelejt dolgokat
- Ellenőrizd, hogy engedélyezve van-e a memória, és a visszakeresési küszöbértékek megfelelőek. Vizsgáld meg, hogy az elemek valóban megőrződnek-e.
- Az eszközhívások hibásak
- Szigorítsd a sémákat, adj hozzá enumerációkat, és adj vissza strukturált hibákat javító javaslatokkal.
- Az ügynök túl bőbeszédű vagy túl tömör
- Állítsd be a rendszerprompt stílusútmutatóját, és adj 2–3 beágyazott példát.
- Összeférhetetlen utasítások
- Egységesítsd az üzemeltetési szabályokat. Használj explicit prioritásokat: „Mindig végezd el X-et Y előtt.”
- Elcsúszás frissítések után
- Verziózással zárold produkcióra. Újításokat fokozatosan vezess be, kísérleti jelleggel.
## Biztonsági és megfelelőségi gyorsjegyzetek
- Tekintsd az eszközöket megbízható kódfutási útvonalaknak – hitelesítsd és korlátozd hozzáférésüket.
- Törölj érzékeny adatokat a memória naplózás előtt.
- Gondolj a személyes azonosító információkra a memóriában: megőrzési szabályok, hozzáférés-vezérlés, titkosítás.
## Prototípustól produkcióig: Egy rövid ellenőrző lista
- Világos OKR-ek az ügynökhöz (mi a siker mércéje?).
- Szűk fókusz és SOP-alapú rendszerprompt.
- Szigorú eszköz sémák validációval és tesztekkel.
- Dokumentált memória stratégia, validálva valós feladatokkal.
- Megfigyelhetőség (naplók, metrikák, riasztások) kiépítve.
- Verziókövetés és visszagörgetés terve.
- Staging és produkciós környezetek elkülönítve.
## További tanulási források
- Bevezető videó: hozz létre első tartós ügynöködet.
- Gyorskezdő (Python/TS) kódrészletekkel.
- Ügynök architektúra és legjobb gyakorlatok.
- ADE bejelentés és végigvezető.
- Csomagnév változás és kompatibilitási jegyzetek.
- Nyílt forráskódú tárhely és háttér.
## Egyébként: Gyorsabb iteráció a [Sider.AI](https://sider.ai) segítségével
Ha promptokat dokumentálsz, példákat tesztelsz vagy összehasonlítod az eredményeket különböző ügynök verziók között, kényelmes, ha az anyagokat párhuzamosan kezelheted és gyorsan iterálhatsz rajtuk. Érdemes tudni, hogy a [Sider.AI](https://sider.ai) (https://sider.ai/) segít csapatoknak a promptok, jegyzetek és eltérések kezelésében, miközben ügynököket építesz és tesztelek – hasznos, ha többen finomítanak egy SOP-t vagy vizsgálják az eszközsémákat.
## Főbb tanulságok
- Letta segít állapotmegőrző ügynökök építésében memória, eszközök és tartós állapot használatával.
- Kezdd egy szűk, konkrét feladattal és szigorú sémákkal a stabilitásért.
- Használd az SDK-t kódközpontú munkafolyamatokhoz vagy az ADE-t vizuális prototípus-készítéshez.
- Műszerezz, verziózz és tesztelj valós adatokkal, mielőtt élesítesz.
- Használd az hivatalos gyorskezdőt és ügynök útmutatókat, hogy kövesd a legjobb gyakorlatokat.
### GYIK
K1: Mi az a Letta, és miben különbözik egy hagyományos chatbot-tól?
Letta egy olyan platform állapotmegőrző AI ügynökök építéséhez, amelyek tartós memóriát és eszközkezelést biztosítanak, nem csupán stateless chatburkoló. Tárolja az ügynök állapotát, sémakövető eszközöket használ, és kezeli a memóriát, valamint a munkafolyamatokat a munkamenetek között.
K2: Hogyan kezdhetek gyorsan Lettával?
Kövessd a fejlesztőknek szóló gyorskezdőt Python vagy TypeScript környezetben az első ügynök létrehozásához és eszközök hozzáadásához. Ha vizuális megoldást szeretnél, használd az ADE-t a memória, promptok és eszközök konfigurálásához, majd exportáld a projektet.
K3: Tudja-e Letta megjegyezni a felhasználói preferenciákat és korábbi feladatokat?
Igen. Letta támogatja az állandó memóriát, így az ügynökök tárolhatják a preferenciákat, döntéseket és eredményeket, majd kontextusfüggően előhívhatják azokat későbbi interakciókban. Állíts be memória szabályokat, és validáld valós feladatokkal.
K4: Hogyan működnek az eszközök Lettában?
Regisztrálsz függvényeket szigorú input sémákkal, hogy az ügynök megbízhatóan hívhassa őket. Adj hozzá validációt, használj enumerációkat, és adj vissza strukturált hibákat, hogy az ügynök tudja korrigálni a bemeneti hibákat.
K5: Ugyanaz a Letta, mint a MemGPT?
Letta a MemGPT kutatására és ökoszisztémájára épít, de ez a jelenlegi platform és csomag, amit használni érdemes. A csomagnév változás jegyzetei és az open-source tárhely bemutatja az átmenetet és az új API-kat.