Trải nghiệm khi dùng OpenAI Cookbook
Bạn mở cookbook.openai.com, thấy danh sách các bài hướng dẫn có thể lọc theo chủ đề. Mỗi bài là một tình huống cụ thể, ví dụ dựng ứng dụng gọi hàm, xử lý văn bản dài hay làm tìm kiếm trên tài liệu riêng. Cách đọc giống sách nấu ăn: chọn món cần làm, xem nguyên liệu và các bước.
Nếu muốn chạy thử, bạn tải repo hoặc mở notebook rồi chạy. README nhắc bạn cần tài khoản OpenAI và một API key, đặt vào biến môi trường tên OPENAI_API_KEY, hoặc đặt trong file .env ở thư mục gốc dự án như nhiều trình soạn thảo hỗ trợ. Mỗi lần chạy sẽ gọi API thật nên có thể phát sinh chi phí theo mức dùng.
Repo này không phải một phần mềm để cài. Nó là kho tham khảo, hữu ích nhất khi bạn đã biết mình muốn làm gì và cần mẫu code sát thực tế. README cũng dẫn tới mục tài nguyên liên quan trên cookbook.openai.com cho ai muốn học thêm.
Tính năng nổi bật
Ví dụ chính thức từ OpenAI
Mẫu code do chính đơn vị làm API viết, nên cập nhật theo tính năng mới và gần với cách dùng được khuyến nghị.
Đọc dạng web gọn gàng
Trang cookbook.openai.com trình bày bài hướng dẫn dễ tìm, bạn khỏi phải lục từng thư mục.
Notebook chạy được ngay
Nhiều ví dụ ở dạng notebook, bạn chạy từng ô để thấy kết quả rồi chỉnh theo dữ liệu của mình.
Chủ yếu dùng Python
Hầu hết mẫu viết bằng Python, và README nói ý tưởng áp dụng được cho ngôn ngữ khác.
Liên kết tới tài nguyên học thêm
Có trang tổng hợp các hướng dẫn và khoá học hữu ích từ nhiều nguồn trên web.
Giấy phép MIT
Bạn được phép dùng, sửa và nhúng mẫu code vào dự án của mình theo điều khoản MIT.
Tận dụng OpenAI Cookbook vào việc gì?
Lập trình viên web, backend
Tra cứu mẫu code khi tích hợp OpenAI API
Tìm đúng ví dụ rồi sao chép khung, thay vì đọc tài liệu API từ đầu.
Đội CNTT nội bộ
Xây chatbot hỏi đáp tài liệu công ty
Tham khảo các bài về tìm kiếm trên dữ liệu riêng để dựng chatbot trả lời dựa trên văn bản của công ty.
Sinh viên, người mới học AI
Học cách dùng API qua ví dụ thực
Chạy lần lượt các notebook cơ bản để hiểu cách gửi yêu cầu, nhận kết quả và xử lý lỗi.
Trưởng nhóm kỹ thuật
Chuẩn hoá cách làm trong nhóm
Dùng các bài chính thức làm tài liệu chung để các thành viên dùng API nhất quán.
Cần chuẩn bị gì?
- Tài khoản OpenAI và API key; API tính phí theo mức dùng.
- Python và Jupyter hoặc VS Code để chạy notebook nếu muốn thử trên máy.
- Kết nối Internet vì mọi ví dụ đều gọi API trên đám mây.
- Biết lập trình cơ bản để đọc và chỉnh mẫu code.
Hướng dẫn cài đặt chi tiết
Cài trên Đọc trên web
Mở trang cookbook.openai.com và duyệt các bài theo chủ đề. Không cần cài gì.
https://cookbook.openai.comChọn bài phù hợp rồi đọc từ trên xuống. Nhiều bài có link mở notebook gốc trên GitHub.
Cài trên Chạy ví dụ trên máy
Tải repo về bằng Git, rồi mở bằng VS Code hoặc Jupyter.
git clone https://github.com/openai/openai-cookbook.gitTạo API key trên trang tài khoản OpenAI. Sau đó đặt biến môi trường OPENAI_API_KEY. Trên PowerShell, lệnh dưới đặt khoá cho phiên hiện tại; thay YOUR_API_KEY bằng khoá của bạn.
$env:OPENAI_API_KEY = "YOUR_API_KEY"Trên macOS hoặc Linux, đặt biến tương tự bằng lệnh sau, thay YOUR_API_KEY bằng khoá của bạn.
export OPENAI_API_KEY="YOUR_API_KEY"Mỗi bài có thể cần thư viện riêng nên hãy xem phần đầu notebook hoặc bài hướng dẫn để biết gói cần cài, rồi mới chạy các ô code.
Dùng thử lần đầu
Mở cookbook.openai.com và lọc bài theo chủ đề bạn quan tâm, ví dụ ứng dụng chat hoặc tìm kiếm theo tài liệu.
Đọc phần giới thiệu của bài để biết nó giải quyết vấn đề gì và cần chuẩn bị những gì.
Mở notebook tương ứng, đặt API key vào biến môi trường rồi chạy lần lượt từng ô.
Thay dữ liệu mẫu bằng dữ liệu nhỏ của bạn, ví dụ vài đoạn văn bản công ty, và quan sát kết quả.
Theo dõi mức dùng trên trang tài khoản OpenAI để biết chi phí thực tế của lần thử.
Mẹo dùng hay
- Đặt giới hạn chi tiêu hàng tháng trên tài khoản API trước khi chạy ví dụ nhiều lần.
- Ví dụ có thể nhắc tên mô hình cũ; hãy đối chiếu với danh sách mô hình hiện hành trong tài liệu chính thức của OpenAI.
- Không dán API key vào notebook rồi đẩy lên GitHub; dùng biến môi trường hoặc file .env.
- Ý tưởng trong các bài vẫn hữu ích khi bạn dùng nhà cung cấp khác, chỉ cần đổi phần gọi API.
Lưu ý và hạn chế
- Mọi ví dụ gọi OpenAI API nên phát sinh chi phí theo mức dùng và cần tài khoản.
- Đây là kho tham khảo cho lập trình viên chứ không phải ứng dụng dùng sẵn cho người không viết code.
- Tính năng và tên mô hình của API thay đổi thường xuyên, một số ví dụ có thể lệch so với phiên bản mới nhất.
Câu hỏi thường gặp
OpenAI Cookbook có miễn phí không?
Có, repo dùng giấy phép MIT và đọc miễn phí. Chỉ khi chạy ví dụ gọi OpenAI API mới tốn phí theo mức dùng.
Tôi không biết lập trình có dùng được không?
Khó. Các ví dụ viết bằng code, chủ yếu Python. Người không lập trình có thể đọc mô tả để hiểu API làm được gì nhưng khó tự chạy.
Có tiếng Việt không?
README và trang web là tiếng Anh. Bạn có thể dùng công cụ dịch trình duyệt để đọc, còn code thì không phụ thuộc ngôn ngữ.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/openai/openai-cookbook.gitRepo tương tự nên xem
Claude Cookbooks
anthropics / claude-cookbooks
Kho công thức code mẫu chính thức của Anthropic để học dùng Claude: tóm tắt, RAG, tool use, ảnh, PDF
LlamaIndex
run-llama / llama_index
Khung lập trình Python để cho AI đọc và trả lời dựa trên tài liệu, dữ liệu riêng của bạn
Generative AI for Beginners
microsoft / generative-ai-for-beginners
Khoá học 21 bài của Microsoft dạy xây ứng dụng AI tạo sinh từ con số 0, có code Python và TypeScript