Hướng dẫn Oh My Pi: Xây dựng ứng dụng hoàn chỉnh với Grok làm tác nhân mã hoá của bạn

Vì sao dùng Oh My Pi?

Một tác nhân mã hoá tốt cần hai yếu tố: một mô hình tác nhân mạnh và một bộ khung mã hoá vững chắc.

Mô hình cung cấp trí tuệ. Trong hướng dẫn này, chúng ta dùng Grok 4.6, do xAI xây dựng cho tác vụ mã hoá, tác nhân chạy dài và công việc nhiều bước trên toàn bộ codebase. Nó hỗ trợ cửa sổ ngữ cảnh 500K token, đầu vào hình ảnh, gọi hàm, thực thi mã và tìm kiếm web.

Nhưng ngay cả mô hình tốt nhất cũng bị giới hạn nếu bộ khung chỉ cho phép đọc và ghi văn bản. Để làm việc như một lập trình viên thực thụ, mô hình cần có khả năng:

• Kiểm tra một kho mã và chỉnh sửa tệp một cách đáng tin cậy
• Chạy lệnh và thực thi kiểm thử
• Đọc chẩn đoán và gỡ lỗi lỗi thất bại
• Tìm kiếm tài liệu và xác minh rằng các thay đổi thực sự hoạt động

Đó là những gì OMP cung cấp: tích hợp LSP, trình gỡ lỗi thực thụ, thực thi mã liên tục, công cụ trình duyệt và web, tích hợp GitHub, bộ nhớ và các tác nhân phụ chạy song song. Kết hợp với mô hình, chúng tạo nên vòng lặp tác nhân đầy đủ:

Lập kế hoạch → kiểm tra → chỉnh sửa → chạy → gỡ lỗi → kiểm thử → xác minh

Mô hình quyết định làm gì, còn OMP cung cấp công cụ để thực hiện. Và vì OMP hỗ trợ hơn 60 nhà cung cấp AI, bạn không bị khóa vào Grok. Quy trình làm việc tương tự áp dụng dù bạn kết nối Grok, Claude hay một mô hình khác.

Cài đặt Oh My Pi

Oh My Pi là một nhánh (fork) của tác nhân mã hoá Pi mã nguồn mở, do Stencil Labs xây dựng, và đã nhanh chóng trở thành một trong những tác nhân mã hoá trong terminal phổ biến, với hơn 34.000 sao trên GitHub. Nó được thiết kế cho các nhà phát triển muốn một môi trường mã hoá sẵn sàng sử dụng mà không phải tốn thời gian lắp ghép và cấu hình một ngăn xếp tác nhân tuỳ chỉnh.

OMP hoạt động trên Linux, macOS và Windows.

Trên Linux hoặc macOS, chạy:

curl -fsSL https://omp.sh/install | shĐược hỗ trợ bởi

Trên Windows PowerShell:

irm https://omp.sh/install.ps1 | iexĐược hỗ trợ bởi

Bạn cũng có thể cài đặt toàn cục bằng Bun (phiên bản 1.3.14 trở lên):

bun install -g @oh-my-pi/pi-coding-agentĐược hỗ trợ bởi

Nếu lệnh omp không được tìm thấy sau khi cài đặt, hãy khởi động lại terminal hoặc kiểm tra đầu ra của trình cài đặt để biết vị trí cài đặt.

Sau đó xác minh cài đặt:

omp --versionĐược hỗ trợ bởi

Ví dụ:

omp/18.0.6Được hỗ trợ bởi

Nếu xuất hiện số phiên bản, OMP đã được cài đặt đúng và lệnh omp sẵn sàng sử dụng.

Thiết lập quyền truy cập SpaceXAI

Để dùng Grok với Oh My Pi, bạn có hai lựa chọn.

Nếu bạn chỉ đang thử mô hình hoặc làm theo hướng dẫn này, tôi khuyên dùng API của xAI. Tạo tài khoản tại https://console.x.ai/, nạp một khoản tín dụng trả trước nhỏ và tạo khoá API. xAI trừ trực tiếp mức sử dụng từ số dư tín dụng của bạn, giúp bạn kiểm soát chi tiêu dễ dàng.

Nếu bạn dự định dùng Grok cho việc mã hoá thường xuyên, đăng ký SuperGrok có thể hợp lý hơn. OMP hỗ trợ SuperGrok trực tiếp qua SpaceXAI OAuth, vì vậy bạn có thể kết nối đăng ký của mình bằng /login thay vì trả tiền cho từng yêu cầu API riêng lẻ.

