Hướng dẫn tác nhân Flaq AI

Hướng dẫn thực tế về cách sử dụng ZCode với các dịch vụ API của Flaq AI

Kết nối môi trường lập trình AI trên máy tính ZCode với API tương thích OpenAI của Flaq AI, sau đó sử dụng các mô hình GLM 5.2, Kimi K3 hoặc DeepSeek v4 cho các câu hỏi về kho mã và quy trình lập trình. Hướng dẫn này trình bày cách tải ZCode chính thức, thiết lập nhà cung cấp tùy chỉnh, chọn mô hình và thực hiện một phép thử workspace đơn giản.

Hướng dẫn tác nhân

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1DeepSeek Harness/api/v1ZCode/api/v1

Cài đặt

Cài đặt ZCode

Tải ứng dụng ZCode chính thức dành cho máy tính chạy macOS, Windows hoặc Linux, cài đặt theo quy trình tiêu chuẩn của hệ thống và chọn thư mục dự án trong lần khởi chạy đầu tiên. Hiện tại, ZCode cung cấp AppImage cho Linux x64 cùng với các bản tải xuống dành cho macOS và Windows.

1

Tải ZCode

Mở trang cài đặt chính thức và chọn gói phù hợp với hệ điều hành cũng như kiến trúc thiết bị của bạn.

Chọn tệp .dmg dành cho Apple Silicon hoặc Intel, kéo ZCode vào Applications, rồi mở ứng dụng từ Launchpad.

Tải ZCode cho macOS

https://zcode.z.ai/en/docs/install

Cấu hình

Kết nối ZCode với Flaq AI

Mở phần cài đặt mô hình của ZCode, thêm Flaq AI làm nhà cung cấp bên thứ ba bằng giao thức OpenAI, nhập khóa API Flaq của bạn và thêm thủ công ID mô hình đã chọn. ZCode có thể sử dụng các dịch vụ mô hình tương thích thông qua nhà cung cấp tùy chỉnh ngay cả khi chúng không có trong danh sách nhà cung cấp tích hợp sẵn.

Lựa chọn mặc định được đề xuất cho quy trình lập trình bằng ZCode, tác vụ kho mã nhiều bước, lập kế hoạch và phân tích mã.

Nhấp vào tên mô hình trong hộp trò chuyện ZCode, chọn Manage Models và mở Settings → Model Settings. Nhấp vào Add Provider, chọn giao thức OpenAI, nhập các thiết lập Flaq bên dưới và bật nhà cung cấp. Nếu danh sách mô hình không tự động tải, hãy nhấp vào Add Model và nhập thủ công ID mô hình đã chọn.

  • Sử dụng chính xác URL cơ sở của API Flaq và thay thế phần giữ chỗ bằng khóa API Flaq của bạn.
  • Giữ nguyên ID mô hình đã chọn đúng như hiển thị.

Thiết lập nhà cung cấp Flaq AI

Provider name: Flaq AIProtocol: OpenAIAPI base URL: https://api.flaq.ai/api/v1API key: Your_Flaq_Api_KeyModel ID: glm-5.2-text-to-textEnable provider: On

Xác minh

Xác minh Flaq trong ZCode

Chọn mô hình Flaq đã cấu hình từ bộ chọn mô hình, mở một thư mục dự án làm workspace hiện tại, bắt đầu phiên ZCode Agent mới và trước tiên hãy gửi một tác vụ kho mã chỉ đọc.

Sử dụng prompt này để kiểm tra rằng mô hình đã chọn phản hồi bằng thông tin từ workspace hiện tại mà không yêu cầu thay đổi tệp.

Kiểm tra quyền truy cập dự án

List the files in this project and summarize its main purpose. Do not modify any files.

Trang web chính thức

Truy cập trang web ZCode chính thức

Truy cập trang web ZCode chính thức để xem các bản tải xuống mới nhất cho máy tính, hướng dẫn cài đặt, tài liệu cấu hình mô hình, ghi chú phát hành và thông tin cập nhật sản phẩm.

Trang web ZCode chính thức

Mở trang web ZCode chính thức để tải ứng dụng và xem quy trình thiết lập mới nhất dành cho macOS, Windows và Linux.

Khắc phục sự cố

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

Việc sử dụng thiết lập trong hướng dẫn này có thể làm tăng đáng kể lượng token sử dụng.