Tutorial Integrasi API Relay untuk DeepSeek Harness: Konfigurasi Provider Model

1. Apa itu DeepSeek Harness

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

2. Menjalankan Web UI

Anda perlu menginstal Node.js terlebih dahulu, lalu 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. Jika 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

3. 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

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

Konfigurasi juga dapat dilakukan di 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 menyimpan, pilih model tersebut di pemilih model untuk memulai sesi.

4. Memilih Ruang Kerja dan Menjalankan Tugas

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

5. Pemecahan Masalah Umum

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

Saran Keamanan: Jangan tulis kunci sk- di repositori publik, disarankan untuk mereferensikannya melalui variabel lingkungan; karena tugas agen bisa sangat besar, perhatikan saldo dan penggunaan Anda.