Trong hướng dẫn này, chúng ta sẽ dùng phương pháp API vì dễ thử nghiệm và kiểm soát chi phí hơn.

Tạo khoá API của bạn trong bảng điều khiển nhà phát triển SpaceXAI và lưu lại an toàn. OMP tự động tìm biến môi trường XAI_API_KEY.

Trên Linux hoặc macOS:

export XAI_API_KEY="your-xai-api-key"Được hỗ trợ bởi

Để giữ lại sau khi khởi động lại terminal:

echo 'export XAI_API_KEY="your-xai-api-key"' >> ~/.bashrc
source ~/.bashrcĐược hỗ trợ bởi

Trên Windows PowerShell:

$env:XAI_API_KEY="your-xai-api-key"Được hỗ trợ bởi

Bạn có thể kiểm tra các mô hình Grok sẵn có với:

omp models xaiĐược hỗ trợ bởi

Khởi động Oh My Pi với Grok

Tạo một thư mục mới để thử nghiệm tác nhân mã hoá:

mkdir grok-pi-demo
cd grok-pi-demoĐược hỗ trợ bởi

Khởi tạo kho Git để OMP có thể theo dõi các thay đổi nó thực hiện:

git initĐược hỗ trợ bởi

Giờ hãy khởi động Oh My Pi:

ompĐược hỗ trợ bởi

Lần khởi chạy đầu, OMP có thể mở một trình hướng dẫn thiết lập ngắn để cấu hình nhà cung cấp, tìm kiếm web và giao diện. Bạn cũng có thể chạy omp setup bất kỳ lúc nào để mở lại.

Vì chúng ta đã cấu hình biến môi trường XAI_API_KEY, bạn không cần đăng nhập xAI lần nữa. Nhấn Esc khi hoàn tất phần thiết lập nhà cung cấp.

Nếu bạn dùng đăng ký SuperGrok thay vì tín dụng API, hãy chọn xAI Grok OAuth (SuperGrok hoặc X Premium+) từ màn hình đăng nhập.

Khi OMP mở, nhập:

/modelĐược hỗ trợ bởi

Chọn xAI từ danh sách nhà cung cấp và chọn:

grok-4.6Được hỗ trợ bởi

Để dùng Grok 4.7 mới hơn, hãy chọn grok-4.7 tại đây. Mọi thứ khác trong hướng dẫn này giữ nguyên.

OMP cũng hiển thị thông tin hữu ích về mô hình, bao gồm cửa sổ ngữ cảnh, giá, hỗ trợ lập luận và khả năng thị giác.

Giờ bạn đã có Grok chạy trong Oh My Pi như một tác nhân mã hoá dựa trên terminal. Từ đây, nó có thể dùng các công cụ tích hợp của OMP để kiểm tra tệp, chỉnh sửa mã, thực thi lệnh, chạy kiểm thử, gỡ lỗi và xử lý các tác vụ phát triển lớn hơn.

Khám phá các tính năng tích hợp của Oh My Pi

Oh My Pi đi kèm 31 công cụ tích hợp và hỗ trợ hơn 60 nhà cung cấp AI, vì vậy hầu hết quy trình mã hoá hoạt động mà không cần cài thêm plugin hoặc máy chủ MCP.

Một số khả năng tích hợp hữu ích nhất gồm:

• Quản lý tệp: Đọc, tạo, chỉnh sửa, tìm kiếm và sửa đổi cấu trúc tệp.

• Truy cập terminal: Chạy lệnh shell và quản lý tiến trình trực tiếp từ tác nhân.

• Thực thi mã: Chạy các phiên Python và JavaScript liên tục.

• Tích hợp LSP: Điều hướng định nghĩa, tìm tham chiếu, đổi tên ký hiệu, xem chẩn đoán và áp dụng hành động mã.

• Trình gỡ lỗi: Gỡ lỗi các ứng dụng Python, Go, C/C++ và ngôn ngữ được hỗ trợ qua tích hợp DAP.

• Tìm kiếm web: Tìm tài liệu, GitHub, Stack Overflow, Reddit, kho gói, các bài nghiên cứu và web rộng hơn.

