afrom letta import Client, Agent, Tool
client = Client(api_key=os.environ.
## Uporaba Letta ADE (pot brez kode/z malo kode)
Če imate raje vizualno prototipiranje, vam ADE omogoča sestavljanje agentov, pomnilnika in orodij brez pisanja kode.
- Začnite nov projekt agenta v ADE.
- Določite vlogo agenta (sistemski poziv), ton in omejitve.
- Konfigurirajte vztrajnost in strategije pridobivanja pomnilnika.
- Dodajte orodja z izbiro iz konektorjev ali definiranjem prilagojenih dejanj.
- Testirajte pogovore v sami aplikaciji, opazujte zapise v pomnilnik, prilagajajte pragove.
- Izvozite ali predajte razvijalcem, ko vaš prototip pravilno deluje.
Oglejte si napoved in tutorial ADE s hitrim uvodnim videom.
## Oblikovanje odličnih Letta agentov: priporočene prakse
1) Začnite z nalogo, ki jo je treba opraviti
- Določite ozek obseg (npr. “razverjanje podpornih tiketov za spletne napake”), ne splošen generičen namen.
2) Kodirajte delovne postopke
- Vnesite svoje standardne operativne postopke (SOP) v sistemski poziv. Primer: “Ko razvrščanje kaže vpliv na produkcijo, takoj eskalirajte in nastavite prioriteto=visoka. Vedno vključite korake za reprodukcijo, če so na voljo.”
3) Naredite sheme orodij stroge
- Uveljavite omejitve (enum) in obvezna polja, da zmanjšate nepravilne parametre.
4) Obnašajte se do pomnilnika kot do produkta
- Odločite, kaj je pomembno za zapomnitev (stiki, preference, prejšnje rešitve) in kaj je kratkotrajno (enkratni izračuni). Redno pregledujte sledi spomina.
5) Testirajte z realnimi podatki
- Napolnite agenta z anonimiziranimi tiketi, dokumenti in primeri. Opazujte načine neuspeha (manjkajoč kontekst, napačna prioriteta) in izboljšujte pozive/orodja.
6) Zaščitni ukrepi so boljši kot čiščenje po težavi
- Dodajte validacijo v orodja. Če agent predlaga neveljavne vnose, naj vaš sistem obdelave zazna in ustrezno svetuje.
7) Nadzorujte vse
- Zabeležite klice orodij, zapise v pomnilnik in telemetrijo na ravni sporočil. Ustvarite nadzorne plošče za ključne metrike (stopnja uspešnosti, čas do rešitve).
8) Različicirajte svoje agente
- Spremljajte spremembe pozivov, orodij in pravil pomnilnika. Fiksirajte preizkušene različice za produkcijo in izvedite iteracije v testnem okolju.
## Pogosti delovni tokovi, ki jih lahko izvajate z Letta
- Podpora strankam
- Povzemite niti, predlagajte rešitev, ustvarite tikete, obvestite zainteresirane strani.
- Raziskovalni asistent
- Načrtujte poizvedbe, iščite vire, sintezirajte in shranjujte opombe virov v pomnilnik.
- Prodaja/CS operacije
- Razčlenite zapiske klicev, izvlecite naslednje korake, posodobite CRM prek orodij, sledite z vnaprej pripravljenimi elektronskimi sporočili.
- Interna avtomatizacija
- Spremljajte vrste, sprožite priročnike, urejajte posodobitve stanja in ohranjajte kontekst med izmeni.
## Reševanje težav: ko stvari ne delujejo
- Agent pozabi stvari
- Preverite, da je pomnilnik omogočen in prag za pridobivanje ustrezno nastavljen. Preverite, ali se elementi dejansko trajno shranjujejo.
- Klici orodij so nepravilno oblikovani
- Zaostrite sheme, dodajte enum vrednosti in vračajte strukturirane napake z navodili za popravke.
- Agent je preveč besedilen ali prekratek
- Prilagodite slog sistemskega poziva in zagotovite 2–3 primere v tekstu.
- Kontradiktorna navodila
- Konsolidirajte operativna pravila. Uporabite eksplicitne prioritete: "Vedno naredi X pred Y."
- Odmik po posodobitvah
- Zaklenite različico v produkciji. Spremembe uvajajte postopoma s testiranjem canary.
## Hitre varnostne in skladnostne opombe
- Obnašajte se do orodij kot do zaupanja vrednih kodnih poti – zagotovite avtentikacijo in omejitve dostopa.
- Pred zapisovanjem spomina odstranite osebne občutljive podatke (PII).
- Upoštevajte politike zadrževanja, nadzore dostopa in šifriranje za PII v pomnilniku.
## Od prototipa do produkcije: kratki kontrolni seznam
- Jasni cilji uspešnosti za agenta (kaj je uspeh?).
- Ozki obseg in sistemski poziv, ki temelji na SOP.
- Strogi shemi orodij z validacijo in testi.
- Dokumentirana in validirana strategija pomnilnika s pravimi nalogami.
- Povezanost za opazovanje (zapisi, metrike, opozorila).
- Načrt različic in povračila.
- Ločena testna in produkcijska okolja.
## Dodatni učni viri
- Uvodni video: ustvarite svojega prvega trajnega agenta.
- Hitri začetek (Python/TS) s primeri kode.
- Arhitektura agenta in priporočene prakse.
- Napoved in vodnik ADE.
- Opombe o preimenovanju paketa in združljivosti.
- Odprtokodni repozitorij in ozadje.
## Mimogrede: Hitrejše iteracije z [Sider.AI](https://sider.ai)
Če dokumentirate pozive, testirate primere ali primerjate izhode med različicami agentov, je koristno imeti artefakte vzporedno in hitro iterirati. Omeniti velja, da [Sider.AI](https://sider.ai) (https://sider.ai/) lahko pomaga ekipam zajemati pozive, opombe in razlike med različicami, medtem ko gradite in testirate agente – uporabno, ko več ljudi izboljšuje SOP ali ocenjuje sheme orodij.
## Ključna spoznanja
- Letta vam pomaga graditi stanjške agente s spominom, orodji in vztrajnim stanjem.
- Začnite z ozko nalogo in strogo shemo za stabilnost.
- Uporabite SDK za kodo ali ADE za vizualno prototipiranje.
- Nadzorujte, različicirajte in testirajte z realnimi podatki pred uvedbo v živo.
- Izkoristite uradne hitre začetke in vodiče za agente, da sledite najboljšim praksam.
### Pogosta vprašanja (FAQ)
V1: Kaj je Letta in kako je drugačna od običajnega klepetalnika?
Letta je platforma za gradnjo stanjskih AI agentov s trajnim pomnilnikom in orkestracijo orodij, ne zgolj brezstanjskim klepetalnikom. Shranjuje stanje agenta, uveljavlja sheme orodij in omogoča upravljanje pomnilnika ter delovnih tokov preko sej.
V2: Kako hitro začeti uporabljati Letta?
Sledite hitremu začetku za razvijalce v Pythonu ali TypeScriptu za ustvarjanje prvega agenta in dodajanje orodij. Če raje uporabljate vizualni način, uporabite ADE za konfiguracijo pomnilnika, pozivov in orodij, nato izvozite nastavitve.
V3: Ali Letta lahko zapomni uporabniške preference in pretekle naloge?
Da. Letta podpira trajni pomnilnik, kjer agenti lahko shranijo preference, odločitve in rezultate ter jih nato kontekstualno prikličejo v prihodnjih interakcijah. Konfigurirajte politike pomnilnika in validirajte z realnimi nalogami.
V4: Kako delujejo orodja v Letta agentih?
Registrirate funkcije s strogimi vhodnimi shemami, da jih agent lahko zanesljivo kliče. Dodajte validacijo, uporabljajte enumeracije in vračajte strukturirane napake, ki usmerjajo agentovo vedenje, ko so vnosi nepravilni.
V5: Ali je Letta isto kot MemGPT?
Letta temelji na raziskavi in ekosistemu MemGPT, vendar je trenutno platforma in paket, ki ga morate uporabiti. Opombe o preimenovanju paketa in odprtokodni repozitorij pojasnjujejo prehod in posodobljene API-je.