Tài liệu Superstep¶
Superstep là nền tảng tự host để xây workflow LangGraph trên trình duyệt
và chạy chúng như một dịch vụ. Mỗi workflow là một tài liệu JSON: backend
FastAPI kiểm tra, biên dịch nó thành StateGraph của LangGraph, rồi chạy kèm
sự kiện của từng node. Cùng một workflow có thể được khởi chạy qua HTTP, theo
lịch cron, hoặc dừng lại chờ người quyết định.
Bắt đầu nhanh¶
Mở http://localhost:5173 và tạo tài khoản bằng Đăng ký. Node LLM trả lời bằng bản mock offline cho tới khi bạn thêm credential của model, nên không cần gì thêm để làm theo phần bắt đầu nhanh: dựng một workflow, chạy, duyệt và gọi nó qua HTTP trong khoảng mười phút.
Các phần tài liệu¶
-
Bắt đầu
-
Xây dựng
Trình soạn thảo · Các loại node · State và tham chiếu · Chế độ Code · Kho tri thức · Máy chủ MCP · Node Agent · Chuyển giao giữa agent · Mẫu workflow · Phiên bản
-
Chạy
Run và trace · Duyệt bởi người · AI duyệt · Chat và tệp đính kèm · API trigger và webhook · Lịch chạy
-
Vận hành
Triển khai bằng Compose · CLI · Tài khoản · Vai trò và chia sẻ · Nhà cung cấp LLM · Kênh duyệt · Môi trường chạy Code · Quan sát hệ thống · Import repo
-
Tham chiếu
Cấu hình · HTTP API · Mã lỗi · Kiến trúc · Phím tắt · Phát triển · Câu hỏi thường gặp
Thành phần¶
| Phần | Xây trên | Vai trò |
|---|---|---|
| Editor | React, React Flow, shadcn/ui | Vẽ graph và ghi JSON của workflow; nhận sự kiện của run qua WebSocket |
| API | FastAPI, SQLAlchemy, Alembic | Lưu workflow và phiên bản, kiểm tra và biên dịch, phục vụ REST và WebSocket |
| Engine | StateGraph của LangGraph |
Chạy graph theo superstep và lưu checkpoint state sau mỗi superstep |
| Worker | Hàng đợi trong bộ nhớ hoặc Redis | Chạy run gọi qua API, run theo lịch, run được khôi phục, và gửi webhook |
| Lưu trữ | SQLite, hoặc Postgres có pgvector | Workflow, run, checkpoint, credential và vector của kho tri thức |
| Sandbox | Docker | Python trong node Tool và các repo LangGraph được import |
| Telemetry | OpenTelemetry | Mỗi run một trace, mỗi node một span, gửi tới OTLP hoặc LangSmith |
Xem Kiến trúc để biết đường đi của request và các đảm bảo khi retry và khôi phục.