• Tự động hoá trình duyệt: Mở và tương tác với website qua trình duyệt dựa trên Chromium.

• Tác nhân phụ: Chia nhỏ tác vụ mã hoá lớn giữa nhiều tác nhân làm việc song song.

• Công cụ GitHub: Làm việc với kho, issue, pull request, tìm kiếm mã và GitHub Actions.

• Bộ nhớ: Lưu trữ và gọi lại thông tin dự án hữu ích giữa các phiên mã hoá.

• Hiểu hình ảnh: Kiểm tra ảnh chụp màn hình, sơ đồ và các hình ảnh cục bộ khác.

• Tạo ảnh: Tạo hoặc chỉnh sửa hình ảnh bằng các nhà cung cấp AI được hỗ trợ.

• Chuyển văn bản thành giọng nói: Tạo giọng nói bằng xAI Grok Voice.

• Tệp từ xa: Đọc tệp trên máy từ xa qua đường dẫn ssh://.

• Quản lý phiên: Tạo điểm lưu, tua lại, rẽ nhánh, tiếp tục và quản lý các phiên tác nhân dài.

• Điều phối tác nhân: Các từ khoá như orchestrate và workflowz trong lời nhắc của bạn sẽ phối hợp nhiều tác nhân phụ cho các tác vụ phức tạp.

Một số công cụ này, bao gồm GitHub, bộ nhớ, tạo ảnh, chuyển văn bản thành giọng nói và checkpoint, bị tắt theo mặc định. Bạn có thể bật chúng trong phần cài đặt của OMP.

Nói cách khác, mô hình có thể làm nhiều hơn là sinh mã. Thông qua Oh My Pi, nó có thể tìm kiếm web, hiểu một codebase, chỉnh sửa tệp, chạy lệnh, gỡ lỗi, ghi nhớ ngữ cảnh dự án và phối hợp nhiều tác nhân từ cùng một giao diện terminal.

Xây dựng một dự án với Oh My Pi và Grok

Thay vì thử nghiệm thiết lập bằng một câu hỏi mã hoá đơn giản, hãy giao cho nó một dự án hoàn chỉnh và xem Grok cùng Oh My Pi xử lý việc lập kế hoạch, triển khai, kiểm thử và lặp lại như thế nào.

Đầu tiên, chuyển OMP sang chế độ lập kế hoạch (/plan tại thời điểm viết):

/planĐược hỗ trợ bởi

Sau đó nhập lời nhắc sau:

Build a simple Hospital Management System in Python.

Use Streamlit for the web interface and SQLite for storing data. Keep the project lightweight and easy to run locally.

The app should let hospital staff register patients, add doctors, schedule appointments, admit and discharge patients, and view available beds.

Create a dashboard showing total patients, doctors, appointments, admitted patients, and available beds.

Use a clean sidebar for navigation, simple forms and tables, and realistic sample data.

Organize the Python code properly, create the database automatically, add basic validation, and make all CRUD operations work.

Install any required dependencies, run the application, test the main workflows, and fix any errors.Được hỗ trợ bởi

Xem lại kế hoạch

Trước khi viết mã, Grok đã dùng các công cụ tích hợp của OMP để nghiên cứu tài liệu liên quan, kiểm tra thông tin hiện tại về Streamlit và hệ sinh thái Python, xem xét yêu cầu và suy luận cách cấu trúc ứng dụng.

Sau đó, nó đưa ra một kế hoạch triển khai chi tiết được chia theo từng phần. OMP làm cho kế hoạch mang tính tương tác, vì vậy bạn có thể di chuyển giữa các phần, xem xét từng quyết định chi tiết hơn và thay đổi trước khi cho phép tác nhân can thiệp vào dự án.

Khi bạn hài lòng, hãy phê duyệt kế hoạch và để Grok bắt đầu xây dựng.

Để Grok xây dựng và kiểm thử ứng dụng

Sau khi phê duyệt kế hoạch, việc triển khai thực tế diễn ra đáng ngạc nhiên là khá suôn sẻ. Grok tạo cấu trúc dự án, lớp cơ sở dữ liệu, giao diện Streamlit, dữ liệu mẫu và chức năng CRUD, sau đó cài đặt phụ thuộc và kiểm thử ứng dụng.

Phiên bản hoạt động ban đầu mất chưa đến năm phút để xây dựng và kiểm thử.

