Chuyển đến nội dung chính
Hướng dẫn AI

Khám phá và xây dựng Competent Enough: Hướng dẫn thực hành về kho lưu trữ sách AI mở

Hướng dẫn này giới thiệu Competent Enough, một cuốn sách về kiểm thử trí tuệ nhân tạo bằng bằng chứng thay vì cường điệu. Bạn sẽ học cách tải xuống các phiên bản mới nhất, tìm hiểu cấu trúc sách, chuẩn bị các công cụ xây dựng, tạo các định dạng xuất bản và sử dụng tính năng kiểm tra sai lệch để giữ cho sách luôn đồng bộ với các bài viết nguồn.

Khám phá và xây dựng Competent Enough: Hướng dẫn về kho sách AI mở

Đủ năng lực là một cuốn sách mở về trí tuệ nhân tạo của Fabio Akita. Sách theo chân một lập trình viên kỳ cựu trong năm 2026 khi ông xây dựng phần mềm thực tế bằng các tác nhân AI, đánh giá hàng chục mô hình trong một bài kiểm thử cá nhân, ghi lại những sai lầm và cách sửa chữa, đồng thời so sánh các thông báo của ngành với bằng chứng.

Kho lưu trữ chứa cả cuốn sách lẫn các công cụ được sử dụng để duy trì sách. Bạn có thể đọc các bản xem trước bằng tiếng Bồ Đào Nha hoặc tiếng Anh, tải xuống các định dạng hoàn chỉnh hoặc tự xây dựng từ mã nguồn bằng quy trình Ruby và xử lý tài liệu của dự án.

Bìa sách Đủ năng lực

Dự án gồm những gì

Cuốn sách dành cho những độc giả cảm thấy lo lắng hoặc không chắc chắn về AI, bao gồm các chuyên gia lo ngại bị thay thế, các bậc cha mẹ theo dõi những dự đoán về trí tuệ nhân tạo tổng quát và các nhà quản lý thường nghe đề xuất về một “cuộc chuyển đổi AI”. Cách tiếp cận của sách mang tính thực tiễn và dựa trên bằng chứng, thay vì quảng bá.

Nội dung được chia thành năm phần chính:

  • Phần I: Rốt cuộc thứ này là gì? Phần này xem xét liệu AI có thông minh hay không và AGI có đang đến gần hay không.
  • Phần II: Cuộc chạy marathon. Phần này đặt câu hỏi liệu AI có hoạt động vượt ra ngoài những màn trình diễn ấn tượng hay không.
  • Phần III: Những con số và tuyên truyền. Phần này tìm hiểu việc so sánh các mô hình và cách đánh giá các thông báo.
  • Phần IV: Ai đang nắm chìa khóa? Phần này xem xét rủi ro khi cho phép các hệ thống AI truy cập tài nguyên cá nhân hoặc vận hành.
  • Phần V: Còn công việc của tôi thì sao? Phần này đề cập đến những lo ngại về việc làm và các bước tiếp theo khả thi.

Kho lưu trữ cũng bao gồm hai phần xen kẽ, một phụ lục không yêu cầu toán học tùy chọn giải thích cách máy hoạt động bên trong, một dòng thời gian, các danh sách kiểm tra thực tiễn, một bảng thuật ngữ gồm 144 thuật ngữ và 292 tài liệu tham khảo.

Tải xuống và đọc sách

Cách đơn giản nhất để sử dụng dự án là tải xuống một bản phát hành. Mở trang Releases và chọn bản mới nhất.

  1. Chọn bản tiếng Bồ Đào Nha hoặc tiếng Anh.
  2. Chọn định dạng phù hợp với thiết bị của bạn.
  3. Tải tệp xuống từ các tài sản của bản phát hành.
  4. Mở tệp bằng thiết bị đọc sách điện tử, trình xem PDF hoặc ứng dụng đọc ưa thích của bạn.

Các định dạng hiện có bao gồm Competente-o-Suficiente.epub cho thiết bị đọc sách điện tử, Competente-o-Suficiente-ebook.pdf để đọc trên màn hình và Competente-o-Suficiente.pdf để in. Bản tiếng Anh sử dụng các tên tương ứng như Competent-Enough.epub, Competent-Enough-ebook.pdf và Competent-Enough.pdf.

Đây là các bản xem trước. Cuốn sách vẫn có thể được chỉnh sửa và dự kiến sẽ có các phiên bản mới cho đến khi tác giả tuyên bố tác phẩm đã hoàn tất.

Thiết lập môi trường xây dựng

Nếu muốn xây dựng sách từ mã nguồn, hãy sao chép kho lưu trữ và xem các tệp dự án, bao gồm docs/DESIGN.md và LICENSE.md. README xác định các phần phụ thuộc hệ thống cần thiết là Ruby, Java và poppler-utils.

Ruby chạy các tác vụ của dự án. Java là yêu cầu của epubcheck, công cụ xác thực đầu ra EPUB. Các tiện ích Poppler hỗ trợ xử lý tài liệu trong quá trình xây dựng.

