Công cụ lập trình
DeepSeek Harness
Cấu hình model TokenLab trong Harness, xác thực yêu cầu và chọn MCP, Skills hoặc gói provider
Chọn kết nối bạn cần
Để sử dụng TokenLab làm model chính của agent, hãy thêm một custom provider trong Harness Web UI. Việc này hoạt động độc lập với gói provider TokenLab tùy chọn. Hãy thêm MCP tools cho media và các API khác, hoặc một Skill cho các hướng dẫn API; bản thân chúng không thay đổi model chính.
Harness đang ở giai đoạn developer preview. Các bước thực hiện trên Web UI này tuân theo tài liệu chính thức của @deepseek-ai/dsh 0.2.0-rc.2, thẻ latest hiện tại trên npm (được kiểm tra vào ngày 12 tháng 10 năm 2026). Chúng đã được kiểm thử end-to-end lần cuối trên bản 0.1.5-rc.3; các bước kiểm tra yêu cầu bên dưới chưa được chạy lại với bản 0.2.0-rc.2. Gói tùy chọn bên dưới vẫn nhắm mục tiêu đến bản 0.1.5-rc.3; vui lòng kiểm tra tính tương thích với các bản phát hành Harness khác một cách riêng biệt.
Giao tác vụ này cho agent của bạn
Read https://tokenlab.sh/docs/vi/integrations/deepseek-harness and check my installed version and operating system.
Confirm whether I need TokenLab as the main model, MCP tools, or API Skills.
Preserve existing accounts, provider configuration, and permissions; explain how to restore changed settings.
Keep API keys local; do not ask me to paste them into chat. I will enter the key locally and perform required UI steps.
Explain the cost of a small verification request. Only after I explicitly choose that test, help run it and match the TokenLab request record.Khởi động Harness
Sử dụng Node CLI trên macOS, Linux hoặc Windows với bản phát hành Node được hỗ trợ; Node 24 LTS là điểm khởi đầu phù hợp. Từ thư mục dự án của bạn, hãy chạy lệnh này trong terminal hoặc PowerShell:
node --version
npx @deepseek-ai/dsh webNếu không có phiên bản cụ thể, npx sẽ cài đặt thẻ latest của npm, có thể mới hơn bản 0.2.0-rc.2 mà các bước này đã kiểm tra. Nó không cài đặt thẻ alpha.
Mở URL cục bộ được in bởi lệnh. Trong một Web UI mới, hãy sử dụng Choose workspace để thêm và chọn thư mục dự án của bạn trước khi gửi tin nhắn. Các lệnh này sử dụng profile web; profile desktop của ứng dụng Electron không được quản lý bởi quy trình CLI này. Xem hướng dẫn khởi động và hướng dẫn Web UI chính thức.
Cấu hình một provider TokenLab
- Mở Settings → Models, chọn Add model provider, sau đó chuyển thẻ sang Custom model API. (Harness 0.1.5-rc.3 gọi đây là Add a custom provider.) Giữ nguyên mọi provider và quyền hiện có.
- Nhập Provider ID viết thường, ví dụ
tokenlab-chat, và chọn một giao thức cùng Base URL tương ứng bên dưới. Mỗi provider sử dụng một giao thức. - Nhập TokenLab API key của bạn vào biểu mẫu cục bộ. Harness lưu trữ các key do UI quản lý trong
$DSH_HOME/.credentials.yaml; các cài đặt chỉ giữ lại tham chiếu thông tin xác thực của nó. Không gửi key trong chat hoặc commit nó. Provider và giao thức của nó được lưu trong$DSH_HOME/profiles/<profile>/cordis.patch.yml, đối với profiledsh webtiêu chuẩn thì là$DSH_HOME/profiles/web/cordis.patch.yml. - Thêm một model ID hiện tại từ TokenLab Models. Hãy kiểm tra
tokenlab.accepted_request_formatscủa nó trong model detail API, thay vì đoán hỗ trợ từ tên của nó. - Lưu provider, chọn model của nó và bắt đầu một new session. Một session hiện có đã gửi yêu cầu sẽ giữ lại model đã ghi lại của nó.
| Ví dụ Provider ID | Giao thức Harness API | Base URL | Định dạng yêu cầu công khai bắt buộc |
|---|---|---|---|
tokenlab-chat | openai-completions | https://api.tokenlab.sh/v1 | openai_chat_completions |
tokenlab-responses | openai-responses | https://api.tokenlab.sh/v1 | openai_responses |
tokenlab-messages | anthropic-messages | https://api.tokenlab.sh | anthropic_messages |
Đối với yêu cầu văn bản đầu tiên, một mục gpt-5.6-luna hiện có thể sử dụng hàng Chat. Fetch available models → Add selected có thể giúp điền thông tin cho một custom provider, nhưng việc liệt kê thành công không xác minh hỗ trợ giao thức hoặc một yêu cầu tính phí; hãy lưu provider sau đó. Nhập ID thủ công nếu tính năng khám phá không khả dụng.
Harness không cung cấp giao thức custom-provider gốc cho Gemini tại đây. Chỉ sử dụng Chat khi chi tiết của model đó liệt kê Chat Completions là định dạng yêu cầu được chấp nhận. Đầu vào hình ảnh và các điều khiển suy luận có thể cần thêm các trường trong $DSH_HOME/profiles/web/cordis.patch.yml; hãy làm theo cấu hình provider của Harness và các trường được hỗ trợ của model đã chọn trước khi kích hoạt chúng. (Chưa được kiểm tra lại trên bản 0.2.0-rc.2.)
Xác thực một yêu cầu nhỏ
Trong session mới, hãy gửi:
Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.Yêu cầu này sẽ bị tính phí. Kiểm tra phản hồi và model, thời gian, trạng thái khớp trong TokenLab Requests. Dừng lại sau bước kiểm tra văn bản này; việc kiểm tra ba giao thức hoặc tạo media trả phí là không bắt buộc để thiết lập kết nối đầu tiên. Việc liệt kê model hoặc khám phá MCP đơn thuần không xác thực quyền truy cập tạo yêu cầu của key.
Tùy chọn: gói TokenLab
@tokenlabai/dsh-provider@0.1.6 nhắm mục tiêu Harness 0.1.5-rc.3: các peer dependency của nó vẫn là @deepseek-ai/dsh-tools và @deepseek-ai/dsh-mcp-client 0.1.5-rc.3. Nó chưa được kiểm tra với Harness 0.2. Để sử dụng gói này, hãy khởi chạy phiên bản tương ứng: npx @deepseek-ai/dsh@0.1.5-rc.3 web. Sử dụng các bước custom-provider gốc ở trên để cấu hình một model, hoặc cài đặt gói để có các lộ trình model và công cụ được thiết lập sẵn.
Gói này chứa một ảnh chụp nhanh cố định của 145 model chat công khai được kiểm tra vào ngày 3 tháng 10 năm 2026: Responses 28, Messages 11 và Chat 106. Mỗi model xuất hiện trên đúng một lộ trình. Nó ghim @tokenlabai/mcp-server@0.6.25 và bao gồm công cụ tokenlab_wait_task riêng biệt. Việc cài đặt phiên bản này không làm mới danh mục model. Hãy kiểm tra ID so với danh mục trực tiếp và thêm các model mới hơn thông qua custom provider khi cần.
Đối với cài đặt Harness tương thích hiện có, trước tiên hãy đảm bảo pnpm có trong PATH. Sử dụng cùng tệp thực thi/phiên bản dsh và profile để cài đặt và khởi động; nếu bạn khởi chạy qua npx, hãy thay thế dsh bên dưới bằng trình khởi chạy có phiên bản tương tự:
dsh --version
pnpm --version
dsh plugin --profile web add --workspace-root @tokenlabai/dsh-provider@0.1.6Trước khi bắt đầu profile đó, hãy đặt key trong môi trường khởi chạy hoặc tệp .env của nó:
TOKENLAB_API_KEY=sk-your-tokenlab-keyHarness đọc .env trong thư mục nơi bạn khởi chạy nó và trong $DSH_HOME (thường là ~/.dsh); biến môi trường kế thừa sẽ được ưu tiên. Việc chọn workspace sau đó không chọn một .env khác. Hãy giữ tệp đó ngoài git và khởi động lại sau khi thay đổi. Một key được lưu cho custom provider trong UI không tự động cung cấp TOKENLAB_API_KEY cho gói này.
Khởi động lại cùng profile đó, sau đó kiểm tra danh sách model và công cụ của nó. Đối với headless, hãy cài đặt vào và khởi chạy headless thay vì web; việc cài đặt vào một profile không cấu hình profile kia.
Trên Harness 0.1.5-rc.3 (mục tiêu của gói), Harness hợp nhất các llm-pi-ai.providers đã lưu theo khóa provider. Các provider với khóa khác nhau sẽ cùng tồn tại. Các mục tokenlab-responses, tokenlab-messages hoặc tokenlab-chat đã lưu sẽ ghi đè lộ trình đi kèm tương ứng; hãy xem xét các mục đó khi nâng cấp danh mục cũ hơn. Giữ nguyên các provider và model khác trong $DSH_HOME/settings.yaml; không thay thế toàn bộ tài liệu cài đặt bằng bản vá Cordis.
Chi tiết model công khai xác định khả năng suy luận nhưng không liệt kê các giá trị nỗ lực (effort) được hỗ trợ cho mỗi model. Do đó, gói này để reasoningEfforts không được khai báo. Harness không cung cấp các cấp độ nỗ lực cho các lộ trình tùy chỉnh này; điều này không vô hiệu hóa suy luận phía máy chủ. Nếu bạn tự cấu hình reasoningEfforts, chỉ sử dụng các giá trị đã được xác minh riêng biệt trên mục model trong danh sách models của provider đó và giữ nguyên các model khác. Khả năng suy luận đơn thuần không thiết lập hỗ trợ cho xhigh hoặc max.
Gói này mặc định là TOKENLAB_MCP_TOOL_PROFILE=core với 32 công cụ MCP và TOKENLAB_MCP_SCHEMA_MODE=portable. Chọn catalog chỉ để khám phá (6 công cụ), hoặc full cho tất cả 89 công cụ, bao gồm các hoạt động bổ sung về vòng đời phản hồi, batch, tài sản/nhóm Seedance và thế giới. Công cụ thăm dò tokenlab_wait_task riêng biệt vẫn khả dụng trong mọi profile và không được bao gồm trong các số lượng MCP này. TOKENLAB_API_BASE và TOKENLAB_ANTHROPIC_BASE_URL mặc định là https://api.tokenlab.sh; TOKENLAB_OPENAI_BASE_URL mặc định là https://api.tokenlab.sh/v1.
Đối với các công cụ media của gói, hãy kiểm tra delivery.mode: tiêu thụ đầu ra complete trực tiếp; chuyển delivery.task_id của kết quả async cho tokenlab_wait_task và đọc status, response và result_urls cuối cùng của nó. Thời gian chờ (timeout) không phải là một tác vụ đã hoàn thành. Giữ lại các phê duyệt cho các công cụ tính phí hoặc có tính phá hủy. Xem async tasks.
Để xóa gói, hãy sử dụng cùng trình khởi chạy và profile, sau đó khởi động lại:
dsh plugin --profile web remove --workspace-root @tokenlabai/dsh-providerNếu xảy ra lỗi
- Composer bị vô hiệu hóa: chọn cả workspace và model.
MISSING_CREDENTIALhoặc 401: kiểm tra thông tin xác thực của provider đã chọn. Đối với các công cụ của gói, hãy kiểm traTOKENLAB_API_KEYtrong môi trường khởi chạy; key model được lưu trong UI là một cài đặt riêng biệt.UNKNOWN_MODELhoặc ID đã ngừng hoạt động: kiểm tra danh mục trực tiếp, cấu hình ID chính xác hiện tại, sau đó tạo session mới. Việc cài đặt lại gói0.1.6không cập nhật ảnh chụp nhanh của nó.- URL có thể truy cập nhưng việc tạo bị lỗi: so sánh giao thức, Base URL và các định dạng được chấp nhận của model. Không xóa lịch sử, công cụ hoặc đầu vào hình ảnh chỉ để biến lỗi thành một lần kiểm tra thành công.
- Thiếu
dshhoặcpnpm: sử dụngnpx @deepseek-ai/dsh web(hoặc@0.1.5-rc.3cho gói); cài đặt pnpm trước khi sử dụng các lệnh plugin. Lỗi cài đặt plugin không phải là lỗi API-key.
MCP và Skills là các lựa chọn riêng biệt
Một custom provider thủ công không cài đặt các công cụ. Hãy làm theo hướng dẫn TokenLab MCP nếu bạn cần các công cụ API có thể gọi mà không cần gói, và kiểm tra tính năng khám phá trước khi tạo bất kỳ nội dung nào.
Đối với TokenLab Skills, hãy giữ thư mục skill hoàn chỉnh tại .dsh/skills/tokenlab-api-integration/ dưới thư mục gốc của dự án, bao gồm SKILL.md và các tệp được tham chiếu. Harness cũng khám phá .agents/skills/. Các hướng dẫn này không cài đặt provider, MCP server hoặc key. Tài liệu tham khảo filesystem Skills chính thức xác định các vị trí được hỗ trợ.
Jev / System One & Webhooks
Sử dụng mcp__tokenlab__evaluate_decisions trong core hoặc full cho Jev (POST /v1/systemone). Khám phá category=decision và kiểm tra model trước. Đây là các quyết định đồng bộ, không phải model chat hoặc tác vụ bất đồng bộ; không sử dụng bộ chọn model hoặc tokenlab_wait_task.
Quản lý Webhook yêu cầu full và một TOKENLAB_MANAGEMENT_TOKEN=mt-... riêng biệt trong môi trường khởi chạy, được gói truyền rõ ràng cho MCP. Một key suy luận không thể thay thế cho nó. Management token có thẩm quyền cấp workspace ngoài các webhook; việc đăng ký webhook không làm cho Harness trở thành một bộ thu (receiver).