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

发布时间2026年8月30日 13: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 và trỏ đến Gateway của chúng tôi để sử dụng các mô hình 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, áp dụng kiến trúc "mọi thứ là plugin" (everything-is-a-plugin). Nó tích hợp sẵn Web UI và cũng hỗ trợ chạy thông qua dòng lệnh (CLI) hoặc 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 đó chạy lệnh:

npx @deepseek-ai/dsh web

Lệnh này mặc định sẽ 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

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

Provider ID : jizhi
Base URL    : https://www.relay-api.com
API Protocol: OpenAI Compatible（openai-completions）
API Key     : sk-mã_của_bạn
Model       : claude-sonnet-5

(Endpoint OpenAI sử dụng https://www.relay-api.com/v1, endpoint 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.)

Cũng có thể cấu hình trong 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, chọn mô hình này trong bộ 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 động, nhấp vào Choose workspace, chọn thư mục dự án nơi bạn đã khởi chạy dsh; sau khi chọn 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. Khắc phục sự cố thường gặp

Hiện tượng	Xử lý
401	Khóa không hợp lệ; kiểm tra API Key, hoặc nhập lại trên trang Models, hoặc khai báo 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` trong route.

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

Giải thích về Base URL: Trang web của chúng tôi chấp nhận cả /v1beta/models/... và /v1beta/v1beta/models/... (cũng như /v1/... và /v1/v1/...), vì vậy việc client có tự bổ sung /v1 hay /v1beta hay không đều không ảnh hưởng đến lệnh gọi: Bạn có thể điền Base URL là tên miền gốc hoặc địa chỉ có kèm /v1beta đều dùng được. Vui lòng tra cứu và sao chép ID mô hình trong mục "ID mô hình" ở góc trên bên phải trang "Token" trong bảng điều khiển.