afrom letta import Client, Agent, Tool
client = Client(api_key=os.environ.
## Sử Dụng Letta ADE (Đường No-Code/Less-Code)
Nếu bạn thích phác thảo bằng giao diện, ADE cho phép bạn cấu thành đại lý, bộ nhớ và công cụ mà không cần viết code.
- Bắt đầu một dự án đại lý mới trong ADE.
- Xác định vai trò đại lý (lời nhắc hệ thống), tông giọng, giới hạn.
- Cấu hình lưu trữ và lấy lại bộ nhớ.
- Thêm công cụ bằng cách chọn từ các kết nối hoặc định nghĩa hành động tùy chỉnh.
- Thử các cuộc hội thoại ngay trong giao diện, quan sát ghi bộ nhớ, điều chỉnh ngưỡng.
- Xuất hoặc bàn giao cho lập trình viên khi mẫu hoạt động đúng.
Xem thông báo và hướng dẫn ADE để có video giới thiệu và tuần tự chi tiết.
## Thiết Kế Đại Lý Letta Tuyệt Vời: Những Thực Hành Hữu Ích
1) Bắt đầu với công việc cần làm
- Định nghĩa phạm vi hẹp (ví dụ, “phân loại vé hỗ trợ lỗi web”), không làm đại lý chung chung mơ hồ.
2) Mã hóa quy trình vận hành
- Đưa quy trình chuẩn (SOP) vào lời nhắc hệ thống. Ví dụ: “Khi phân loại ảnh hưởng sản xuất, tăng cấp và đặt ưu tiên = cao. Luôn bao gồm bước tái hiện nếu có.”
3) Bắt buộc định dạng công cụ nghiêm ngặt
- Tuân thủ các giá trị enum và trường bắt buộc. Điều này giảm tham số ảo hóa.
4) Xem bộ nhớ như bề mặt sản phẩm
- Quyết định điều gì cần ghi nhớ (liên hệ, sở thích, các lần giải quyết trước) và điều gì tạm thời (tính toán một lần). Kiểm tra dấu vết bộ nhớ thường xuyên.
5) Kiểm thử với dữ liệu thực
- Cung cấp đại lý với vé, tài liệu và ví dụ đã ẩn danh. Chú ý lỗi (thiếu ngữ cảnh, ưu tiên sai) và chỉnh sửa lời nhắc/công cụ.
6) Hàng rào bảo vệ > dọn dẹp hậu kỳ
- Thêm xác thực trong công cụ. Nếu đại lý đề xuất đầu vào sai, bộ xử lý của bạn phải bắt và hướng dẫn sửa chữa.
7) Ghi chép mọi thứ
- Ghi nhật ký gọi công cụ, ghi bộ nhớ và số liệu mức tin nhắn. Tạo bảng chỉ số cho các chỉ số then chốt (tỷ lệ thành công, thời gian xử lý).
8) Phiên bản hóa đại lý
- Theo dõi thay đổi lời nhắc, công cụ và chính sách bộ nhớ. Định vị phiên bản tốt đã kiểm nghiệm cho sản xuất, lặp lại trong môi trường thử nghiệm.
## Quy Trình Phổ Biến Có Thể Triển Khai Với Letta
- Hỗ Trợ Khách Hàng
- Tóm tắt chuỗi hội thoại, đề xuất giải pháp, tạo vé, thông báo cho bên liên quan.
- Trợ Lý Nghiên Cứu
- Lập kế hoạch truy vấn, tìm nguồn, tổng hợp, lưu ghi chú nguồn trong bộ nhớ.
- Vận Hành Bán Hàng/CS
- Phân tích ghi chú cuộc gọi, trích xuất bước tiếp theo, cập nhật CRM qua công cụ, theo dõi email mẫu.
- Tự Động Hóa Nội Bộ
- Giám sát hàng đợi, kích hoạt runbook, báo cáo tình trạng, và duy trì ngữ cảnh qua ca làm việc.
## Khắc Phục Sự Cố: Khi Đại Lý Không Hoạt Động Đúng
- Đại lý quên thông tin
- Đảm bảo bộ nhớ được bật và ngưỡng truy xuất phù hợp. Kiểm tra xem mục có thực sự được lưu trữ.
- Gọi công cụ bị sai định dạng
- Siết chặt định dạng, thêm enum, trả về lỗi có cấu trúc và hướng dẫn sửa.
- Đại lý nói quá dài hoặc quá ngắn
- Điều chỉnh hướng dẫn phong cách lời nhắc và cung cấp 2–3 ví dụ trực tiếp.
- Mâu thuẫn chỉ dẫn
- Hợp nhất quy tắc vận hành. Sử dụng ưu tiên rõ ràng: “Luôn làm X trước Y.”
- Trôi dạt sau cập nhật
- Khóa phiên bản ở sản xuất. Triển khai thay đổi bằng phương pháp canary.
## Ghi Chú Nhanh Về An Ninh và Tuân Thủ
- Xem công cụ như đường dẫn mã tin cậy—xác thực và giới hạn phạm vi.
- Ẩn dữ liệu nhạy cảm trước khi ghi dấu vết bộ nhớ.
- Cân nhắc PII trong bộ nhớ: chính sách lưu giữ, kiểm soát truy cập, mã hóa.
## Từ Mẫu Thử Đến Sản Xuất: Danh Sách Kiểm Tra Ngắn Gọn
- Mục tiêu rõ ràng cho đại lý (thành công là gì?).
- Phạm vi hẹp và lời nhắc hệ thống dựa trên SOP.
- Định dạng công cụ nghiêm ngặt với xác thực và kiểm thử.
- Chiến lược bộ nhớ được trình bày và xác thực với tác vụ thực.
- Quan sát (nhật ký, chỉ số, cảnh báo) được thiết lập.
- Kế hoạch phiên bản và hoàn nguyên.
- Môi trường thử nghiệm và sản xuất tách biệt.
## Tài Nguyên Học Tập Thêm
- Video giới thiệu: tạo đại lý bền vững đầu tiên của bạn.
- Khởi đầu nhanh (Python/TS) với đoạn mã mẫu.
- Kiến trúc đại lý và thực hành tốt nhất.
- Thông báo ADE và hướng dẫn chi tiết.
- Ghi chú đổi tên gói và tương thích.
- Kho mã nguồn mở và bối cảnh nền tảng.
## Nhân Tiện Nói Đến: Lặp Nhanh Hơn Với [Sider.AI](https://sider.ai)
Nếu bạn đang tài liệu hóa lời nhắc, kiểm thử ví dụ hoặc so sánh kết quả giữa các phiên bản đại lý, việc giữ artefact bên cạnh nhau và lặp nhanh rất tiện lợi. Nên biết rằng [Sider.AI](https://sider.ai) (https://sider.ai/) giúp nhóm thu giữ lời nhắc, ghi chú và khác biệt trong khi bạn xây dựng và kiểm thử đại lý—rất hữu ích khi nhiều người cùng tinh chỉnh SOP hoặc đánh giá định dạng công cụ.
## Những Điểm Chính Cần Nhớ
- Letta giúp bạn xây dựng đại lý có trạng thái với bộ nhớ, công cụ và trạng thái bền vững.
- Bắt đầu với công việc hẹp cần làm và định dạng nghiêm ngặt để đảm bảo ổn định.
- Sử dụng SDK cho quy trình code trước hoặc ADE cho phác thảo trực quan.
- Ghi chép, phiên bản và kiểm thử với dữ liệu thực trước khi đưa vào vận hành.
- Tận dụng hướng dẫn khởi đầu nhanh và tài liệu đại lý chính thức để đảm bảo tuân theo thực hành tốt nhất.
### Câu Hỏi Thường Gặp
Q1: Letta là gì và nó khác bot chat thông thường thế nào?
Letta là nền tảng xây dựng đại lý AI có trạng thái với bộ nhớ bền vững và điều phối công cụ, không chỉ là bộ khung chat không trạng thái. Nó lưu trạng thái đại lý, bắt buộc định dạng công cụ, và cho phép quản lý bộ nhớ cùng quy trình qua các phiên trò chuyện.
Q2: Làm sao bắt đầu dùng Letta nhanh chóng?
Theo khởi đầu nhanh dành cho nhà phát triển với Python hoặc TypeScript để tạo đại lý đầu tiên và thêm công cụ. Nếu bạn thích giao diện trực quan, dùng ADE để cấu hình bộ nhớ, lời nhắc và công cụ, rồi xuất ra thiết lập.
Q3: Letta có thể nhớ sở thích người dùng và tác vụ trước không?
Có. Letta hỗ trợ bộ nhớ bền vững để đại lý lưu giữ sở thích, quyết định và kết quả, rồi truy xuất theo ngữ cảnh trong tương tác tương lai. Cấu hình chính sách bộ nhớ và xác thực với tác vụ thực tế.
Q4: Công cụ hoạt động thế nào trong đại lý Letta?
Bạn đăng ký các hàm với định dạng đầu vào nghiêm ngặt để đại lý có thể gọi chúng đáng tin cậy. Thêm xác thực, dùng enum và trả lỗi cấu trúc để hướng dẫn sửa khi đầu vào không chính xác.
Q5: Letta có giống MemGPT không?
<a119>Letta phát triển trên nền tảng nghiên cứu và hệ sinh thái MemGPT nhưng là nền tảng và gói bạn nên dùng hiện nay. Phần ghi chú đổi tên gói và kho mã nguồn mở giải thích quá trình chuyển đổi và API cập nhật.