SmartTeenAI — Tài liệu dành cho agent và nhà phát triển

Cách khám phá blog SmartTeenAI bằng MCP, đọc tài liệu công khai và thử sandbox không cần tài khoản.

Khi nào nên dùng SmartTeenAI

Dùng các tool MCP khi cần tìm danh mục, liệt kê hoặc đọc bài blog SmartTeenAI đã xuất bản để tóm tắt và trích dẫn nguồn. Dùng trang giới thiệu sản phẩm để giải thích các công cụ tự học tiếng Việt. Không dùng MCP này để lấy điểm, dữ liệu phụ huynh, hồ sơ học sinh, phát hiện gian lận hay tạo nội dung AI: các khả năng đó không được công bố qua API agent.

Bắt đầu không cần đăng nhập

Đọc /llms.txt, /openapi.json và danh sách tool tại /.mcp/list-tools bằng GET. Thử GET /api/agent/sandbox để nhận một kết quả mẫu cố định, được ghi nhãn dữ liệu mô phỏng. Sandbox không gọi Gemini, không đọc cơ sở dữ liệu, không tạo tài khoản và không ghi điểm. Đây là ví dụ định dạng, không phải bằng chứng chất lượng AI hay môi trường sao chép dữ liệu thật.

Gọi MCP

Kết nối MCP client hỗ trợ Streamable HTTP tới https://smartteenai.xyz/mcp. Ba tool hiện có là list_blog_categories (không có tham số), list_blog_articles (category tùy chọn; limit từ 1 đến 50, mặc định 20) và get_blog_article (category và slug bắt buộc). Dùng slug do tool liệt kê trả về; chỉ trích dẫn bài đã xuất bản. Danh sách tool đọc được công khai; thực thi tool vẫn yêu cầu OAuth. Các đường /.mcp/* là đường phụ trợ SDK, không thay thế quy trình MCP chuẩn.

Xác thực, hạn mức và lỗi

Xem /docs/auth và metadata protected-resource trước khi xin token. Không gửi mật khẩu hay API key Gemini cho agent. Sandbox và tài liệu không tính quota Gemini; dự án chưa công bố gói API AI miễn phí hoặc hệ thống tự cấp API key. Khi gọi thật, xử lý 401 bằng OAuth hợp lệ, 403 bằng quyền phù hợp, 429 bằng Retry-After nếu có và 5xx bằng thử lại có giới hạn. Không tự động lặp vô hạn và không suy diễn nội dung khi backend lỗi.