Ngày 7/11/2026, FastAPI công bố trang tài liệu mới “Develop with AI” cùng một agent skill chính thức, đóng gói ngay trong gói Python FastAPI. Skill chứa hướng dẫn khớp đúng phiên bản bạn đang cài, giúp AI coding agent viết code chính xác hơn thay vì dựa vào kiến thức cũ trong mô hình.

Đây là lần đầu FastAPI “dạy” AI agent một cách chính thức, thay vì để mỗi người tự viết prompt hay file hướng dẫn riêng.

Agent skill của FastAPI là gì?

Agent skill là gói hướng dẫn đóng gói sẵn trong package FastAPI bạn cài bằng pip hay uv. Điểm khác biệt lớn nhất: skill khớp đúng phiên bản đã cài — agent đọc hướng dẫn của đúng bản đó, không phải bản mới nhất trên mạng hay bản cũ trong dữ liệu huấn luyện. Sau khi cài, agent tự dùng skill mỗi khi làm việc với code FastAPI.

Cài đặt trong hai bước

Bước đầu tiên là cài skill. Từ thư mục dự án, chạy lệnh cài đặt rồi chọn skill FastAPI và vị trí lưu: .agents/skills cho Codex và hầu hết agent, hoặc .claude/skills cho Claude Code — chọn cả hai cũng được. Có cả lệnh không cần tương tác để dùng trong script hoặc CI.

uvx library-skills
uvx library-skills install --skill fastapi --yes
uvx library-skills install --skill fastapi --yes --claude

Bước thứ hai là khai báo entrypoint trong pyproject.toml để công cụ FastAPI tìm được app của bạn. Ví dụ main:app là đối tượng app trong file main.py — hãy đổi theo module và tên biến của dự án.

[tool.fastapi]
entrypoint = "main:app"

Chạy và deploy từ FastAPI CLI

Tài liệu mới chuẩn hóa quy trình chạy và deploy: chạy dev bằng fastapi dev, production bằng fastapi run, deploy lên FastAPI Cloud — nền tảng deploy chính thức của team FastAPI — chỉ bằng fastapi deploy. Còn có plugin FastAPI Cloud cho Codex và Claude Code, hướng dẫn tạo project, xem log và biến môi trường.

uv run fastapi dev
uv run fastapi run
uv run fastapi deploy

Vì sao FastAPI làm điều này lúc này?

Cùng ngày 7/11, FastAPI 0.162.2 đã bổ sung hướng dẫn FastAPI Cloud vào skill và hướng dẫn phát triển app bằng AI. Đây cũng là xu hướng chung: Wagtail đã ra mắt 5 agent skills chính thức từ tháng 10. Các framework đang chuyển từ “viết docs cho người đọc” sang “đóng gói hướng dẫn cho agent đọc”.

Điều này có ý nghĩa gì với bạn

Nếu đã dùng AI agent để viết FastAPI, hãy cài skill ngay: chi phí gần như bằng không, còn lợi ích là code sinh ra đúng phiên bản và đúng quy ước của dự án — đặc biệt khi dự án dùng FastAPI bản cũ hoặc có cấu trúc riêng. Lưu ý: skill chỉ là hướng dẫn — agent vẫn có thể sai, nhất là với logic nghiệp vụ phức tạp. Hãy luôn chạy test và review code sinh ra trước khi merge.

Bài viết liên quan

Câu hỏi thường gặp

Agent skill khác gì copy tài liệu dán vào prompt?

Skill theo chuẩn Agent Skills, agent tự nạp khi cần và luôn khớp đúng phiên bản đã cài. Copy-paste thủ công vừa tốn token, vừa dễ lỗi thời, vừa phải lặp lại ở mỗi phiên mới.

Skill có thay thế việc đọc tài liệu FastAPI không?

Không. Skill giúp agent viết code chuẩn hơn, nhưng quyết định kiến trúc, thiết kế API và review cuối cùng vẫn là việc của bạn.

Dùng AI agent nào thì cài được skill này?

Skill theo chuẩn mở nên dùng được với Claude Code, Codex và hầu hết agent hiện nay. Tài liệu chính thức hướng dẫn hai vị trí quen thuộc là .agents/skills và .claude/skills.

💬 Tin này ảnh hưởng tới dự án của bạn thế nào? Chia sẻ góc nhìn của bạn trong phần bình luận — mình đọc hết và sẽ tổng hợp những ý hay nhất.

Nguồn tham khảo