Convex Agents
Bộ mẫu mã để xây dựng AI agent trên Convex: quản lý thread, tool calling, streaming, RAG và workflow nhiều bước.
Lập trìnhTrung cấp★ 402⑂ 32Điểm AI 7/10Cập nhật lần cuối: 6 thg 2, 2026
Làm được gì
- Hướng dẫn cấu hình agent với component
@convex-dev/agent. - Mã mẫu tạo/liệt kê thread hội thoại và đọc tin nhắn, giúp lịch sử chat được lưu bền.
- Định nghĩa tool (function calling), phản hồi dạng streaming, tìm kiếm vector cho RAG.
- Workflow nghiên cứu nhiều bước (tìm → phân tích → tóm tắt) và schema Convex kèm vectorIndex.
- Kèm ví dụ giao diện chat React và danh sách lỗi thường gặp cùng quy tắc an toàn (không tự chạy
npx convex deployhay lệnh git).
Phù hợp với ai
- Lập trình viên full-stack dùng Convex làm backend và muốn thêm chatbot/agent AI.
- Người làm TypeScript + React cần prototype nhanh chat streaming và RAG.
- Ai muốn chạy workflow agent dài trên nền serverless một cách đáng tin cậy.
Ví dụ sử dụng
- "Tạo backend chat lưu thread theo từng user trên Convex" → sinh schema và các mutation/query.
- "Thêm tool tạo task và tìm kiếm knowledge base cho agent" → sinh
tool()và action kèm systemPrompt. - "Dựng RAG: lưu embedding tài liệu rồi trả lời dựa trên vector search" → schema vectorIndex và query tìm kiếm.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/waynesutton/convexskills/HEAD/skills/convex-agents/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục skills/convex-agents từ repo GitHub waynesutton/convexskills vào ~/.claude/skills/convex-agents/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/waynesutton/convexskills.git /tmp/convexskills && mkdir -p ~/.claude/skills && cp -r /tmp/convexskills/skills/convex-agents ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal.
- Clone repo:
git clone https://github.com/waynesutton/convexskills.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Copy skill:
cp -r convexskills/skills/convex-agents ~/.claude/skills/ - Kiểm tra tồn tại tệp
~/.claude/skills/convex-agents/SKILL.md. - Khởi động lại Claude Code, rồi yêu cầu ví dụ: "Xây agent chat bằng Convex".
- Cài dependency trong project:
npm install @convex-dev/agent ai openai
Xem mã nguồn trên GitHub ↗Giấy phép: Apache-2.0