afrom letta import Client, Agent, Tool
client = Client(api_key=os.environ.
## Letta ADE kasutamine (ilma koodita või madala koodi tee)
Kui eelistad visuaalset prototüüpimist, laseb ADE sul kombineerida agente, mälu ja tööriistu ilma koodi kirjutamata.
- Alusta uut agendi projekti ADE-s.
- Määra agendi roll (süsteemi prompt), toon, piirid.
- Seadista mälu püsivus ja otsimisstrateegiad.
- Lisa tööriistad, valides ühenduste seast või määratledes kohandatud toimingud.
- Testi vestlusi kohapeal, jälgi mälule kirjutamist, reguleeri lävendi väärtusi.
- Ekspordi või jaga arendajatega, kui prototüüp töötab korrektselt.
Vaata ADE avaldust ja juhendit koos lühikese videoga.
## Heade Letta agentide disain: arvamuslikud parimad tavad
1) Alusta tehtava töö selgest määratlusest
- Määra kitsas fookus (nt „töötle veebi vigade toe pileteid”), ära loo ebamäärast universaalset agendi profiili.
2) Kodeeri tööprotseduurid
- Pane oma tööprotseduurid süsteemipõimule. Näide: „Kui triage näitab tootmisse mõju, eskaleeri ja sea prioriteediks kõrge. Lisa alati reprodutseerimisjuhised, kui neid on.”
3) Tee tööriistade skeemid rangeks
- Jõusta enumid ja nõutud väljad. See vähendab väljamõeldud parameetreid.
4) Kohtle mälu kui tootepinnana
- Otsusta, mis peaks mäletatav olema (kontaktid, eelistused, varasemad lahendused) ja mis ephemäärne (üksikud arvutused). Sündmuste jälgimine on regulaarselt soovitatav.
5) Testi pärisandmetega
- Täida agent anonüümsete piletite, dokumentide ja näidetega. Jälgi ebaõnnestumisviise (puuduv kontekst, vale prioriteet) ja täiusta prompt'e/tööriistu.
6) Kaitsetõkked on paremad kui hilisem koristus
- Lisa valideerimine tööriistades. Kui agent pakub sobimatuid sisendeid, peaks sinu käsitleja need kinni püüdmise ja juhistega vastama.
7) Instrumenteeri kõik
- Logi tööriistakutsed, mälule kirjutamised, sõnumitasandi telemeetriad. Loo visualiseerimisdashboarde võtmemõõdikute jaoks (edu protsent, lahendamiskiirus).
8) Versiooni oma agente
- Jälgi muudatusi prompt'ides, tööriistades ja mälupoliitikates. Märgista tootmises tuntud head versioonid, iterteeri stagingus.
## Levinud töövood, mida saab Letta abil rakendada
- Klienditugi
- Kokkuvõtete loomine teemadest, lahenduste pakkumine, piletite loomine, huvigruppide teavitamine.
- Teadustöö assistent
- Päringute planeerimine, allikate otsing, sünteesimine ning allikate märkmete salvestamine mällu.
- Müügi- / klienditöö operatsioonid
- Kõnede märkmete analüüs, järgmiste sammude välja toomine, CRM-i uuendamine tööriistadega, järeltegevused mallitud meilidega.
- Siseautomaatika
- Järjekordade jälgimine, käivita runbooke, koostab staatuse uuendusi ja säilitab konteksti vahetuste kaupa.
## Probleemide lahendamine: kui asjad ei käitu ootuspäraselt
- Agent unustab asju
- Kontrolli, et mälu on lubatud ja otsiläved sobivad. Veendu, et üksused on tõesti püsivalt salvestatud.
- Tööriistakutsed on valed
- Kõvenda skeeme, lisa enumid ja tagasta struktureeritud vead parandavate vihjetega.
- Agent on liiga sõnakas või liiga lühike
- Kohanda süsteemipõimu stiilijuhendit ja lisa 2-3 näidisjuhtumit.
- Konflikti tekitavad juhised
- Konsolideeri tööreeglid, kasuta selgeid prioritiseeringuid: „Alati tee X enne Y.”
- Uuenduste järel nihked
- Lukusta versioon tootmises. Järgmisel tasandil vii muudatused sisse kontrollitult.
## Turvalisuse ja vastavuse kiire kokkuvõte
- Kohtle tööriistu usaldusväärsete koodirada, teosta autentimine ja piirangud.
- Tundlike andmete redigeerimine enne mälulogi jälgi.
- Mõtle PII-le mälus: säilituspoliitikad, ligipääsu kontrollid, krüpteerimine.
## Prototüübist tooteni: lühike kontrollnimekiri
- Selged OKR-id agendi jaoks (mis on edu?).
- Kitsas fookus ja standardiseeritud süsteemipõim.
- Rangete skeemidega tööriistad koos valideerimise ja testidega.
- Mälu strateegia dokumenteeritud ja kinnitatud pärisülesannetega.
- Jälgitavus (logid, mõõdikud, häired) juhitud.
- Versioonihaldus ja tagasikerimine plaanis.
- Eraldi staging ja tootmiskeskkonnad.
## Täiendavad õppematerjalid
- Sissejuhatusvideo: loo oma esimene püsiv agent.
- Kiire algus (Python/TS) koos koodinäidetega.
- Agendi arhitektuur ja tavad.
- ADE avaldus ja samm-sammult juhend.
- Paketi nimevahetus ja ühilduvusmärkmed.
- Avatud lähtekoodi hoidla ja taustinfo.
## Muide: kiirem iteratsioon 
[Sider.AI](https://sider.ai)[Sider.AI](https://sider.ai)
[Sider.AI](https://sider.ai)[Sider.AI](https://sider.ai)
Kui dokumenteerid prompt-e, testid näiteid või võrdled väljundeid agendi versioonide vahel, on mugav hoida artefakte kõrvuti ja kiirelt iterteerida. Tasub märkida, et 
[Sider.AI](https://sider.ai)[Sider.AI](https://sider.ai)
 (https://sider.ai/) aitab meeskondadel jäädvustada prompt-e, märkmeid ja muudatusi arendamise ja testimise ajal—kasulik, kui mitu inimest täiustavad tööprotseduure või hindavad tööriistade skeeme.
## Peamised kokkuvõtted
- Letta aitab sul luua olemuslikke agente, kellel on mälu, tööriistad ja püsiv olek.
- Alusta kitsast tööülesandest ja rangetest skeemidest stabiilsuse tagamiseks.
- Kasuta SDK-d koodikeskses töövoos või ADE-d visuaalseks prototüüpimiseks.
- Instrumenteeri, versiooni ja testi pärisandmetega enne tootmisse minekut.
- Kasuta ametlikke kiireid algusjuhendeid ja agendi õpetusi, et järgida parimaid praktikaid.
### KKK
K1: Mis on Letta ja kuidas see erineb tavalisest vestlusrobotist?
Letta on platvorm olemuslike AI-agentide loomiseks, kellel on püsiv mälu ja tööriistade orkestreerimine, mitte lihtsalt olekuta vestlusliides. See salvestab agendi oleku, kontrollib tööriistade skeeme ning haldab mälu ja töövooge sessioonide vahel.
K2: Kuidas alustada Lettaga kiiresti?
Järgi arendajate kiire algust Pythonis või TypeScriptis, et luua oma esimene agent ja lisada tööriistad. Kui eelistad visuaalset lähenemist, kasuta ADE-d mälu, promptide ja tööriistade seadistamiseks ning seejärel ekspordi oma lahendus.
K3: Kas Letta suudab meeles pidada kasutaja eelistusi ja varasemaid ülesandeid?
Jah. Letta toetab püsivat mälu, nii et agentidel on võimalik salvestada eelistusi, otsuseid ja tulemusi ning neid tulevikus kontekstuaalselt taasesitada. Seadista mälupoliitikad ja testi pärisülesannetega.
K4: Kuidas tööriistad Lettas agentide sees toimivad?
Sa registreerid funktsioonid rangete sisendskeemidega, et agent saaks neid usaldusväärselt kutsuda. Lisa valideerimine, kasuta endmeid ja tagasta struktureeritud vead, mis juhendavad parandavat käitumist, kui sisendid on valed.
K5: Kas Letta on sama, mis MemGPT?
Letta põhineb MemGPT teadusuuringutel ja ökosüsteemil, kuid on praegune platvorm ja pakett, mida kasutada tuleks. Pakendi nimevahetuse märkmed ja avatud lähtekoode hoidla selgitavad üleminekut ja uuendatud API-sid.