Cách Sử Dụng AI OpenHands: Hướng Dẫn Thực Hành về Thiết lập, Lời nhắc và Quy trình Làm việc Thực tế
Nếu bạn từng ước có một nhà phát triển giỏi có thể lập trình cặp với bạn 24/7, thì AI OpenHands gần như đáp ứng được điều đó. Đây là một "kỹ sư AI" mã nguồn mở có thể đọc kho lưu trữ của bạn, viết mã, chạy thiết bị đầu cuối, duyệt tài liệu và lặp lại—giống như một nhà phát triển cấp dưới học hỏi nhanh chóng và làm việc không mệt mỏi. Nhưng sức mạnh chỉ phát huy khi bạn thiết lập đúng cách và học cách điều khiển nó.
Hướng dẫn này sẽ hướng dẫn bạn cách sử dụng AI OpenHands từng bước—từ cài đặt đến quy trình làm việc nâng cao—để bạn có thể xuất xưởng nhanh hơn một cách tự tin.
- Những gì chúng ta sẽ đề cập:
- Các tùy chọn cài đặt và khởi động nhanh
- Chạy OpenHands cục bộ hoặc với các mô hình đám mây
- Các phương pháp hay nhất cho lời nhắc, kho lưu trữ và tác vụ
- Các quy trình làm việc đã được chứng minh cho công việc tính năng, gỡ lỗi, kiểm tra và tài liệu
- Các biện pháp bảo vệ, quyền riêng tư và cộng tác
Đáng chú ý: OpenHands đang được phát triển tích cực bởi nhóm All Hands và cộng đồng. Tài liệu chính thức là kim chỉ nam cho các hướng dẫn và mẹo hiện tại. Bạn cũng có thể theo dõi các hướng dẫn cài đặt thực tế từ những người thực hành đã ghi lại các thiết lập cục bộ và VM. Để chạy với các mô hình cục bộ, tài liệu cũng bao gồm hướng dẫn cụ thể.
AI OpenHands Là Gì—và Tại Sao Nên Sử Dụng?
Hãy nghĩ về AI OpenHands như một đồng đội AI có bàn phím. Không giống như các trợ lý chỉ trò chuyện, OpenHands có thể:
- Sử dụng thiết bị đầu cuối để chạy các lệnh, kiểm tra và trình kiểm tra lỗi
- Chỉnh sửa mã trên các tệp và thư mục
- Duyệt web (tùy thuộc vào cấu hình)
- Đề xuất và áp dụng các kế hoạch từng bước
Điều này làm cho nó trở nên lý tưởng cho các tác vụ như triển khai các tính năng, sửa lỗi, viết kiểm tra, tạo tài liệu, tái cấu trúc và hiện đại hóa cơ sở mã. Thay vì tung hứng các lời nhắc và sao chép/dán, bạn đưa ra cho OpenHands một mục tiêu và để nó lặp lại, với sự giám sát của bạn đối với các động thái của nó.
Khởi Động Nhanh: Cách Nhanh Nhất để Sử Dụng OpenHands
Có một số cách để bắt đầu. Lựa chọn của bạn tùy thuộc vào việc bạn muốn sử dụng LLM đám mây hay chạy mọi thứ cục bộ.
Tùy chọn A: Sử dụng LLM Đám Mây (dễ nhất)
- Làm theo tài liệu "Bắt Đầu Xây Dựng" và "Bắt Đầu" chính thức để cài đặt và chạy ứng dụng. Bạn thường sẽ:
- Cài đặt các điều kiện tiên quyết (Docker, Node, Python, Git tùy thuộc vào đường dẫn)
- Cung cấp khóa API cho một mô hình đám mây được hỗ trợ (ví dụ: OpenAI, Anthropic hoặc các mô hình khác mà dự án hỗ trợ tại thời điểm đó)
- Khởi chạy giao diện OpenHands và kết nối kho lưu trữ của bạn
Đường dẫn này giúp bạn làm việc hiệu quả nhanh chóng với chi phí tính toán tối thiểu.
Tùy chọn B: Chạy OpenHands với LLM Cục Bộ
- Nếu bạn thích giữ mã và lời nhắc khỏi đám mây hoặc muốn tránh chi phí API, hãy sử dụng hướng dẫn LLM Cục Bộ trong tài liệu chính thức.
- Thiết lập một mô hình cục bộ tương thích (thông qua Ollama hoặc các phần phụ trợ khác được hỗ trợ tại thời điểm đó)
- Định cấu hình các điểm cuối mô hình và giới hạn ngữ cảnh
- Đảm bảo máy của bạn có đủ VRAM/CPU và dung lượng đĩa
Tùy chọn C: Triển khai lên VM
- Nếu bạn cần một môi trường chuyên dụng, những người thực hành đã ghi lại cách khởi động OpenHands trên VM và xây dựng một ứng dụng trong vài phút. Điều này hữu ích cho các nhóm muốn có một phiên bản kỹ sư AI ổn định, được chia sẻ.
Lần Chạy Đầu Tiên: Thiết Lập Dự Án và Đặt Khung Tác Vụ
OpenHands tỏa sáng khi nó có thể nhìn thấy mã của bạn. Bắt đầu bằng cách:
- Mở kho lưu trữ mà bạn muốn nó làm việc trên đó.
- Chạy hoặc lập chỉ mục dự án để OpenHands có thể ánh xạ cấu trúc.
- Đưa ra cho nó một mục tiêu rõ ràng với các ràng buộc.
Ví dụ về cách đặt khung tác vụ tốt:
- "Thêm chức năng đặt lại mật khẩu người dùng vào dịch vụ
auth bằng các liên kết email dựa trên mã thông báo. Sử dụng mô-đun mailer hiện có. Thêm các bài kiểm tra đơn vị cho việc tạo và hết hạn mã thông báo. Không thay đổi lược đồ dữ liệu người dùng."
Tại sao điều này hiệu quả:
- Nó nêu tên thành phần, phạm vi, các phụ thuộc và ranh giới. Bạn càng rõ ràng, OpenHands càng lập kế hoạch và thực hiện tốt hơn.
Cách Viết Lời Nhắc Hiệu Quả cho OpenHands
Hãy nghĩ về lời nhắc như các phiếu yêu cầu ngắn gọn. Những lời nhắc tốt nhất:
- Xác định kết quả: "Triển khai X với các ràng buộc Y"
- Tham khảo các tệp, mô-đun hoặc bài kiểm tra: "Xem
auth/routes.py và tests/test_auth.py"
- Nêu các ràng buộc: "Không thay đổi lược đồ DB; giữ các giao diện hiện có"
- Bao gồm các tiêu chí chấp nhận: "Các bài kiểm tra phải vượt qua:
pytest -k password_reset"
Mẫu bạn có thể tái sử dụng:
Mục tiêu: <Những gì bạn muốn xây dựng hoặc sửa chữa>
Ngữ cảnh: <Các tệp liên quan, các ràng buộc đã biết, các dịch vụ bên ngoài>
Chấp nhận: <Việc vượt qua trông như thế nào: các bài kiểm tra, điểm cuối, số liệu>
Ranh giới: <Những gì không được thay đổi hoặc các cách tiếp cận cần tránh>
Công cụ: <Các lệnh nó có thể chạy, các tập lệnh hoặc nguồn dữ liệu>
Quy Trình Làm Việc Cốt Lõi: Lập Kế Hoạch → Thực Hiện → Xác Minh → Tinh Chỉnh
OpenHands thường đề xuất một kế hoạch nhiều bước. Đây là cách hướng dẫn nó:
- Phê duyệt hoặc điều chỉnh kế hoạch của nó sớm. Thúc đẩy nó chạy các bài kiểm tra trước để làm cơ sở cho các lỗi.
- Yêu cầu nó tạo hoặc cập nhật một bài kiểm tra để xác định thành công, sau đó triển khai mã.
- Yêu cầu nó chạy bộ kiểm tra và trình kiểm tra lỗi thường xuyên.
- Nếu nó bị đình trệ, hãy thêm ngữ cảnh: tên tệp, dấu vết ngăn xếp hoặc nhật ký.
Mẹo chuyên nghiệp: Khuyến khích các thay đổi nhỏ có kích thước PR thay vì các chỉnh sửa nguyên khối. Điều này giúp xem xét và hoàn nguyên.
Các Quy Trình Làm Việc Mẫu Bạn Có Thể Sao Chép
1) Triển Khai Tính Năng
- Lời nhắc: "Thêm chức năng xuất CSV vào trang
orders. Sử dụng phân trang phía máy chủ, truyền kết quả qua text/csv. Thêm nút Export trong OrdersTable.jsx và điểm cuối trong routes/orders.ts. Bao gồm các bài kiểm tra cho phân trang và tiêu đề."
- Quét kho lưu trữ; dự thảo kế hoạch
- Thêm điểm cuối và nút máy khách
- Viết các bài kiểm tra và chạy chúng
- Bạn giám sát, phê duyệt các thay đổi và hợp nhất sau khi mọi thứ ổn.
2) Gỡ Lỗi Bản Dựng Thất Bại
- Lời nhắc: "CI đang gặp lỗi trên Node 20. Sửa các lỗi nhập ESM/CJS trong
build.mjs. Giữ các plugin rollup hiện có; cập nhật cấu hình và mã để vượt qua CI."
- Cung cấp nhật ký hoặc liên kết đến các tạo phẩm CI.
- Yêu cầu OpenHands sao chép cục bộ (
npm run build) và đề xuất các khác biệt tối thiểu.
3) Kiểm Tra Phạm Vi Phủ Sóng và Tăng Cường
- Lời nhắc: "Tăng phạm vi phủ sóng cho
payments/service.py từ 62% lên 85%+. Thêm các bài kiểm tra đơn vị cho retry_charge, refund, webhook_signature. Không sửa đổi logic nghiệp vụ trừ khi bài kiểm tra phát hiện ra một lỗi."
- Hãy để OpenHands tạo các bài kiểm tra, chạy chúng và tinh chỉnh.
4) Tài Liệu và Trải Nghiệm Nhà Phát Triển
- Lời nhắc: "Tạo
CONTRIBUTING.md và DEVELOPMENT.md cho kho lưu trữ này. Bao gồm thiết lập môi trường, tập lệnh, lệnh kiểm tra và hướng dẫn PR."
- Yêu cầu nó xác minh các lệnh bằng cách thực sự chạy chúng.
Các Biện Pháp Bảo Vệ: Giữ OpenHands Hữu Ích và An Toàn
- Phạm vi thư mục: Trỏ nó vào một kho lưu trữ hoặc thư mục cụ thể để tránh các chỉnh sửa ngẫu nhiên ở nơi khác.
- Bảo vệ tệp: Đánh dấu các tệp cấu hình hoặc cơ sở hạ tầng quan trọng là chỉ đọc nếu có thể.
- Kiểm tra lệnh: Yêu cầu phê duyệt cho các lệnh phá hoại (ví dụ:
rm -rf, đặt lại cơ sở dữ liệu).
- Vệ sinh bí mật: Không bao giờ dán khóa API vào lời nhắc. Sử dụng các biến môi trường và nhật ký được che.
- Truy cập mạng: Nếu duyệt web được bật, hãy tạo hộp cát và ghi nhật ký các cuộc gọi đi.
Các Mô Hình Cục Bộ so với Đám Mây: Chọn Lựa Chọn Phù Hợp Với Bạn
- Ưu điểm: Lý luận/mã hóa mạnh mẽ, thiết lập tối thiểu, lặp lại nhanh chóng
- Nhược điểm: Chi phí liên tục, các cân nhắc về quản trị dữ liệu
- Ưu điểm: Quyền riêng tư, kiểm soát, khả năng dự đoán chi phí
- Nhược điểm: Yêu cầu phần cứng, chất lượng mô hình khác nhau, cần điều chỉnh nhiều hơn
Xem hướng dẫn LLM Cục Bộ chính thức để định cấu hình các phần phụ trợ mô hình và giới hạn bộ nhớ.
Làm Việc Nhóm: Sử Dụng OpenHands trong Luồng Cộng Tác
- Quy trình làm việc ưu tiên nhánh: Yêu cầu OpenHands tạo một nhánh tính năng và đẩy các thay đổi để xem xét PR.
- Vệ sinh cam kết: Yêu cầu nó tạo ra các cam kết nguyên tử với các thông báo rõ ràng và số tham chiếu vấn đề.
- Các mẫu PR: Tạo và thực thi các mẫu PR để người xem biết những gì đã thay đổi và lý do.
- Chủ sở hữu mã: Kết hợp với CODEOWNERS để định tuyến các PR do AI tạo ra đến đúng người xem xét.
Khắc Phục Sự Cố Các Vấn Đề Thường Gặp
- Nó bị kẹt hoặc lặp lại: Thu hẹp phạm vi. Yêu cầu nó giải thích bước tiếp theo của nó. Cung cấp một bài kiểm tra thất bại.
- Các khác biệt lộn xộn: Yêu cầu một kế hoạch nhỏ hơn, theo giai đoạn—các bài kiểm tra trước, sau đó là các thay đổi mã tối thiểu.
- Chỉnh sửa tệp sai: Chỉ định các đường dẫn chính xác và nhắc nhở nó về các ranh giới.
- Vượt qua cục bộ nhưng thất bại trong CI: Chia sẻ chi tiết môi trường CI và nhật ký; yêu cầu nó sao chép bằng một vùng chứa.
Các Mẹo về Hiệu Suất và Các Bước Di Chuyển Mạnh Mẽ
- Ngữ cảnh khởi động ấm: Yêu cầu nó đọc các tệp chính trước (
README, package.json, các tệp dịch vụ chính).
- Cung cấp cho nó các tập lệnh: Cung cấp một
make test hoặc npm run verify để nó có thể xác thực nhanh chóng.
- Dạy miền: Cung cấp một cái nhìn tổng quan kiến trúc ngắn gọn; nó sẽ được đền đáp bằng ít lỗi logic hơn.
- Thực thi kiểu: Trỏ đến cấu hình
.eslintrc, .prettierrc, black/ruff để nó định dạng chính xác.
- Sử dụng các điểm kiểm tra: Sau mỗi cột mốc quan trọng, hãy yêu cầu một bản tóm tắt và các bước tiếp theo để giữ cho nó đi đúng hướng.
Tình Huống Thực Tế: Từ Báo Cáo Lỗi đến Bản Vá Trong Một Giờ
- Tình huống: Một lỗi sản xuất làm giảm 500 lỗi không được xử lý trên các tải trọng JSON bị lỗi trong API
orders.
- Lời nhắc của bạn: "Tái tạo lỗi 500 trên JSON bị lỗi trong
orders POST. Thêm xác thực lược đồ và trả về 400 với chi tiết lỗi. Cập nhật các bài kiểm tra để bao gồm các tải trọng bị lỗi."
- Chạy API cục bộ, tái tạo lỗi
- Thêm một lớp xác thực và trình xử lý lỗi
- Cập nhật các bài kiểm tra và đảm bảo CI vượt qua
- Tạo ra một PR nhỏ gọn với một mục nhật ký thay đổi
Thời gian tiết kiệm được: Bạn tập trung vào phân tích tác động và triển khai, trong khi OpenHands xử lý giàn giáo.
Các Tích Hợp Siêu Nạp OpenHands
- Trình chạy kiểm tra: pytest, Jest, Vitest, JUnit
- Công cụ xây dựng: Vite, Webpack, Rollup, Babel
- Trình quản lý gói: npm, pnpm, yarn, pip/poetry
- Trình kiểm tra lỗi/trình định dạng: ESLint, Prettier, black, ruff
- Vùng chứa: Docker Compose để tương đương cục bộ với CI
Bằng cách tiêu chuẩn hóa các công cụ này, OpenHands có thể suy luận về ngăn xếp của bạn một cách đáng tin cậy hơn và tự động hóa nhiều hơn vòng lặp phát triển.
Nhân Tiện: Sử Dụng Sider.AI Cùng Với OpenHands
Điểm liên quan: 8/10. Nếu bạn đang sử dụng OpenHands làm kỹ sư AI của mình, thì bạn nên ghép nó với một phi công nghiên cứu và soạn thảo cho các thông số kỹ thuật, mô tả PR và tài liệu. Nhân tiện, Sider.AI có thể giúp bạn nhanh chóng soạn thảo các thông số kỹ thuật kỹ thuật, tóm tắt RFC hoặc biến nhật ký chạy OpenHands thành nhật ký thay đổi và ghi chú phát hành sạch sẽ. Sự kết hợp này làm giảm việc chuyển đổi ngữ cảnh: OpenHands xử lý các hành động mã trong khi Sider.AI biến các kết quả thành tài liệu sạch sẽ, hướng đến người dùng.
Danh Sách Kiểm Tra Bảo Mật, Quyền Riêng Tư và Tuân Thủ
- Giữ bí mật trong các biến môi trường; không bao giờ nhúng khóa vào lời nhắc
- Xem xét mọi thay đổi do AI tạo ra giống như PR của một nhà phát triển cấp dưới
- Ghi nhật ký các lệnh và hành động để có khả năng kiểm tra
- Ghim các phiên bản chuỗi công cụ; tránh các nâng cấp ngẫu nhiên trong các tệp khóa
- Nếu sử dụng LLM đám mây, hãy điều chỉnh theo chính sách lưu giữ dữ liệu của bạn
Khi Nào Không Nên Sử Dụng OpenHands
- Thiết kế thuật toán mới mà không có giàn giáo kiểm tra hoặc đặc tả mạnh mẽ
- Các cơ sở mã được quản lý chặt chẽ mà không có quy trình xem xét mạnh mẽ
- Các tập lệnh dùng một lần mà việc viết mã thủ công nhanh hơn
60 Phút Đầu Tiên Của Bạn với OpenHands: Một Sổ Tay Nhỏ
- Phút 0–10: Cài đặt và khởi chạy bằng cách sử dụng Khởi Động Nhanh chính thức
- Phút 10–20: Kết nối kho lưu trữ của bạn; yêu cầu nó ánh xạ cấu trúc dự án
- Phút 20–35: Xác định một mục tiêu nhỏ, có thể kiểm tra được; phê duyệt kế hoạch của nó
- Phút 35–50: Hãy để nó triển khai và chạy các bài kiểm tra; thúc đẩy khi cần thiết
- Phút 50–60: Xem xét các khác biệt, tinh chỉnh và hợp nhất vào một nhánh tính năng
Các Liên Kết Chính và Các Bước Tiếp Theo
- Tài liệu "Bắt Đầu Xây Dựng" và tài liệu sử dụng chính thức cho OpenHands: các mẹo, khởi động nhanh và các phương pháp hay nhất.
- Hướng dẫn thiết lập LLM Cục Bộ: định cấu hình và chạy OpenHands hoàn toàn trên máy của bạn.
- Hướng dẫn cài đặt do cộng đồng điều khiển trên VM: các bước cài đặt thực tế và một dự án trình diễn nhanh.
Những Điều Cần Nhớ
- Đặt khung tác vụ như các phiếu yêu cầu với các tiêu chí chấp nhận rõ ràng.
- Giữ các lần lặp lại nhỏ; kiểm tra sớm và thường xuyên.
- Sử dụng các biện pháp bảo vệ và xem xét các thay đổi—hãy đối xử với nó như một đồng đội cấp dưới.
- Chọn đám mây để thuận tiện, các mô hình cục bộ để bảo vệ quyền riêng tư.
- Ghép nối với các công cụ tài liệu (ví dụ: Sider.AI) để tăng tốc các thông số kỹ thuật và ghi chú phát hành.
Câu Hỏi Thường Gặp
Q1: Làm cách nào để cài đặt và bắt đầu sử dụng AI OpenHands một cách nhanh chóng?
Sử dụng khởi động nhanh chính thức để cài đặt các điều kiện tiên quyết, cắm LLM được hỗ trợ (đám mây hoặc cục bộ) và khởi chạy UI để kết nối kho lưu trữ của bạn. Tài liệu "Bắt Đầu Xây Dựng" cung cấp hướng dẫn từng bước với các mẹo thiết lập.
Q2: Tôi có thể chạy OpenHands với LLM cục bộ thay vì mô hình đám mây không?
Có. Hãy làm theo hướng dẫn LLM Cục Bộ để định cấu hình phần phụ trợ mô hình cục bộ và điều chỉnh cài đặt ngữ cảnh. Điều này lý tưởng cho các dự án nhạy cảm về quyền riêng tư hoặc tránh chi phí API.
Q3: Cách tốt nhất để nhắc OpenHands cho các tác vụ viết mã là gì?
Viết lời nhắc như các phiếu yêu cầu ngắn gọn: xác định mục tiêu, tham khảo các tệp cụ thể, đặt ranh giới và bao gồm các tiêu chí chấp nhận. Yêu cầu nó tạo hoặc chạy các bài kiểm tra để xác thực tiến trình.
Q4: AI OpenHands có an toàn để sử dụng trên mã sản xuất không?
Hãy đối xử với nó như một nhà phát triển cấp dưới: sử dụng các biện pháp bảo vệ nhánh, xem xét mã và CI để xác thực các thay đổi. Thêm các biện pháp bảo vệ cho các lệnh và giữ bí mật khỏi lời nhắc.
Q5: OpenHands so sánh với một trợ lý mã truyền thống như thế nào?
Không giống như các công cụ chỉ trò chuyện, OpenHands có thể chạy các lệnh, chỉnh sửa tệp và lặp lại một cách tự động trong kho lưu trữ của bạn. Nó được xây dựng cho các tác vụ đầu cuối như các tính năng, gỡ lỗi và kiểm tra.
