afrom letta import Client, Agent, Tool
client = Client(api_key=os.environ.
## Letta ADE:n Käyttö (Vähäkoodinen Polku)
Jos haluat visuaalista prototypointia, ADE antaa sinun rakentaa agentteja, muistia ja työkaluja ilman koodaamista.
- Aloita uusi agenttiprojekti ADE:ssä.
- Määritä agentin rooli (järjestelmäkehotus), sävy ja rajat.
- Konfiguroi muistin pysyvyys ja hakustrategiat.
- Lisää työkaluja valitsemalla liittimiä tai määrittämällä omia toimintoja.
- Testaa keskusteluja suoraan, seuraa muistin kirjoituksia, säädä kynnysarvoja.
- Vie tai anna kehittäjien viimeistellä, kun prototyyppisi toimii oikein.
Kattava kävely ja esittelyvideo löytyvät ADE:n julkaisuilmoituksesta ja tutoriaalista.
## Loistavien Letta-agenttien Suunnitteluperiaatteet
1) Aloita tehtävästä, joka pitää tehdä
- Määrittele kapea tehtäväalue (esim. ’käsittele verkkovirheiden tukilippuja’), älä epämääräinen yleisagentti.
2) Koodaa toimintatavat
- Lisää toimintaprosessisi järjestelmäkehotukseen. Esim: ’Kun triage osoittaa tuotantovaikutuksen, lisää prioriteetiksi korkea ja nosta tapausta. Sisällytä aina tarvittaessa toistovaiheet.’
3) Tee työkalujen kaavoista tiukkoja
- Varmista enum-arvot ja vaaditut kentät. Tämä vähentää harhaanjohtavia parametreja.
4) Kohtele muistia tuotepintana
- Päätä mitä pitäisi muistaa (yhteystiedot, mieltymykset, aiemmat ratkaisut) ja mikä on ohimenevää (kertaluontoiset laskelmat). Tarkastele muistin jälkiä säännöllisesti.
5) Testaa todellisilla tiedoilla
- Syötä agentille anonymisoituja lippuja, dokumentteja ja esimerkkejä. Tarkkaile virhetilanteita (puuttuva konteksti, väärä prioriteetti) ja hienosäädä kehotteita ja työkaluja.
6) Suojakaiteet ennen jälkisiivousta
- Lisää validointia työkaluihin. Jos agentti ehdottaa virheellisiä syötteitä, käsittelijäsi tulisi tunnistaa ne ja vastata ohjeilla.
7) Instrumentoi kaikki
- Kirjaa työkalukutsut, muistin kirjoitukset ja viestien telemetria. Luo dashboardit keskeisille mittareille (onnistumisprosentti, ratkaisuaika).
8) Versioi agenttisi
- Seuraa muutoksia kehotteissa, työkaluissa ja muistipolitiikoissa. Laita tuotantoversiot lukkoon, kehitä testausympäristössä.
## Yleisiä Työnkulkuja, Joita Voit Toimittaa Letan Kanssa
- Asiakastuki
- Tiivistä keskusteluketjuja, ehdota ratkaisua, luo lippuja, ilmoita sidosryhmille.
- Tutkimusapuri
- Suunnittele kyselyjä, etsi lähteitä, kokoaa yhteen, tallenna lähdemuistiin muistiinpanoja.
- Myynti/CS-operaatiot
- Jäsennä puhelumuistiinpanot, erottele seuraavat askeleet, päivitä CRM työkaluin, seuraa valmiilla sähköpostipohjilla.
- Sisäinen automaatio
- Valvo jonoja, laukaise runbookit, tallenna tilapäivitykset ja pidä konteksti siirtojen yli.
## Vianetsintä: Kun Asiat Eivät Toimi
- Agentti unohtaa asioita
- Varmista, että muisti on päällä ja hakukynnykset sopivat. Tarkista, tallentuuko tieto oikein.
- Työkalukutsut ovat vääränmuotoisia
- Kiristä kaavoja, lisää enum-arvot ja palauta jäsenneltyjä virheitä korjaavia vihjeitä.
- Agentti on liian pitkä tai lyhyt
- Säädä järjestelmäkehotuksen tyyliopasta ja anna 2–3 sisäistä esimerkkiä.
- Ristiriitaiset ohjeet
- Yhdistä toimintaperiaatteet. Käytä selkeitä prioriteetteja: ’Tee aina X ennen Y:tä.’
- Muutosten aiheuttama vaihtelu
- Lukitse versiot tuotannossa. Käytä ketterästi asteittaista käyttöönottoa.
## Turvallisuus ja Säädösten Noudattaminen: Pikamuistiinpanot
- Kohtele työkaluja luotettuina koodipolkuina—todennus ja oikeuksien rajaus.
- Pyyhi arkaluontoiset tiedot ennen muistin jälkien kirjaamista.
- Huomioi henkilötietojen käsittely muistissa: säilytyskäytännöt, käyttöoikeudet, salaus.
## Prototyypistä Tuotantoon: Lyhyt Tarkistuslista
- Selkeät OKR:t agentille (mitä menestys tarkoittaa?).
- Kapea tehtäväalue ja SOP-ohjattu järjestelmäkehotus.
- Tiukat työkalukaavat validoinnilla ja testeillä.
- Muististrategia dokumentoituna ja validoituna oikeilla tehtävillä.
- Havainnointimahdollisuudet (lokit, metriikat, hälytykset) käyttöön.
- Versiointi ja palautussuunnitelma.
- Erotellut testaus- ja tuotantoympäristöt.
## Lisäoppimateriaalit
- Esittelyvideo: luo ensimmäinen pysyvä agentti.
- Nopeaan alkuun (Python/TS) koodiesimerkeillä.
- Agentin arkkitehtuuri ja parhaat käytännöt.
- ADE:n julkaisuilmoitus ja kävely läpi.
- Paketin uudelleennimeäminen ja yhteensopivuusmuistiinpanot.
- Avoimen lähdekoodin repositorio ja taustatiedot.
## Muuten: Nopeampi iterointi [Sider.AI](https://sider.ai) -työkalulla
Jos dokumentoit kehotteita, testausesimerkkejä tai vertailet agenttiversioiden tuloksia, on kätevää pitää artefaktit rinnakkain ja kehittää nopeasti eteenpäin. Kannattaa huomioida, että [Sider.AI](https://sider.ai) (https://sider.ai/) auttaa tiimejä tallentamaan kehotteita, muistiinpanoja ja eroavaisuuksia samalla kun rakennat ja testaat agentteja—kätevää silloin, kun useampi henkilö hioo SOPia tai arvioi työkalujen kaavoja.
## Keskeiset Opit
- Letta auttaa rakentamaan tilallisia agentteja muistilla, työkaluilla ja pysyvällä tilalla.
- Aloita kapealla tehtävällä ja tiukoilla kaavoilla vakauden takaamiseksi.
- Käytä SDK:ta koodipainotteisiin työnkulkuihin tai ADE:tä visuaaliseen prototypointiin.
- Instrumentoi, versioi ja testaa oikeilla tiedoilla ennen julkaisua.
- Hyödynnä virallista nopean alun opasta ja agenttien oppaita pysyäksesi parhaita käytäntöjä noudattaen.
### Usein Kysytyt Kysymykset
K1: Mikä on Letta ja miten se eroaa tavallisesta chatbotista?
Letta on alusta tilallisten tekoälyagenttien rakentamiseen, jotka sisältävät pysyvän muistin ja työkalujen orkestroinnin, eikä pelkkä staattinen keskustelukehys. Se tallentaa agentin tilan, valvoo työkalujen kaavoja ja hallinnoi muistia sekä työnkulkuja istuntojen yli.
K2: Miten pääsen nopeasti alkuun Letan kanssa?
Seuraa kehittäjille tarkoitettua nopean alun ohjetta Pythonille tai TypeScriptille luodaksesi ensimmäisen agentin ja liittääksesi työkaluja. Jos haluat visuaalisen polun, käytä ADE:tä konfiguroidaksesi muistin, kehotteet ja työkalut ennen asetuksen vientiä.
K3: Voiko Letta muistaa käyttäjän mieltymyksiä ja aiempia tehtäviä?
Kyllä. Letta tukee pysyvää muistia, joten agentit voivat tallentaa mieltymyksiä, päätöksiä ja tuloksia ja hakea ne kontekstuaalisesti tulevissa vuorovaikutuksissa. Määritä muistipolitiikat ja validoi ne oikeilla tehtävillä.
K4: Miten työkalut toimivat Letta-agenttien kanssa?
Rekisteröit funktioita tiukoilla syötekaavoilla, jotta agentti voi kutsua niitä luotettavasti. Lisää validointi, käytä enum-arvoja ja palauta jäsenneltyjä virheitä ohjaamaan korjaavia toimia, kun syötteet ovat viallisia.
K5: Onko Letta sama asia kuin MemGPT?
Letta pohjautuu MemGPT-tutkimukseen ja ekosysteemiin, mutta on nykyinen käytettävä alusta ja paketti. Paketin uudelleennimeäminen ja avoimen lähdekoodin repo selittävät siirtymän ja päivitetyt rajapinnat.