afrom letta import Client, Agent, Tool
client = Client(api_key=os.environ.
## Použitie Letta ADE (Nízko-kódová/no-kód cesta)
Ak preferujete vizuálne prototypovanie, ADE vám umožní skladať agentov, pamäť a nástroje bez písania kódu.
- Začnite nový projekt agenta v ADE.
- Definujte rolu agenta (systémový prompt), tón, hranice.
- Nakonfigurujte perzistenciu pamäti a stratégie vyhľadávania.
- Pridajte nástroje výberom konektorov alebo definovaním vlastných akcií.
- Testujte konverzácie priamo v prostredí, sledujte zápisy do pamäti, dolaďte prahy.
- Exportujte alebo odovzdajte vývojárom, keď prototyp správne funguje.
Pozrite si oznam a návod ADE vrátane krátkeho úvodného videa.
## Návrh skvelých agentov v Lette: Odborné odporúčania
1) Začnite s cieľom úlohy
- Definujte úzky rozsah (napr. „triedenie tiketov pre webové chyby“), nie rozplizlého generalistu.
2) Zakódujte prevádzkové postupy
- Uložte SOP do systémového promptu. Príklad: „Ak triedenie signalizuje dopad na produkciu, eskalujte a nastav prioritu=high. Vždy zahrň kroky na reprodukciu, ak sú dostupné.“
3) Robte schémy nástrojov prísne
- Vynucujte enumy a povinné polia. Znižuje to výskyt halucinovaných parametrov.
4) Zaobchádzajte s pamäťou ako s produktovým rozhraním
- Rozhodnite, čo má byť zapamätateľné (kontakty, preferencie, predchádzajúce riešenia) a čo len epizodické (jednorazové výpočty). Pravidelne kontrolujte stopy pamäti.
5) Testujte na reálnych dátach
- Naplňte agenta anonymizovanými tiketmi, dokumentmi a príkladmi. Sledujte chybové módy (chybný kontext, nesprávna priorita) a dolaďte prompty a nástroje.
6) Ochranné zábrany > dodatočné čistenie
- Pridajte validáciu v nástrojoch. Ak agent navrhne nesprávne vstupy, váš handler by ich mal zachytiť a naviesť správou.
7) Instrumentujte všetko
- Logujte volania nástrojov, zápisy pamäti a telemetriu na úrovni správ. Vytvorte dashboardy pre kľúčové metriky (úspešnosť, čas do vyriešenia).
8) Verzujte agentov
- Sledujte zmeny promptov, nástrojov a pravidiel pamäti. Zamknite overené verzie na produkciu, iterujte v stagingu.
## Bežné pracovné postupy, ktoré môžete s Lettou nasadiť
- Zákaznícka podpora
- Zhrňovanie konverzácií, navrhovanie riešení, tvorba tiketov, notifikácie stakeholdrov.
- Výskumný asistent
- Plánovanie dopytov, vyhľadávanie zdrojov, syntéza, ukladanie poznámok do pamäti.
- Predajné/CS operácie
- Parsovanie poznámok z hovorov, extrahovanie ďalších krokov, aktualizácia CRM cez nástroje, následná komunikácia s emailovými šablónami.
- Interná automatizácia
- Monitorovanie frontov, spúšťanie runbookov, aktualizácie statusov, uchovávanie kontextu naprieč zmenami.
## Riešenie problémov: Keď veci nefungujú správne
- Agent zabúda
- Overte, či je pamäť povolená a prahy vyhľadávania vhodné. Skontrolujte, či sa položky naozaj ukladajú.
- Volania nástrojov sú nesprávne
- Sprísnite schémy, pridajte enumy, vráťte štruktúrované chyby s návodmi na opravu.
- Agent je príliš hovorový alebo príliš lakonický
- Upravte štýl systémového promptu a pridajte 2–3 príklady priamo v texte.
- Protikladné inštrukcie
- Zjednoťte prevádzkové pravidlá. Používajte explicitné priority: „Vždy urob X pred Y.“
- Odchýlky po aktualizáciách
- Zamknite verziu v produkcii. Nasadzujte zmeny postupne (canary deployment).
## Krátke poznámky k bezpečnosti a súladu
- Považujte nástroje za dôveryhodné kódové cesty – autentifikujte ich a obmedzte rozsah prístupov.
- Redukujte citlivé údaje pred logovaním pamäťových stôp.
- Zvážte PII v pamäti: pravidlá retencie, prístupové kontroly, šifrovanie.
## Z prototypu do produkcie: Krátky kontrolný zoznam
- Jasné OKR pre agenta (čo je úspech?).
- Úzky rozsah a SOP-riadený systémový prompt.
- Prísne schémy nástrojov s validáciou a testami.
- Dokumentovaná stratégia pamäti overená na reálnych úlohách.
- Zabezpečená pozorovateľnosť (logy, metriky, alerty).
- Plán verzovania a rollbacku.
- Oddelené staging a produkčné prostredia.
## Doplnkové vzdelávacie zdroje
- Úvodné video: vytvorte svojho prvého perzistentného agenta.
- Rýchly štart (Python/TS) s útržkami kódu.
- Architektúra agentov a najlepšie postupy.
- Oznámenie a návod ADE.
- Poznámky o premenovaní balíčka a kompatibilite.
- Open-source repozitár a pozadie.
## Mimochodom: Rýchlejšie iterovanie so [Sider.AI](https://sider.ai)
Ak dokumentujete prompty, testujete príklady alebo porovnávate výstupy rôznych verzií agenta, je praktické mať artefakty vedľa seba a rýchlo iterovať. Stojí za zmienku, že [Sider.AI](https://sider.ai) (https://sider.ai/) pomáha tímom zachytávať prompty, poznámky a rozdiely počas vývoja a testovania agentov – užitočné, keď viac ľudí dolaďuje SOP alebo hodnotí schémy nástrojov.
## Kľúčové body
- Letta vám umožňuje vytvárať stavových agentov s pamäťou, nástrojmi a perzistentným stavom.
- Začnite s úzkou úlohou a prísnymi schémami pre stabilitu.
- Použite SDK pre kódovo orientované pracovné toky alebo ADE pre vizuálne prototypovanie.
- Instrumentujte, verzujte a testujte na reálnych dátach pred nasadením.
- Využite oficiálne rýchleštarty a sprievodcov agentmi, aby ste zostali na správnej ceste podľa najlepších praktík.
### FAQ
Otázka 1: Čo je Letta a ako sa líši od bežného chatbotu?
Letta je platforma na tvorbu stavových AI agentov s perzistentnou pamäťou a koordináciou nástrojov, nie len bezstavový chatový obal. Ukladá stav agentov, vyžaduje schémy nástrojov a umožňuje spravovať pamäť a pracovné postupy medzi reláciami.
Otázka 2: Ako rýchlo začať používať Lettu?
Postupujte podľa vývojárskeho rýchlostartu pre Python alebo TypeScript, vytvorte prvého agenta a pridajte nástroje. Ak preferujete vizuálnu cestu, použite ADE na konfiguráciu pamäti, promptov a nástrojov pred exportom nastavenia.
Otázka 3: Môže Letta pamätať používateľské preferencie a minulé úlohy?
Áno. Letta podporuje perzistentnú pamäť, takže agenti môžu ukladať preferencie, rozhodnutia a výsledky a neskôr ich kontextuálne vyvolávať. Nakonfigurujte pravidlá pamäti a overte na reálnych úlohách.
Otázka 4: Ako fungujú nástroje v agentocht Letta?
Zaregistrujete funkcie so striktnými vstupnými schémami, aby ich agent mohol spoľahlivo volať. Pridajte validáciu, používajte enumy a vracajte štruktúrované chyby, ktoré nasmerujú na opravu, keď sú vstupy nesprávne.
Otázka 5: Je Letta to isté ako MemGPT?
<a119>Letta vychádza z výskumu a ekosystému MemGPT, ale je to aktuálna platforma a balíček, ktorý by ste mali používať. Poznámky o premenovaní balíčka a otvorené repo vysvetľujú prechod a aktualizované API.