Trải nghiệm khi dùng Agno
README mở đầu bằng một cách làm khá khác lạ: bạn đưa cho trợ lý lập trình đang dùng (Claude Code, Codex, Cursor...) một câu nhắc yêu cầu nó tải mẫu agentos-railway và làm theo file hướng dẫn thiết lập. Trợ lý sẽ chạy nền tảng trên máy bạn và giúp dựng agent đầu tiên, nên người dùng thật sự phải làm khá ít lệnh bằng tay.
Kết quả bạn có là một máy chủ API và MCP, cơ sở dữ liệu PostgreSQL lưu hội thoại và bộ nhớ, cùng các kỹ năng để xây dựng và cải thiện agent. Có thể kết nối với giao diện quản trị tại os.agno.com để xem hội thoại, truy vết và quản lý tri thức.
Agno hướng tới việc vận hành agent như một đội: giao việc, đặt lịch định kỳ, duyệt các hành động nhạy cảm trước khi chạy. Phần Company OS còn là hướng mới, nên với người mới nên bắt đầu từ một agent đơn giản.
Tính năng nổi bật
Agent, nhóm và quy trình
Dựng agent có công cụ, ghép thành nhóm hoặc quy trình có định tuyến, điều kiện, vòng lặp, chạy song song.
AgentOS
Chạy agent như dịch vụ với API, MCP server, xác thực, phân quyền, chạy lại và thực thi bền vững.
Bộ nhớ và tri thức
Nhớ người dùng qua các phiên và tìm câu trả lời từ dữ liệu của bạn.
Duyệt trước khi chạy
Hành động nhạy cảm có thể dừng lại chờ người phê duyệt rồi mới tiếp tục.
Lịch chạy và theo dõi
Đặt lịch cho agent, nhóm, quy trình; xem truy vết từng lần chạy để tìm lỗi.
Mẫu cho nhiều đám mây
Có mẫu Docker, Railway, AWS, GCP, Azure để triển khai nhanh.
Tận dụng Agno vào việc gì?
Lập trình viên, startup
Agent hỗ trợ khách hàng trong sản phẩm
Chạy agent qua REST API và nhúng vào ứng dụng, có bộ nhớ và phân quyền theo người dùng.
Đội vận hành
Trợ lý nội bộ trong Slack
Cho agent nhận yêu cầu qua Slack bằng Interfaces và trả lời dựa trên tài liệu công ty.
Người quản lý quy trình
Quy trình định kỳ có người duyệt
Đặt lịch cho agent làm báo cáo và dừng chờ duyệt ở bước gửi.
Người dùng nâng cao
Dùng agent làm công cụ trong Claude hoặc ChatGPT
Các agent được phơi ra qua MCP nên ứng dụng chat khác có thể gọi.
Cần chuẩn bị gì?
- Một trợ lý lập trình (Claude Code, Codex, Cursor...) nếu theo cách README gợi ý, hoặc kiến thức Python để tự dựng.
- Docker và Git để chạy mẫu; Docker chạy PostgreSQL và dịch vụ.
- API key của nhà cung cấp mô hình.
- Tài khoản os.agno.com nếu muốn dùng giao diện quản trị của Agno.
Hướng dẫn cài đặt chi tiết
Cài trên Qua trợ lý lập trình
Mở trợ lý lập trình bạn đang dùng trong một thư mục trống và đưa cho nó câu nhắc sau theo README.
Help me set up my agent platform and build my first agent. Clone https://github.com/agno-agi/agentos-railway into a folder called agent-platform, cd into it, and follow .agents/skills/setup-platform/SKILL.md.Trợ lý sẽ chạy nền tảng cục bộ và hướng dẫn bạn dựng agent đầu tiên. Theo dõi các lệnh nó chạy và xác nhận những bước quan trọng.
Cài trên Chọn mẫu theo nơi chạy
Nếu muốn tự làm, chọn một trong các mẫu chính thức. Mẫu Docker nằm tại kho agentos-docker.
git clone https://github.com/agno-agi/agentos-docker.gitĐọc README trong mẫu để biết cách cấu hình khoá API và khởi động. Tài liệu đầy đủ ở docs.agno.com.
Dùng thử lần đầu
Sau khi trợ lý thiết lập xong, mở địa chỉ dịch vụ cục bộ mà nó báo và kiểm tra API đang chạy.
Cho trợ lý xây agent đầu tiên với một việc đơn giản, ví dụ trả lời câu hỏi từ một vài tài liệu của bạn.
Kết nối nền tảng với os.agno.com để xem hội thoại và truy vết.
Đọc tài liệu về human approval và scheduling trước khi cho agent làm việc có tác động thật.
Mẹo dùng hay
- Dùng dữ liệu thử khi mới làm quen, vì agent lưu hội thoại và bộ nhớ vào PostgreSQL.
- Chạy bằng một mô hình có giới hạn chi tiêu trên tài khoản API.
- Đọc phần security trong tài liệu trước khi mở dịch vụ ra Internet.
Lưu ý và hạn chế
- README tập trung vào cách làm cùng trợ lý lập trình; nếu bạn không quen công cụ này, quá trình có thể khó theo dõi.
- Một số phần như giao diện quản trị và các tính năng nâng cao gắn với dịch vụ của Agno, có thể có phí.
- Dự án thay đổi hướng nhanh (từ framework agent sang nền tảng), nên bài hướng dẫn cũ có thể khác bản hiện tại.
Câu hỏi thường gặp
Agno có miễn phí không?
Mã nguồn dùng giấy phép Apache-2.0 và miễn phí. Bạn tự chịu chi phí hạ tầng và mô hình AI; giao diện quản trị và một số dịch vụ đi kèm có thể có điều khoản riêng.
Tôi không biết lập trình có dùng được không?
Khá khó. Có thể nhờ trợ lý lập trình hỗ trợ nhưng bạn vẫn cần hiểu Docker, API key và cách đọc kết quả.
Dữ liệu của tôi lưu ở đâu?
README nói bạn chạy nền tảng trong cloud của mình và giữ dữ liệu trong tầm kiểm soát; hội thoại lưu ở PostgreSQL bạn quản lý.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/agno-agi/agno.gitRepo tương tự nên xem
LangGraph
langchain-ai / langgraph
Khung thấp tầng của LangChain để dựng agent AI chạy lâu, có trạng thái và cho người duyệt giữa chừng
CrewAI
crewAIInc / crewAI
Dựng đội agent AI theo vai trò (nhà nghiên cứu, người viết...) cùng làm một việc, bằng Python
Letta
letta-ai / letta
Nền tảng tạo trợ lý AI có trí nhớ lâu dài, nay đã chuyển sang công cụ Letta Code dùng trong Terminal