Tutorial Integrasi DeepSeek Harness dengan API Relay: Konfigurasi Provider Model

I. Apa itu DeepSeek Harness

DeepSeek Harness (perintah dsh) adalah kerangka kerja agen sumber terbuka (open-source) dari DeepSeek yang menggunakan arsitektur "segalanya adalah plugin" (everything-is-a-plugin). Kerangka ini memiliki Web UI bawaan dan juga mendukung eksekusi melalui baris perintah (CLI) serta SDK, sehingga memudahkan AI untuk membaca file, mengubah kode, dan menjalankan tugas di ruang kerja Anda.

II. Memulai Web UI

Anda perlu menginstal Node.js terlebih dahulu, kemudian jalankan:

npx @deepseek-ai/dsh web

Perintah ini secara default akan menjalankan Web UI di http://127.0.0.1:3080 dan membuka browser secara otomatis. Jika tidak ingin browser terbuka otomatis, tambahkan --no-open. Untuk menjalankan dari kode sumber:

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

III. Mengarahkan Model ke Gateway Situs Ini

Buka Web UI → Settings → Models → Add a custom provider, lalu isi sebagai berikut:

Provider ID : jizhi
Base URL    : https://www.relay-api.com
API Protocol: OpenAI Compatible（openai-completions）
API Key     : sk-kunci-api-anda
Model       : claude-sonnet-5

(Endpoint OpenAI menggunakan https://www.relay-api.com/v1, endpoint Gemini menggunakan https://www.relay-api.com/v1beta; Anda dapat menambahkan beberapa provider sesuai kebutuhan.)

Anda juga bisa mengonfigurasinya melalui 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

Setelah disimpan, pilih model tersebut di pemilih model untuk memulai percakapan.

IV. Memilih Ruang Kerja dan Menjalankan Tugas

Setelah startup, klik Choose workspace, pilih direktori proyek tempat Anda menjalankan dsh; setelah memilih ruang kerja, Anda dapat membuat sesi baru, misalnya dengan mengirimkan perintah "Ringkas repositori ini dan daftar paket utamanya". Kerangka kerja akan meminta izin Anda saat diperlukan.

V. Pemecahan Masalah Umum

Gejala	Penanganan
401	Kunci tidak valid; periksa API Key, atau isi ulang di halaman Models, atau ekspos variabel lingkungan terkait.
UNKNOWN_MODEL	Model belum dikonfigurasi atau tidak cocok; tambahkan slug yang tepat di daftar model Provider kustom.
Gateway Ditolak	Jika struktur permintaan tidak sepenuhnya konsisten dengan OpenAI, Anda dapat mengatur compat.supportsDeveloperRole: false dan compat.maxTokensField: max_tokens pada rute.

Saran Keamanan: Jangan tulis kunci sk- di repositori publik, disarankan menggunakan variabel lingkungan; tugas agen bisa memakan banyak sumber daya, perhatikan saldo dan penggunaan Anda.

Penjelasan Base URL: Situs ini menerima /v1beta/models/... maupun /v1beta/v1beta/models/... (dan juga /v1/... serta /v1/v1/...), jadi apakah klien menambahkan /v1 atau /v1beta secara otomatis tidak akan memengaruhi pemanggilan: Base URL dapat diisi dengan akar domain atau alamat yang menyertakan /v1beta. Silakan periksa dan salin ID Model di sudut kanan atas halaman "Token" pada konsol.