Hướng dẫn kết nối DeepSeek Harness với API trung gian: Cấu hình Provider mô hình

发布时间2026年8月30日 21:34
栏目guide
语言vi

Hướng dẫn kết nối khung tác nhân DeepSeek Harness (dsh): Khởi chạy Web UI, thêm Provider tùy chỉnh trong trang Models để trỏ đến Gateway và sử dụng các mô hình ngôn ngữ lớn.

I. DeepSeek Harness là gì

DeepSeek Harness (lệnh dsh) là khung tác nhân (agent framework) mã nguồn mở của DeepSeek, sử dụng kiến trúc "mọi thứ là plugin" (everything-is-a-plugin). Nó tích hợp sẵn Web UI, đồng thời hỗ trợ vận hành qua dòng lệnh và SDK, rất phù hợp để AI đọc tệp, sửa mã nguồn và thực thi các tác vụ trong không gian làm việc của bạn.

II. Khởi chạy Web UI

Bạn cần cài đặt Node.js trước, sau đó thực thi:

npx @deepseek-ai/dsh web

Lệnh này sẽ mặc định khởi chạy Web UI tại http://127.0.0.1:3080 và tự động mở trình duyệt. Nếu không muốn tự động mở, bạn có thể thêm --no-open. Để chạy từ mã nguồn, thực hiện:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install && pnpm run build
pnpm dsh web

III. Trỏ mô hình đến Gateway của trang web này

Mở Web UI → Settings → Models → Add a custom provider, điền các thông tin sau:

Provider ID : jizhi
Base URL    : https://www.relay-api.com
Giao thức API : OpenAI Compatible (openai-completions)
API Key     : sk-khóa_của_bạn
Mô hình     : claude-sonnet-5

(Điểm cuối OpenAI sử dụng https://www.relay-api.com/v1, điểm cuối Gemini sử dụng https://www.relay-api.com/v1beta, bạn có thể thêm nhiều Provider tùy theo nhu cầu.)

Bạn cũng có thể cấu hình trong tệp settings.yaml

llm-pi-ai:
  providers:
    jizhi:
      apiKeyEnv: JIZHI_API_KEY
      api: openai-completions
      baseURL: "https://www.relay-api.com"
      models:
        - id: claude-sonnet-5

Sau khi lưu, hãy chọn mô hình này trong trình chọn mô hình để bắt đầu phiên làm việc.

IV. Chọn không gian làm việc và chạy tác vụ

Sau khi khởi chạy, nhấn Choose workspace, chọn thư mục dự án nơi bạn đã chạy dsh; sau khi chọn xong không gian làm việc, bạn có thể tạo phiên mới, ví dụ: gửi yêu cầu "Tóm tắt kho lưu trữ này và liệt kê các gói chính". Khung sẽ yêu cầu sự đồng ý của bạn khi cần cấp quyền.

V. Xử lý sự cố thường gặp

Hiện tượng	Cách xử lý
401	Khóa không hợp lệ; kiểm tra lại API Key, hoặc nhập lại trong trang Models, hoặc cấu hình biến môi trường tương ứng.
UNKNOWN_MODEL	Mô hình chưa được cấu hình hoặc không khớp; hãy thêm chính xác slug vào danh sách mô hình của Provider tùy chỉnh.
Gateway từ chối	Khi cấu trúc yêu cầu không hoàn toàn khớp với OpenAI, bạn có thể cấu hình `compat.supportsDeveloperRole: false` và `compat.maxTokensField: max_tokens` tại mục route.

Khuyến nghị bảo mật: Không viết khóa sk- vào kho lưu trữ công khai, khuyến khích sử dụng biến môi trường để tham chiếu; các tác vụ của tác nhân có thể tiêu tốn tài nguyên, hãy chú ý đến số dư và mức sử dụng.