afrom letta import Client, Agent, Tool
client = Client(api_key=os.environ.
## „Letta ADE“ naudojimas (be kodo / su mažu kodu)
Jei teikiate pirmenybę vizualiam prototipų kūrimui, ADE leidžia jums kurti agentus, atmintį ir įrankius nerašant kodo.
- Pradėkite naują agento projektą ADE.
- Apibrėžkite agento vaidmenį (sistemos raginimą), toną, ribas.
- Konfigūruokite atminties išsaugojimo ir atgavimo strategijas.
- Pridėkite įrankius pasirinkdami iš jungčių arba apibrėždami pasirinktinius veiksmus.
- Išbandykite pokalbius eilėje, stebėkite atminties rašymą, pakoreguokite slenksčius.
- Eksportuokite arba perduokite kūrėjams, kai jūsų prototipas elgiasi teisingai.
Peržiūrėkite ADE skelbimą ir mokomąjį vaizdo įrašą, kad gautumėte išsamią apžvalgą ir greitą įvadinį vaizdo įrašą.
## Puikių „Letta“ agentų kūrimas: nuomonės pagrįsta geriausia praktika
1) Pradėkite nuo atliktino darbo
- Apibrėžkite siaurą taikymo sritį (pvz., „trijų pagalbos bilietų dėl žiniatinklio klaidų“), o ne neaiškų generalistą.
2) Užkoduokite veiklos procedūras
- Įdėkite savo SOP į sistemos raginimą. Pavyzdys: „Kai triažas rodo poveikį gamybai, eskaluokite ir nustatykite priority=high. Visada įtraukite atkūrimo veiksmus, jei įmanoma.“
3) Padarykite įrankių schemas griežtas
- Užtikrinkite išvardijimus ir reikalingus laukus. Tai sumažina haliucinuotus parametrus.
4) Atmintį traktuokite kaip produkto paviršių
- Nuspręskite, kas turėtų būti įsimintina (kontaktai, nuostatos, ankstesni sprendimai), o kas turėtų būti efemeriška (vienkartiniai skaičiavimai). Reguliariai tikrinkite atminties sekimus.
5) Išbandykite su realiais duomenimis
- Užpildykite agentą anonimizuotais bilietais, dokumentais ir pavyzdžiais. Stebėkite gedimų režimus (trūkstamą kontekstą, neteisingą prioritetą) ir patikslinkite raginimus / įrankius.
6) Apsaugos priemonės > valymas po fakto
- Pridėkite patvirtinimą įrankiuose. Jei agentas siūlo netinkamas įvestis, jūsų tvarkyklė turėtų sugauti ir atsakyti nurodymais.
7) Instrumentuokite viską
- Registruokite įrankių iškvietimus, atminties rašymą ir pranešimų lygio telemetriją. Sukurkite pagrindinių metrikų (sėkmės rodiklio, laiko iki sprendimo) informacijos suvestines.
8) Versijuokite savo agentus
- Stebėkite raginimų, įrankių ir atminties politikų pakeitimus. Priskirkite žinomas geras versijas gamybai, kartokite etapais.
## Įprastos darbo eigos, kurias galite įdiegti su „Letta“
- Klientų aptarnavimas
- Apibendrinkite gijas, pasiūlykite sprendimą, kurkite bilietus, praneškite suinteresuotosioms šalims.
- Tyrimų asistentas
- Planuokite užklausas, ieškokite šaltinių, sintetinkite, saugokite šaltinio pastabas atmintyje.
- Pardavimų / CS operacijos
- Analizuokite skambučių pastabas, ištraukite tolesnius veiksmus, atnaujinkite CRM per įrankius, susisiekite su šabloniniais el. laiškais.
- Vidaus automatizavimas
- Stebėkite eiles, paleiskite paleidimo knygas, pateikite būsenos atnaujinimus ir išsaugokite kontekstą per pamainas.
## Trikčių šalinimas: kai dalykai elgiasi netinkamai
- Agentas pamiršta dalykus
- Patikrinkite, ar atmintis įjungta ir ar atgavimo slenksčiai yra tinkami. Patikrinkite, ar jūsų elementai iš tikrųjų yra išsaugomi.
- Įrankių iškvietimai yra netinkamai suformuoti
- Sugriežtinkite schemas, pridėkite išvardijimus ir grąžinkite struktūruotas klaidas su taisomosiomis užuominomis.
- Agentas yra per daug daugiažodis arba per trumpas
- Pakoreguokite sistemos raginimo stiliaus vadovą ir pateikite 2–3 eilės pavyzdžius.
- Prieštaringos instrukcijos
- Konsoliduokite savo veiklos taisykles. Naudokite aiškius prioritetus: „Visada darykite X prieš Y.“
- Dreifas po atnaujinimų
- Gamybos versijos užraktas. Išleiskite pakeitimus su kanarėlėmis.
## Greitos saugos ir atitikties pastabos
- Traktuokite įrankius kaip patikimus kodo kelius – autentifikuokite ir apibrėžkite jų taikymo sritį.
- Redaguokite neskelbtinus duomenis prieš registruodami atminties sekimus.
- Apsvarstykite PII atmintyje: saugojimo politiką, prieigos kontrolę, šifravimą.
## Nuo prototipo iki gamybos: trumpas kontrolinis sąrašas
- Aiškūs agento OKR (kas yra sėkmė?).
- Siaura taikymo sritis ir SOP pagrįstas sistemos raginimas.
- Griežtos įrankių schemos su patvirtinimu ir testais.
- Atminties strategija dokumentuota ir patvirtinta atliekant realias užduotis.
- Stebėjimo galimybė (žurnalai, metrika, įspėjimai) prijungta.
- Versijų valdymas ir atšaukimo planas.
- Stagingo ir gamybos aplinkos atskirtos.
## Papildomi mokymosi ištekliai
- Įvadinis vaizdo įrašas: sukurkite savo pirmąjį nuolatinį agentą.
- Greitoji pradžia („Python“ / TS) su kodo fragmentais.
- Agento architektūra ir geriausia praktika.
- ADE skelbimas ir apžvalga.
- Paketo pervadinimo ir suderinamumo pastabos.
- Atvirojo kodo saugykla ir fonas.
## Beje: spartesnis kartojimas su [Sider.AI](https://sider.ai)
Jei dokumentuojate raginimus, testuojate pavyzdžius arba lyginate išvestis skirtingose agentų versijose, patogu artefaktus laikyti vienas šalia kito ir greitai kartoti. Verta paminėti, kad [Sider.AI](https://sider.ai) (https://sider.ai/) gali padėti komandoms užfiksuoti raginimus, pastabas ir skirtumus kuriant ir testuojant agentus – naudinga, kai keli žmonės tobulina SOP arba vertina įrankių schemas.
## Pagrindiniai dalykai
- „Letta“ padeda jums kurti būsenos agentus su atmintimi, įrankiais ir nuolatine būsena.
- Pradėkite nuo siauro atliktino darbo ir griežtų schemų stabilumui užtikrinti.
- Naudokite SDK, skirtą pirmajam kodui darbo eigoms, arba ADE, skirtą vizualiam prototipų kūrimui.
- Instrumentuokite, versijuokite ir išbandykite su realiais duomenimis prieš paleisdami tiesiogiai.
- Pasinaudokite oficialiu greitosios pradžios vadovu ir agento vadovais, kad nuolat laikytumėtės geriausios praktikos.
### DUK
1 klausimas: kas yra „Letta“ ir kuo ji skiriasi nuo įprasto pokalbių roboto?
„Letta“ yra platforma, skirta kurti būsenos AI agentus su nuolatine atmintimi ir įrankių orkestravimu, o ne tik būsenos neturintis pokalbių įskiepis. Ji saugo agento būseną, užtikrina įrankių schemas ir leidžia valdyti atmintį bei darbo eigas tarp seansų.
2 klausimas: kaip greitai pradėti naudoti „Letta“?
Vykdykite kūrėjo greitosios pradžios vadovą, skirtą „Python“ arba „TypeScript“, kad sukurtumėte savo pirmąjį agentą ir pridėtumėte įrankius. Jei teikiate pirmenybę vizualiam keliui, naudokite ADE, kad sukonfigūruotumėte atmintį, raginimus ir įrankius prieš eksportuodami savo nustatymą.
3 klausimas: ar „Letta“ gali prisiminti vartotojo nuostatas ir ankstesnes užduotis?
Taip. „Letta“ palaiko nuolatinę atmintį, todėl agentai gali saugoti nuostatas, sprendimus ir rezultatus, o tada kontekstiškai juos atgauti būsimuose sąveikose. Konfigūruokite atminties politikas ir patvirtinkite atliekant realias užduotis.
4 klausimas: kaip veikia įrankiai „Letta“ agentuose?
Registruojate funkcijas su griežtomis įvesties schemomis, kad agentas galėtų jas patikimai iškviesti. Pridėkite patvirtinimą, naudokite išvardijimus ir grąžinkite struktūruotas klaidas, kad nukreiptumėte taisomąjį elgesį, kai įvestys yra netinkamos.
5 klausimas: ar „Letta“ yra tas pats, kas „MemGPT“?
„Letta“ remiasi „MemGPT“ tyrimais ir ekosistema, tačiau yra dabartinė platforma ir paketas, kurį turėtumėte naudoti. Paketo pervadinimo pastabose ir atviroje saugykloje paaiškinamas perėjimas ir atnaujintos API.