afrom letta import Client, Agent, Tool
client = Client(api_key=os.environ.
## Χρήση του Letta ADE (Διαδρομή Χωρίς/Χαμηλό Κώδικα)
Αν προτιμάτε οπτικό πρωτοτυποποίηση, το ADE σάς επιτρέπει να συνθέσετε agents, μνήμη και εργαλεία χωρίς να γράψετε κώδικα.
- Ξεκινήστε νέο agent project στο ADE.
- Ορίστε τον ρόλο του agent (system prompt), τον τόνο, τα όρια.
- Διαμορφώστε την επίμονη μνήμη και τις στρατηγικές ανάκτησης.
- Προσθέστε εργαλεία επιλέγοντας από connectors ή ορίζοντας προσαρμοσμένες ενέργειες.
- Δοκιμάστε συνομιλίες μέσα στην πλατφόρμα, παρακολουθήστε τις εγγραφές μνήμης, ρυθμίστε τα όρια.
- Εξάγετε ή παραδώστε στους προγραμματιστές όταν το πρωτότυπό σας λειτουργεί σωστά.
Δείτε την ανακοίνωση και το tutorial του ADE για αναλυτική καθοδήγηση και ένα σύντομο εισαγωγικό βίντεο.
## Σχεδιάζοντας Εξαιρετικούς Agents στο Letta: Καλύτερες Πρακτικές με Άποψη
1) Ξεκινήστε με το έργο που πρέπει να γίνει
- Ορίστε ένα στενό πεδίο εφαρμογής (π.χ., «διαλογή υποστηρικτικών αιτημάτων για σφάλματα ιστού»), όχι έναν αόριστο γενικευμένο agent.
2) Κωδικοποιήστε τις διαδικασίες λειτουργίας
- Ενσωματώστε τα SOPs στο system prompt. Παράδειγμα: «Όταν η διαλογή υποδεικνύει επίδραση στην παραγωγή, αναβαθμίστε και ορίστε priority=high. Πάντα συμπεριλάβετε βήματα αναπαραγωγής αν υπάρχουν.»
3) Κάντε τα σχήματα εργαλείων αυστηρά
- Επιβάλετε enums και υποχρεωτικά πεδία. Αυτό μειώνει τις παραμορφωμένες παραμέτρους.
4) Αντιμετωπίστε τη μνήμη σαν επιφάνεια προϊόντος
- Αποφασίστε τι πρέπει να είναι αξέχαστο (επαφές, προτιμήσεις, προηγούμενες λύσεις) και τι εφήμερο (μονές υπολογισμοί). Ελέγχετε τακτικά τα ίχνη μνήμης.
5) Δοκιμάστε με πραγματικά δεδομένα
- Προσθέστε ανωνυμοποιημένα tickets, έγγραφα και παραδείγματα. Παρατηρήστε απρόβλεπτες συμπεριφορές (έλλειψη πλαισίου, λάθος προτεραιότητα) και βελτιώστε τα prompts/εργαλεία.
6) Προστατευτικά μέτρα > καθαρισμός μετά το γεγονός
- Προσθέστε επικυρώσεις στα εργαλεία. Αν ο agent προτείνει άκυρα inputs, ο χειριστής σας πρέπει να παρεμβαίνει με οδηγίες.
7) Καταγράψτε τα πάντα
- Καταγράψτε κλήσεις εργαλείων, εγγραφές μνήμης και τηλεμετρία μηνυμάτων. Δημιουργήστε dashboards με βασικούς δείκτες (ποσοστό επιτυχίας, χρόνος επίλυσης).
8) Διαχειριστείτε εκδόσεις των agents σας
- Παρακολουθήστε αλλαγές στα prompts, εργαλεία και πολιτικές μνήμης. Κλειδώστε γνωστές καλές εκδόσεις για παραγωγή, πειραματιστείτε σε staging.
## Κοινές Ροές Εργασίας που Μπορείτε να Αναπτύξετε με το Letta
- Υποστήριξη Πελατών
- Περίληψη συζητήσεων, πρόταση λύσης, δημιουργία tickets, ειδοποίηση εμπλεκόμενων.
- Βοηθός Έρευνας
- Σχεδιασμός ερωτημάτων, αναζήτηση πηγών, σύνθεση, αποθήκευση σημειώσεων πηγής στη μνήμη.
- Πωλήσεις / Λειτουργίες CS
- Ανάλυση σημειώσεων κλήσεων, εξαγωγή επόμενων βημάτων, ενημέρωση CRM μέσω εργαλείων, αποστολή προτυποποιημένων email.
- Εσωτερική Αυτοματοποίηση
- Παρακολούθηση ουρών, ενεργοποίηση runbooks, καταχώρηση ενημερώσεων κατάστασης, διατήρηση πλαισίου μεταξύ βαρδιών.
## Αντιμετώπιση Προβλημάτων: Όταν τα Πράγματα Δεν Λειτουργούν
- Ο agent ξεχνά
- Επιβεβαιώστε ότι η μνήμη είναι ενεργοποιημένη και τα όρια ανάκτησης κατάλληλα. Ελέγξτε αν τα στοιχεία αποθηκεύονται πραγματικά.
- Οι κλήσεις εργαλείων είναι μη έγκυρες
- Σφίξτε τα σχήματα, προσθέστε enums και επιστρέψτε δομημένα σφάλματα με οδηγίες διόρθωσης.
- Ο agent είναι υπερβολικά ή πολύ σύντομος
- Ρυθμίστε τον οδηγό στυλ του system prompt και προσθέστε 2–3 παραδείγματα εντός.
- Αντίθετες εντολές
- Ενοποιήστε τους κανόνες λειτουργίας. Χρησιμοποιήστε σαφείς προτεραιότητες: «Πάντα κάνε το X πριν το Y.»
- Εκτροπή μετά από ενημερώσεις
- Κλειδώστε εκδόσεις σε παραγωγή. Εφαρμόστε αλλαγές σταδιακά με canaries.
## Γρήγορες Σημειώσεις Ασφαλείας και Συμμόρφωσης
- Αντιμετωπίστε τα εργαλεία ως αξιόπιστες διαδρομές κώδικα — αυθεντικοποιήστε και περιορίστε τις.
- Αποκόψτε ευαίσθητα δεδομένα πριν την καταγραφή ιχνών μνήμης.
- Σκεφθείτε PII στη μνήμη: πολιτικές διατήρησης, έλεγχοι πρόσβασης, κρυπτογράφηση.
## Από το Πρωτότυπο στην Παραγωγή: Σύντομος Πίνακας Ελέγχου
- Ξεκάθαροι στόχοι OKR για τον agent (τι σημαίνει επιτυχία?).
- Στενό πεδίο εφαρμογής και σύστημα οδηγιών βασισμένο σε SOPs.
- Αυστηρά σχήματα εργαλείων με επικύρωση και δοκιμές.
- Τεκμηριωμένη και επικυρωμένη στρατηγική μνήμης με πραγματικές εργασίες.
- Παρατηρησιμότητα (logs, μετρικές, ειδοποιήσεις) ενεργοποιημένη.
- Διαχείριση εκδόσεων και σχέδιο rollback.
- Ξεχωριστά περιβάλλοντα staging και παραγωγής.
## Πρόσθετοι Πόροι Μάθησης
- Εισαγωγικό βίντεο: Δημιουργήστε τον πρώτο επίμονο agent.
- Quickstart (Python/TS) με αποσπάσματα κώδικα.
- Αρχιτεκτονική agent και βέλτιστες πρακτικές.
- Ανακοίνωση και οδηγός ADE.
- Σημειώσεις μετονομασίας πακέτων και συμβατότητας.
- Ανοικτό αποθετήριο και υπόβαθρο.
## Παρεμπιπτόντως: Γρηγορότερη επανάληψη με το [Sider.AI](https://sider.ai)
Αν τεκμηριώνετε prompts, δοκιμάζετε παραδείγματα ή συγκρίνετε output μεταξύ εκδόσεων agent, είναι χρήσιμο να κρατάτε τα τεκμήρια δίπλα-δίπλα και να επαναλαμβάνετε γρήγορα. Αξίζει να σημειωθεί ότι το [Sider.AI](https://sider.ai) (https://sider.ai/) μπορεί να βοηθήσει τις ομάδες να καταγράφουν prompts, σημειώσεις και διαφορές καθώς χτίζετε και δοκιμάζετε agents — χρήσιμο όταν πολλοί άνθρωποι βελτιώνουν SOP ή αξιολογούν σχήματα εργαλείων.
## Βασικά Συμπεράσματα
- Το Letta σας βοηθά να δημιουργείτε stateful agents με μνήμη, εργαλεία και επίμονη κατάσταση.
- Ξεκινήστε με ένα στενό έργο προς εκτέλεση και αυστηρά σχήματα για σταθερότητα.
- Χρησιμοποιήστε το SDK για code-first ροές ή το ADE για οπτική πρωτοτυποποίηση.
- Καταγράψτε, διαχειριστείτε εκδόσεις και δοκιμάστε με πραγματικά δεδομένα πριν την παραγωγή.
- Αξιοποιήστε το επίσημο quickstart και τους οδηγούς agents για να παραμείνετε σε καλές πρακτικές.
### Συχνές Ερωτήσεις (FAQ)
Q1: Τι είναι το Letta και πώς διαφέρει από έναν κανονικό chatbot;
Το Letta είναι μια πλατφόρμα για τη δημιουργία stateful AI agents με επίμονη μνήμη και ορχήστρωση εργαλείων, όχι απλώς ένας stateless wrapper συνομιλίας. Αποθηκεύει την κατάσταση του agent, επιβάλλει σχήματα εργαλείων και σας επιτρέπει να διαχειρίζεστε μνήμη και ροές εργασιών σε πολλές συνεδρίες.
Q2: Πώς μπορώ να ξεκινήσω γρήγορα να χρησιμοποιώ το Letta;
Ακολουθήστε το developer quickstart για Python ή TypeScript για να δημιουργήσετε τον πρώτο agent και να προσθέσετε εργαλεία. Αν προτιμάτε οπτική διαδρομή, χρησιμοποιήστε το ADE για να ρυθμίσετε μνήμη, prompts και εργαλεία πριν εξάγετε τη ρύθμιση.
Q3: Μπορεί το Letta να θυμάται προτιμήσεις χρήστη και προηγούμενες εργασίες;
Ναι. Το Letta υποστηρίζει επίμονη μνήμη ώστε οι agents να μπορούν να αποθηκεύουν προτιμήσεις, αποφάσεις και αποτελέσματα και να τα ανακτούν με βάση το πλαίσιο σε μελλοντικές αλληλεπιδράσεις. Ρυθμίστε πολιτικές μνήμης και επικυρώστε με πραγματικές εργασίες.
Q4: Πώς λειτουργούν τα εργαλεία στους agents του Letta;
Καταχωρείτε συναρτήσεις με αυστηρά σχήματα εισόδων έτσι ώστε ο agent να μπορεί να τις καλεί αξιόπιστα. Προσθέστε επικυρώσεις, χρησιμοποιήστε enums και επιστρέψτε δομημένα σφάλματα για να καθοδηγήσετε τη διορθωτική συμπεριφορά όταν τα inputs είναι λάθος.
Q5: Είναι το Letta το ίδιο με το MemGPT;
Το Letta βασίζεται στην έρευνα και το οικοσύστημα του MemGPT αλλά είναι η τρέχουσα πλατφόρμα και πακέτο που πρέπει να χρησιμοποιήσετε. Οι σημειώσεις μετονομασίας πακέτου και το ανοικτό αποθετήριο εξηγούν τη μετάβαση και τις ενημερωμένες API.