Cài đặt DeepSeek Harness API

DeepSeek Harness (dsh) có thể thêm TokenHub làm nhà cung cấp tùy chỉnh từ trang Mô hình của nó. Mỗi nhà cung cấp phải khai báo một giao thức thực sự được cung cấp bởi cổng. Đối với TokenHub OpenAI Chat Completions, hãy sử dụng openai-completions với https://us-api.tokenhub.com/v1.

DeepSeek Harness vẫn ở dạng bản xem trước dành cho nhà phát triển và những người bảo trì nó cảnh báo rằng các bản phát hành có thể chứa những thay đổi có thể vi phạm. Xác thực kết nối bằng tác vụ có rủi ro thấp trước khi sử dụng kho lưu trữ thực.

Khi sự tích hợp này phù hợp

DeepSeek Harness dành cho quy trình phát triển kết hợp mô hình, công cụ và không gian làm việc thành một tác nhân. Nó vẫn tồn tại các nhà cung cấp, mô hình và cài đặt phiên. Chọn ID nhà cung cấp ổn định trước khi tạo để sau này bạn không phải di chuyển các tham chiếu phiên và mô hình mặc định.

Bắt đầu DeepSeek Harness

Sử dụng lệnh chính thức để khởi động giao diện người dùng Web cục bộ của nó:

npx @deepseek-ai/dsh web

Thao tác này sẽ khởi động giao diện người dùng cục bộ và cố gắng mở nó trong trình duyệt. Khi chạy trên SSH hoặc trong môi trường từ xa, hãy làm theo hướng dẫn Giao diện người dùng web của dự án để biết địa chỉ truy cập. Xác nhận giao diện người dùng có thể truy cập được trước khi định cấu hình nhà cung cấp.

Chuẩn bị thông tin xác thực và mô hình TokenHub

Tạo khóa API trong bảng điều khiển TokenHub và sao chép ID mẫu chính xác từ danh mục mẫu. Không bao giờ cam kết khóa vào kho lưu trữ hoặc chia sẻ nó.

Thêm nhà cung cấp tùy chỉnh TokenHub

1. Mở Settings → Models.
2. Chọn Add a custom provider. Không định cấu hình TokenHub làm một trong những nhà cung cấp tích hợp.
3. Nhập ID nhà cung cấp chữ thường, tên hiển thị, giao thức Base URL, API và khóa API.
4. Thêm ít nhất một ID mẫu TokenHub chính xác vào danh sách mẫu và lưu.
5. Quay lại bộ chọn mô hình, chọn nhà cung cấp và mô hình bạn đã lưu rồi tạo phiên mới để xác minh.

Một nhà cung cấp chỉ có thể sử dụng một giao thức. Nếu một cổng hiển thị OpenAI Chat Completions, Phản hồi và Anthropic Messages, hãy tạo một nhà cung cấp riêng cho từng giao thức thay vì trộn lẫn chúng.

Phiên đã lưu, mô hình mặc định và thông tin xác thực tham chiếu ID nhà cung cấp. Để đổi tên nó, hãy tạo nhà cung cấp mới, chọn mô hình mặc định mới, sau đó di chuyển cài đặt cũ nếu cần.

Thêm mô hình theo cách thủ công khi khám phá không thành công

Model catalog có thể sử dụng Fetch available models để truy xuất danh sách mẫu. Điều này phụ thuộc vào phản hồi của mô hình danh sách tương thích và là sự tiện lợi chứ không phải là điều kiện tiên quyết.

Nếu tìm nạp không thành công hoặc trả về danh sách trống:

1. Giữ đúng Base URL, giao thức và khóa API.
2. Nhập ID mẫu hoàn chỉnh từ TokenHub theo cách thủ công.
3. Lưu nhà cung cấp và gửi yêu cầu đơn giản từ một phiên mới.
4. Xác nhận kiểu máy, trạng thái và mức sử dụng trong nhật ký yêu cầu TokenHub.

Chỉ riêng việc khám phá thất bại không có nghĩa là mô hình không có sẵn.

Cấu hình nâng cao trong settings.yaml

Trang Mô hình bao gồm các trường định tuyến: khóa API, tên hiển thị, URL cơ sở, giao thức và ID mẫu. Định cấu hình đầu vào hình ảnh, nỗ lực suy luận, ghi đè tương thích, tiêu đề yêu cầu, thời gian chờ và chính sách thử lại trong $DSH_HOME/settings.yaml.

Ví dụ: chỉ khai báo đầu vào hình ảnh khi mô hình chính xác hỗ trợ nó:

llm-pi-ai:
  providers:
    tokenhub:
      apiKeyEnv: TOKENHUB_API_KEY
      api: openai-completions
      baseURL: __API_BASE_URL__/v1
      models:
        - id: YOUR_TOKENHUB_MODEL_ID
          input: [text, image]

Hướng dẫn chính thức cho biết bộ điều hợp đọc các thay đổi settings.yaml đã lưu trong yêu cầu tiếp theo, thông thường không cần khởi động lại. Không thêm các phần ghi đè như supportsDeveloperRole hoặc maxTokensField mang tính suy đoán; chỉ sử dụng chúng khi cổng yêu cầu hoặc từ chối yêu cầu mặc định.

Xác minh rằng các yêu cầu đạt tới TokenHub

1. Xác nhận nhà cung cấp và mô hình đã được lưu trên trang Mô hình.
2. Tạo một phiên mới và chọn mô hình TokenHub.
3. Chạy một tác vụ có độ rủi ro thấp, chẳng hạn như giải thích một tệp hoặc tóm tắt một khối mã ngắn.
4. Xác nhận ID mẫu chính xác, trạng thái phản hồi và mức sử dụng trong nhật ký TokenHub.
5. Sau đó kiểm tra các công cụ, tác vụ dài và khả năng nhập hình ảnh lần lượt.

Phiên hiện tại sẽ giữ mô hình được ghi lại trong nhật ký phiên của nó. Sau khi thay đổi mặc định, hãy xác minh bằng phiên mới.

Khắc phục sự cố

Tài liệu tham khảo chính thức

• Dự án DeepSeek Harness
• Hướng dẫn nhà cung cấp DeepSeek Harness
• Danh mục cấu hình DeepSeek Harness