Đây là lúc một bộ khung mã hoá đúng nghĩa phát huy tác dụng. Grok không chỉ sinh ra một khối mã Python và trả lại cho tôi. Nó có thể tạo tệp, chạy ứng dụng, kiểm tra lỗi, chỉnh sửa và tiếp tục cho đến khi dự án chạy được.

Lặp lại giao diện người dùng

Phiên bản đầu tiên hoạt động, nhưng tôi không thích giao diện mặc định của Streamlit. Nó trông quá giống một ứng dụng Streamlit tiêu chuẩn.

Vì vậy, tôi nói với tác nhân những gì tôi muốn thay đổi, bao gồm chủ đề, bố cục bảng điều khiển, hệ thứ bậc thị giác và cách trình bày thông tin. Grok chỉnh sửa dự án hiện có thay vì xây lại từ đầu.

Kết quả cuối cùng là một Hệ thống Quản lý Bệnh viện được trau chuốt với quản lý bệnh nhân, hồ sơ bác sĩ, lịch hẹn, nhập viện, theo dõi giường và báo cáo.

Quy trình này cũng cho thấy giá trị của các tác nhân mã hoá: bạn có thể bắt đầu với một phiên bản chạy được, xem xét nó và tiếp tục tinh chỉnh thiết kế cùng chức năng chỉ bằng các chỉ dẫn tiếp theo đơn giản.

Lưu ý về chi phí

Có một nhược điểm lớn với thiết lập này: Grok qua API có thể trở nên tốn kém cho mã hoá theo phong cách tác nhân.

Với dự án này, bảng điều khiển sử dụng SpaceXAI hiển thị tổng chi tiêu 11,84 USD, với khoảng 19,4 triệu token được xử lý trên 938 yêu cầu API. Phần lớn mức sử dụng đến từ việc lập kế hoạch, tìm kiếm web, chỉnh sửa tệp, chạy công cụ, kiểm thử ứng dụng và tinh chỉnh giao diện.

Với việc thử nghiệm thỉnh thoảng, tín dụng API vẫn hữu ích vì bạn có thể kiểm soát chính xác số tiền chi. Nhưng nếu bạn mã hoá mỗi ngày hoặc xây dựng dự án lớn hơn, đăng ký SuperGrok có lẽ là lựa chọn tốt hơn, đặc biệt khi quy trình tác nhân tạo ra hàng trăm yêu cầu trong một phiên.

Grok mang lại kết quả xuất sắc, nhưng thử nghiệm này cũng cho thấy với tác nhân mã hoá, chi phí và mức dùng token quan trọng không kém chất lượng mô hình.

Suy nghĩ cuối

Một điều ngày càng rõ với các tác nhân mã hoá là mô hình và bộ khung mã hoá không nhất thiết phải đến từ cùng một công ty. Bộ khung mặc định quanh một mô hình không phải lúc nào cũng là cách dùng tốt nhất, và các nhà phát triển ngày càng kết hợp các mô hình mạnh như Claude hoặc Grok với các tác nhân mã hoá và công cụ dựa trên terminal thay thế phù hợp hơn với quy trình của họ.

Vấn đề là tự xây dựng thiết lập của bạn có thể nhanh chóng trở nên nhàm chán. Bạn bắt đầu cài đặt máy chủ MCP, thêm kỹ năng, cấu hình plugin, kết nối công cụ và tự bảo trì mọi thứ.

Đó là điều tôi thích ở Oh My Pi. Đây là một tác nhân mã hoá “pin kèm sẵn” với hầu hết các khả năng đó được tích hợp. Bạn cài đặt, kết nối nhà cung cấp hoặc đăng ký, chọn mô hình và bắt đầu mã hoá. Bạn không phải tốn hàng giờ lắp ghép tác nhân trước khi có thể thực sự dùng nó.

Grok hoạt động rất tốt với OMP và tạo ra một ứng dụng vững vàng, nhưng chi phí API cao hơn tôi kỳ vọng. Với thử nghiệm thỉnh thoảng, tín dụng API là ổn. Nếu dùng Grok để mã hoá mỗi ngày, cá nhân tôi sẽ xem xét SuperGrok cùng OMP.

Cuối cùng, điều thú vị không chỉ là công ty nào có mô hình mã hoá tốt nhất. Mà là tìm ra tổ hợp mô hình và bộ khung phù hợp nhất với cách bạn thực sự làm việc.