--- title: "Xây dựng với AI" description: "Sử dụng Fystack với các trợ lý lập trình AI như Claude Code, Cursor, Codex và ChatGPT thông qua agent skill của Fystack, llms.txt và các trang Markdown." url: https://docs.fystack.io/vi/building-with-ai last_updated: 2026-11-13 --- > ## Documentation index > Fetch the complete documentation index at: https://docs.fystack.io/llms.txt > Use it to discover all available pages before exploring further. # Xây dựng với AI Tài liệu Fystack được viết cho cả con người và các trợ lý AI mà họ làm việc cùng. Mỗi trang đều có sẵn dưới dạng Markdown gọn gàng, và toàn bộ trang được lập chỉ mục trong tệp `llms.txt`, nhờ đó các công cụ như Claude Code, Cursor, Codex và ChatGPT có thể đọc trực tiếp tài liệu thay vì phải trích xuất từ HTML. ## Cài đặt agent skill của Fystack Một [agent skill](https://agentskills.io) là gói hướng dẫn mà trợ lý lập trình sẽ tải khi một tác vụ cần đến. Skill chính thức của Fystack, [fystack/agent-skills](https://github.com/fystack/agent-skills), hướng dẫn trợ lý của bạn cách xây dựng trên Fystack: - **REST API**: mọi endpoint cùng các trường chính, kèm cách ký request bằng HMAC hoặc Ed25519 trong bất kỳ ngôn ngữ nào. - **SDK chính thức**: `@fystack/sdk` cho TypeScript và `github.com/fystack/platform-sdk-go` cho Go. - **Webhook**: xác minh chữ ký và ghi có khoản nạp đúng một lần. - **Phê duyệt**: vai trò, nhóm phê duyệt, hạn mức tự động phê duyệt và chính sách, để trợ lý có thể trả lời câu hỏi thiết lập cũng như viết mã. Skill cũng giữ cho trợ lý của bạn tuân theo các mặc định an toàn: xây dựng trên sandbox trước, không đưa secret vào mã nguồn và không bao giờ bỏ qua bước phê duyệt của con người đối với tiền. Skill đọc tài liệu này trong lúc làm việc, nên luôn được cập nhật khi API thay đổi. Cài đặt skill cho bất kỳ trợ lý nào hỗ trợ agent skill, bao gồm Claude Code, Cursor, Codex, Gemini CLI và GitHub Copilot: ```bash npx skills add fystack/agent-skills ``` Trong Claude Code, bạn cũng có thể cài đặt skill dưới dạng plugin: ```text /plugin marketplace add fystack/agent-skills /plugin install fystack@fystack ``` Để cài đặt thủ công, hãy sao chép thư mục `skills/fystack` từ repository vào thư mục skills của trợ lý, ví dụ `.claude/skills/fystack` trong dự án của bạn. Bạn không cần nhắc đến skill sau khi cài đặt. Chỉ cần yêu cầu trợ lý thực hiện một tác vụ Fystack, như tạo ví hoặc xác minh webhook, và trợ lý sẽ tự tải skill. ## Tài liệu dạng văn bản thuần Các công cụ AI hoạt động tốt nhất với văn bản thuần. Markdown dùng ít token hơn nhiều so với HTML đã render và giữ nguyên các đoạn mã mẫu, danh sách tham số và bảng. Fystack xuất bản tài liệu dưới các dạng sau: - **`llms.txt`**: [https://docs.fystack.io/llms.txt](https://docs.fystack.io/llms.txt) là bản chỉ mục ngắn gọn của mọi trang kèm mô tả một dòng. Hãy hướng trợ lý của bạn đến đây trước để nó tự tìm được trang phù hợp. - **`llms-full.txt`**: [https://docs.fystack.io/llms-full.txt](https://docs.fystack.io/llms-full.txt) chứa mọi trang trong một tệp duy nhất. Hãy dùng khi bạn muốn trợ lý tải toàn bộ tài liệu cùng lúc và công cụ của bạn còn đủ chỗ trong cửa sổ ngữ cảnh. - **Trang Markdown**: thêm `.md` vào cuối bất kỳ URL tài liệu nào để nhận trang đó dưới dạng Markdown, ví dụ [https://docs.fystack.io/wallets.md](https://docs.fystack.io/wallets.md). - **Thương lượng nội dung**: các agent gửi header `Accept: text/markdown` sẽ nhận Markdown từ URL trang thông thường mà không cần `.md`. ```bash curl -H "Accept: text/markdown" https://docs.fystack.io/wallets ``` ## Sao chép trang vào trợ lý Mỗi trang đều có nút **Copy page** bên cạnh tiêu đề. Dùng nút này để: - **Copy page**: sao chép trang hiện tại dưới dạng Markdown, sẵn sàng để dán vào bất kỳ cuộc trò chuyện hoặc trợ lý lập trình nào. - **View as Markdown**: mở phiên bản Markdown của trang trong tab mới. - **Open in ChatGPT** hoặc **Open in Claude**: bắt đầu cuộc trò chuyện mới đã trỏ sẵn đến trang, để bạn có thể đặt câu hỏi về trang đó ngay lập tức. ## Giữ an toàn cho khóa và tiền của bạn > **Warning: Đối xử với trợ lý AI như mọi thành viên khác trong nhóm.** Chỉ cấp cho trợ lý AI quyền truy cập tối thiểu cần thiết. Dùng khóa API sandbox khi xây dựng, lưu secret trong biến môi trường thay vì trong prompt hoặc tệp đã commit, và giới hạn khóa production bằng danh sách IP được phép. Bảo vệ ví production bằng [chính sách](https://docs.fystack.io/policies.md) và [nhóm phê duyệt](https://docs.fystack.io/product/approval-group.md), để không lệnh rút tiền nào có thể được gửi đi mà không có sự phê duyệt của con người, kể cả khi trợ lý mắc lỗi.