afrom letta import Client, Agent, Tool
client = Client(api_key=os.environ.
## Izmantojot Letta ADE (bezkoda/zema koda ceļš)
Ja dod priekšroku vizuālai prototipēšanai, ADE ļauj veidot aģentus, atmiņu un rīkus bez koda rakstīšanas.
- Sāc jaunu aģenta projektu ADE vidē.
- Definē aģenta lomu (sistēmas uzdevumu), toni un robežas.
- Konfigurē atmiņas saglabāšanas un izgūšanas stratēģijas.
- Pievieno rīkus, izvēloties savienotājus vai definējot pielāgotas darbības.
- Testē sarunas tieši lietotnē, novēro atmiņas ierakstus, regulē sliekšņus.
- Eksportē vai nodod izstrādātājiem, tiklīdz prototips darbojas pareizi.
Skaties ADE paziņojumu un apmācību ar īsu ievada video.
## Padomi lielisku Letta aģentu izstrādei
1) Sāc ar darba uzdevumu
- Definē šauru mērķi (piemēram, “atbalsta biļešu triaža tīmekļa kļūdu gadījumā”), nevis vispārēju aģentu.
2) Ieprogrammē darbības vadlīnijas
- Ievieto SOP sistēmas komandā. Piemērs: “Kad triaža norāda ražošanas ietekmi, eskalē un iestati prioritāti=augsta. Vienmēr iekļauj atkārtošanas soļus, ja pieejami.”
3) Izmanto stingras shēmas rīkiem
- Nodrošini izpildāmās vērtības un obligātus laukus. Tas samazina izdomātu parametru skaitu.
4) Izturies pret atmiņu kā produktu virsmu
- Izlem, kas jāatceras (kontakti, preferences, iepriekšējie risinājumi) un kas ir īslaicīgs (reizēju aprēķinu dati). Regulāri pārbaudi atmiņas ierakstus.
5) Testē ar reāliem datiem
- Iesēj aģentā anonimizētas biļetes, dokumentus un piemērus. Novēro neveiksmes gadījumus (trūkstošs konteksts, nepareiza prioritāte) un pilnveido uzvedni/rīkus.
6) Drošības margas > pēctecīga tīrīšana
- Pievieno validāciju rīkos. Ja aģents piedāvā nederīgus ievades datus, rokas izpildītājam jāuzķer un jāsniedz norādes.
7) Monitorē visu
- Žurnāli rīku izsaukumiem, atmiņas ierakstiem un ziņojumu līmeņa telemetrijai. Izveido informācijas paneļus svarīgajiem KPI (veiksmes rādītājs, risināšanas laiks).
8) Versiju savus aģentus
- Izseko izmaiņas uzvednēs, rīkos un atmiņas politikā. Fiksē zināmi labās versijas ražošanai, iterē testvidē.
## Parastās darbplūsmas, ko vari izstrādāt ar Lettu
- Klientu atbalsts
- Apkopot sarunas pavedienus, ieteikt risinājumus, veidot biļetes, paziņot iesaistītajiem.
- Pētniecības asistents
- Plānot vaicājumus, meklēt avotus, sintetizēt, glabāt avotu piezīmes atmiņā.
- Pārdošanas/CS darbības
- Apstrādāt zvanu piezīmes, izdalīt nākamos soļus, atjaunināt CRM ar rīkiem, sekot līdzi ar sagatavotām e-pastiem.
- Iekšējā automatizācija
- Pārraudzīt rindas, aktivizēt darbību rokasgrāmatas, iesniegt statusa atjauninājumus un saglabāt kontekstu maiņu laikā.
## Problēmu risināšana: kad kaut kas nedarbojas kā paredzēts
- Aģents aizmirst lietas
- Pārbaudi, vai atmiņa ir ieslēgta un izgūšanas sliekšņi ir atbilstoši. Pārliecinies, ka vienumi patiešām tiek saglabāti.
- Rīku izsaukumi ir bojāti
- Stiprināt shēmas, pievienot vērtību kopas un atgriezt strukturētas kļūdas ar labojumu padomiem.
- Aģents ir pārāk daudz runā vai pārāk kodolīgs
- Pielāgo sistēmas komandas stila vadlīnijas un sniedz 2–3 tiešas paraugu rindas.
- Konfliktējošas instrukcijas
- Konsolidē darbību noteikumus. Izmanto skaidras prioritātes: “Vienmēr dari X pirms Y.”
- Kļūda pēc atjauninājumiem
- Versiju bloķēšana ražošanā. Ievies izmaiņas pa daļām (kanarīnu izplatīšana).
## Drošības un atbilstības īsie padomi
- Izturies pret rīkiem kā uzticamiem koda ceļiem — autentificē un ierobežo pieejas.
- Noņem sensitīvus datus pirms atmiņas ierakstu žurnāla saglabāšanas.
- Apsver personas identificējamās informācijas (PII) aizsardzību atmiņā: saglabāšanas politikas, piekļuves kontroli, šifrēšanu.
## No prototipa līdz ražošanai: īss kontrolsaraksts
- Skaidri definēti OKR aģentam (kas ir panākums?).
- Šaura darbības joma un SOP vadīta sistēmas komanda.
- Stingras rīku shēmas ar validāciju un testiem.
- Dokuments par atmiņas stratēģiju un validācija ar reāliem uzdevumiem.
- Uzraudzība (žurnāli, metriki, brīdinājumi) sakārtota.
- Versiju kontrole un atjaunošanas plāns.
- Atdalītas testēšanas un ražošanas vides.
## Papildu mācību resursi
- Ievada video: izveido savu pirmo pastāvīgo aģentu.
- Ātrais sākums (Python/TS) ar koda fragmentiem.
- Aģentu arhitektūra un labākās prakses.
- ADE paziņojums un apmācība.
- Pakotņu pārdēvēšana un saderības piezīmes.
- Atvērtā koda repozitorijs un fons.
## Starp citu: ātrāka iterācija ar [Sider.AI](https://sider.ai)
Ja dokumentē promptus, testē piemērus vai salīdzina iznākumus dažādās aģentu versijās, ērti ir vienlaikus redzēt artefaktus un ātri iterēt. Vērts zināt, ka [Sider.AI](https://sider.ai) (https://sider.ai/) palīdz komandām uztvert promptus, piezīmes un atšķirības, veidojot un testējot aģentus — īpaši noderīgi, ja vairāki cilvēki pilnveido SOP vai novērtē rīku shēmas.
## Galvenie secinājumi
- Letta palīdz izveidot valsts aģentus ar atmiņu, rīkiem un pastāvīgu stāvokli.
- Sāc ar šauru uzdevumu un stingrām shēmām stabilitātei.
- Izmanto SDK kodēšanas pirmajām darbplūsmām vai ADE vizuālai prototipēšanai.
- Monitorē, versē un testē ar reāliem datiem pirms palaišanas ražošanā.
- Izmanto oficiālo ātro startu un aģentu vadlīnijas, lai ievērotu labākās prakses.
### BUJ
J1: Kas ir Letta un kā tā atšķiras no parasta čatbota?
Letta ir platforma valsts AI aģentu izveidei ar pastāvīgu atmiņu un rīku koordināciju, ne tikai bezstāvokļa čata apvalks. Tā glabā aģenta stāvokli, nodrošina rīku shēmu izpildi un ļauj pārvaldīt atmiņu un darbplūsmas pāri sesijām.
J2: Kā ātri sākt izmantot Lettu?
Seko izstrādātāju ātrajam startam Python vai TypeScript, lai izveidotu savu pirmo aģentu un pievienotu rīkus. Ja dod priekšroku vizuālam ceļam, izmanto ADE, lai konfigurētu atmiņu, uzvednes un rīkus pirms eksportēšanas.
J3: Vai Letta spēj atcerēties lietotāju preferences un iepriekšējos uzdevumus?
Jā. Letta atbalsta pastāvīgo atmiņu, tāpēc aģenti var glabāt preferences, lēmumus un rezultātus, pēc tam izgūt tos kontekstā nākamajās mijiedarbībās. Konfigurē atmiņas politikas un pārbaudi ar reāliem uzdevumiem.
J4: Kā darbojas rīki Lettā?
Tu reģistrē funkcijas ar stingrām ievades shēmām, lai aģents varētu uzticami tās izsaukt. Pievieno validāciju, izmanto vērtību kopas un atgriez strukturētas kļūdas, lai norādītu labošanas ceļu, ja ievades dati ir nepareizi.
J5: Vai Letta ir tas pats kas MemGPT?
<a119>Letta balstās uz MemGPT pētījumiem un ekosistēmu, bet ir pašreizējā platforma un pakotne, ko izmantot. Pakotnes pārdēvēšanas piezīmes un atvērtā repozitorija dokumentācija skaidro pāreju un atjaunotos API.