Sau khi cài đặt các phần phụ thuộc này, hãy sử dụng trình chạy tác vụ của kho lưu trữ để tải về bộ công cụ được ghim phiên bản:

rake tools

Tác vụ này chuẩn bị bộ công cụ được ghi chép, bao gồm Quarto với Pandoc và Typst, cũng như epubcheck.

Xây dựng các định dạng xuất bản

Sau khi đã có các công cụ và phần phụ thuộc hệ thống, hãy chạy:

rake build

Quá trình xây dựng tạo ra các bản EPUB, PDF, web và DOCX trong build/pt/. Quá trình này cũng chạy xác thực EPUB và kiểm tra từng trang, giúp phát hiện các vấn đề trong đầu ra đã tạo.

Một quy trình điển hình là:

  1. Cài đặt Ruby, Java và poppler-utils.
  2. Chạy rake tools để tải về bộ công cụ dự án được ghim phiên bản.
  3. Cập nhật hoặc kiểm tra nội dung mã nguồn.
  4. Chạy rake build.
  5. Kiểm tra các tệp được tạo trong build/pt/ và xử lý mọi vấn đề về xác thực hoặc kiểm tra trang.

README không mô tả một thư mục đầu ra tiếng Anh riêng, vì vậy hãy làm theo tài liệu và cấu hình tác vụ hiện tại của kho lưu trữ khi làm việc với mã nguồn tiếng Anh.

Theo dõi thay đổi từ blog

Kho lưu trữ được thiết kế để luôn đồng bộ với các bài viết của tác giả trên akitaonrails.com. Mỗi đoạn văn ghi lại bài viết mà đoạn đó bắt nguồn từ. Nhờ vậy, có thể xác định những nội dung trong sách cần được xem xét khi một bài viết thay đổi.

Chạy kiểm tra sai lệch bằng lệnh:

rake drift

Lệnh này báo cáo những chương bị ảnh hưởng bởi các thay đổi trên blog và hiển thị phần khác biệt liên quan. Hãy sử dụng lệnh trước khi phát hành hoặc sau khi cập nhật các bài viết nguồn để hiểu nội dung nào cần được chỉnh sửa.

Tìm hiểu phương thức sản xuất của dự án

Kho lưu trữ xem cuốn sách như một ấn phẩm được duy trì liên tục thay vì một tài liệu tĩnh. Các sơ đồ được vẽ bằng mã, những hình minh họa do AI tạo ra được công khai trong phần ghi công hình ảnh, còn các ảnh chụp thực tế có kèm giấy phép. Bạn có thể xem thêm chi tiết về quy trình này trong docs/DESIGN.md.

Cách tiếp cận này hữu ích khi xem xét hoặc đóng góp cho dự án vì nó tách biệt nguồn gốc văn bản, tài sản được tạo và thông tin cấp phép. Trước khi phân phối lại một bản dựng, hãy đọc kỹ LICENSE.md.

Mẹo nâng cao khi làm việc với kho mã

Dùng các bản phát hành để đọc và mã nguồn để bảo trì

Nhìn chung, người đọc nên sử dụng các tài sản phát hành vì chúng đã được đóng gói sẵn cho những định dạng phổ biến. Hãy dùng kho mã nguồn khi cần kiểm tra cách xây dựng cuốn sách, tái tạo một bản dựng hoặc tìm hiểu các thay đổi giữa blog và cuốn sách.

Chạy kiểm tra sai lệch trước khi xuất bản

Nếu nội dung bài viết đã thay đổi, hãy chạy rake drift trước rake build. Việc này cung cấp danh sách tập trung các chương có khả năng đã lỗi thời và giúp giữ cho các phiên bản được tạo khớp với những bài viết nền tảng.

Đưa bước kiểm tra xác thực vào quy trình dựng

Tác vụ dựng bao gồm epubcheck và kiểm tra trang. Hãy xem các bước kiểm tra này là một phần của quy trình xuất bản thay vì tính năng bổ sung tùy chọn, đặc biệt khi thay đổi mẫu, sơ đồ hoặc cấu trúc tài liệu.

Kiểm tra giấy phép trước khi tái sử dụng

Văn bản, bìa và hình minh họa của cuốn sách thuộc bản quyền của Fabio Akita, còn các tập lệnh dựng và mẫu được cấp phép theo MIT. Phông chữ, kiểu trích dẫn và ảnh chụp có thể có giấy phép riêng được liệt kê trong LICENSE.md. Đừng cho rằng mọi tệp trong kho mã đều có cùng điều khoản tái sử dụng.

Kết luận

Competent Enough kết hợp một cuốn sách AI mang tính phản biện với quy trình xuất bản có thể tái tạo. Bạn có thể tải xuống bản xem trước từ mục Releases, dựng các định dạng hiện có bằng rake build và dùng rake drift để xác định nội dung bị ảnh hưởng bởi các thay đổi trong các bài viết nguồn. Đây là một cách thực tế để nghiên cứu các tuyên bố về AI, đồng thời tìm hiểu cách duy trì một ấn phẩm kỹ thuật dài.