DeepSeek Harness: instalasi dan koneksi API

DeepSeek Harness adalah agen coding open source dan agent runtime dari DeepSeek AI. Ia menyediakan loop, tools, akses workspace, sessions, permissions, dan interface di sekitar model. Modelnya tetap berasal dari API Provider. Tutorial ini menjelaskan terlebih dahulu fungsi DeepSeek code harness, lalu menghubungkannya ke OmniaKey melalui alur custom provider resmi.

Apa itu DeepSeek Harness?

DeepSeek Harness, disingkat dsh, bukan model bahasa baru. Ini adalah software yang mengubah model menjadi agent yang dapat memahami workspace, memanggil tools, mengedit file, menjalankan command, menyimpan sessions, dan meminta approval.

Beberapa liputan menyebutnya open-source AI agent framework. Materi resmi lebih spesifik: open-source agent harness, agen coding extensible yang local-first, serta lingkungan pengembangan/runtime untuk agent.

Prinsip utamanya adalah everything is a plugin. Karena dibangun di atas Cordis, models, tools, skills, sessions, sandboxes, storage, loops, scheduling, bahkan UI dapat diganti atau disusun ulang lewat konfigurasi.

Event stream yang dapat ditelusuri lebih dari sekadar chat transcript. Dokumentasi resmi menjelaskan resume, fork, search, dan replay sebagai operasi pada session log yang sama, berguna ketika agent melakukan beberapa tool call sebelum menjawab.

Yang bukan DeepSeek Harness

• Harness bukan DeepSeek V4 Pro atau model lain. Harness dan model adalah lapisan terpisah.
• Ini belum merupakan stable production release. DeepSeek menyebutnya developer preview dan memperingatkan akan ada compatibility-breaking changes.
• Saat dijalankan lewat npm quick start, ini bukan layanan coding hosted. Web UI bind ke local loopback secara default.
• Open source tidak membuat inference gratis. Repository menggunakan MIT license, sementara API ditagih oleh Provider yang Anda atur.

Konfigurasi OmniaKey untuk DeepSeek Harness

Berikut nilai lengkap sebelum langkah rinci:

Suffix /v1 harus ada pada Base URL. Jangan memakai origin saja, jangan menggandakan menjadi /v1/v1, dan jangan memasukkan full request path /chat/completions. Harness menambahkan operation path sendiri.

1. Instal dan jalankan DeepSeek Harness

Instal Node.js, buka terminal pada project directory yang ingin dilihat agent, lalu jalankan npm quick start resmi:

npx @deepseek-ai/dsh web

Perintah saat ini memulai Web UI di:

http://127.0.0.1:3080

Jika 3080 sudah digunakan, pilih port lain:

npx @deepseek-ai/dsh web --port 3081

Directory tempat Anda menjalankan dsh menjadi filesystem location default. Namun composer tidak tersedia sampai Anda menambahkan dan memilih workspace di UI. Pilih repository dengan sengaja; agent dapat menerima file dan shell tools sesuai permission policy aktif.

2. Buat API key OmniaKey khusus

Buka dashboard API Keys OmniaKey dan buat key khusus untuk DeepSeek Harness. Key terpisah lebih mudah dibatasi, dirotasi, dicabut, dan diaudit dibanding credential yang dipakai banyak tool.

Jangan simpan key plaintext di repository, shell history, screenshot, issue, atau chat log. Key yang disimpan lewat Web UI bersifat write-only. DeepSeek mendokumentasikan bahwa secret disimpan di $DSH_HOME/.credentials.yaml, sedangkan settings hanya menyimpan credential reference dan halaman menerima descriptor yang sudah disamarkan.

3. Tambahkan OmniaKey sebagai custom provider

Pada instalasi baru, terima Internal Testing Notice dengan Continue. Dialog onboarding berikutnya meminta DeepSeek API key resmi; pilih Configure later karena OmniaKey harus diletakkan pada custom provider, bukan built-in route tersebut.

Di DeepSeek Harness, buka Settings → Models, pilih Add a custom provider, lalu isi:

1. Provider ID: omniakey, harus dimulai huruf kecil.
2. Display name: OmniaKey.
3. Base URL: https://api.omniakey.com/v1.
4. API protocol: openai-completions.
5. API key: key OmniaKey yang baru dibuat.

Provider ID bersifat permanen karena digunakan oleh sessions, defaults, requests, dan credential references. Display name, Base URL, protocol, credential, dan model list tetap dapat diedit.

4. Ambil dan pilih model

Di bawah Model catalog, pilih Fetch available models. Untuk custom OpenAI-compatible Provider, tool mengirim GET /models dengan Bearer authentication ke Base URL saat ini. Dengan konfigurasi di atas, request akhirnya adalah GET /v1/models milik OmniaKey.

Pilih hanya model yang akan digunakan. Dua ID ini cocok untuk memulai:

Provider yang sama juga dapat memakai Claude, GPT, Gemini, Grok, dan GLM yang saat ini didukung OmniaKey. Salin ID persis dari live model catalog; model name adalah identifier yang tepat, bukan alias samar.

Jika discovery tidak tersedia, tambahkan Model ID yang tepat secara manual. dsh memerlukan setidaknya satu model untuk membuat custom Provider.

5. Pilih workspace dan verifikasi dengan aman

Simpan Provider, pilih project lewat Choose workspace, buat session baru, lalu pilih OmniaKey / deepseek-v4-pro atau OmniaKey / deepseek-v4-flash.

Mulai dengan task read-only yang sempit:

Periksa package.json dan rangkum scripts yang tersedia. Jangan edit file atau menjalankan command.

Test ini memastikan workspace, Provider, key, Model ID, dan response path dasar berfungsi sebelum Anda mengizinkan edit atau shell. Respons teks tidak membuktikan semua pola tool call, jadi uji satu task tool yang reversible sebelum memberi refactor besar.

Model settings berlaku pada request berikutnya tanpa restart server. Namun session yang sudah mengirim request akan mempertahankan model yang dicatat di log. Mulai session baru setelah mengganti Provider atau model agar test tidak ambigu.

Opsional: konfigurasi OmniaKey lewat settings.yaml

Web UI lebih mudah untuk konfigurasi pertama. Pada lingkungan lokal yang terkontrol, $DSH_HOME/settings.yaml dapat berisi Provider profile yang mereferensikan environment variable, bukan menyematkan key:

export OMNIAKEY_API_KEY="your-omniakey-api-key"

llm-pi-ai:
  providers:
    omniakey:
      displayName: OmniaKey
      apiKeyEnv: OMNIAKEY_API_KEY
      api: openai-completions
      baseURL: https://api.omniakey.com/v1
      models:
        - id: deepseek-v4-pro
        - id: deepseek-v4-flash

Key harus ada pada environment proses Harness. Jangan mengganti apiKeyEnv dengan literal secret di settings.yaml. Referensi resmi dsh-llm-pi-ai merekomendasikan credential references agar secret tidak masuk ke settings document.

Mengapa memakai OmniaKey dengan DeepSeek Harness?

DeepSeek Harness sudah mendukung custom gateway; OmniaKey mengubah extension point itu menjadi satu entri Provider yang dapat digunakan ulang.

• Satu konfigurasi untuk beberapa model family. Ganti Model ID persis di picker tanpa membuat profile gateway untuk setiap vendor.
• Model discovery. Harness dapat membaca daftar OpenAI-compatible OmniaKey alih-alih meminta Anda mengetik semua ID dari ingatan.
• Kontrol operasional terpisah. Berikan Harness API key, quota, lifecycle rotasi, dan usage trail sendiri.
• Identitas model yang eksplisit. OmniaKey tidak melakukan silent model substitution: Provider dan model yang diminta adalah yang dijalankan; upstream yang tidak tersedia menghasilkan error terlihat.
• Bayar usage API, bukan subscription agent tambahan. OmniaKey menggunakan saldo prepaid dan billing per token; availability serta rate tetap berada di katalog.

Ini tidak berarti OmniaKey selalu lebih baik daripada key DeepSeek langsung. Jika hanya memerlukan account dan endpoint native DeepSeek, direct Provider masuk akal. OmniaKey berguna ketika satu instalasi Harness perlu memakai beberapa model family pilihan di balik satu key dan Base URL.

Troubleshooting

Fetch available models mengembalikan 401

Pastikan key berasal dari OmniaKey, tidak memiliki spasi, masih aktif, dan dipasangkan tepat dengan https://api.omniakey.com/v1. Model discovery menggunakan Bearer authentication.

Provider mengembalikan 404

Periksa Base URL sebelum mengganti model. Kesalahan umum adalah menghilangkan /v1, menggandakannya, atau memasukkan https://api.omniakey.com/v1/chat/completions sebagai Base URL.

UNKNOWN_MODEL

Model terpilih tidak ada dalam saved list custom Provider. Fetch ulang models atau tambahkan ID persis dari katalog OmniaKey, lalu pilih di session baru.

MISSING_CREDENTIAL

Simpan key melalui Settings → Models atau pastikan OMNIAKEY_API_KEY ada di shell yang menjalankan DeepSeek Harness. Mengatur variable di terminal lain tidak memperbarui proses yang sudah berjalan.

Model yang diganti tampak belum aktif

Mulai session baru. Session lama mempertahankan Provider dan model pada append-only log setelah request pertama.

Teks berfungsi tetapi agent tool gagal

Basic text generation dan structured tool use adalah pemeriksaan berbeda. Mulai dengan read-only tool task, periksa failure tepat di Trajectory view, lalu naikkan limits atau permissions. Tool call yang malformed tidak diperbaiki dengan merotasi API key yang valid.

Pertanyaan umum

Apakah DeepSeek Harness gratis?

Source code menggunakan MIT license. Model inference terpisah dan dapat menimbulkan biaya API melalui DeepSeek, OmniaKey, atau Provider lain.

Bisakah DeepSeek Harness memakai DeepSeek V4 Pro melalui OmniaKey?

Ya. Tambahkan OmniaKey sebagai custom Provider openai-completions dan pilih ID persis deepseek-v4-pro. deepseek-v4-flash juga tersedia sebagai route dengan harga lebih rendah.

Untuk release 0813, rate peak/off-peak resmi, dan contoh biaya token, baca panduan harga API DeepSeek V4 Pro (English). Route Flash yang lebih baru, native vision, benchmark evidence, dan status V4 Pro saat ini dibahas dalam ulasan DeepSeek V4.1 Flash.

Haruskah key OmniaKey ditempel ke kartu DeepSeek built-in?

Gunakan Add a custom provider. Built-in card mengatur route resmi DeepSeek, sedangkan custom-provider form adalah jalur terdokumentasi untuk gateway dan menyediakan Base URL, protocol, serta model list.

Bisakah Provider yang sama memakai Claude, GPT, atau Gemini?

Ya, jika surface OpenAI-compatible OmniaKey saat ini mendukung model tersebut. Fetch live list dan tambahkan ID yang tepat. Fitur protocol dapat berbeda, jadi verifikasi perilaku tool dengan model pilihan.

Di mana API key disimpan?

Key yang disimpan melalui Models page bersifat write-only dan berada di $DSH_HOME/.credentials.yaml; settings menyimpan credential reference. Untuk YAML langsung, gunakan apiKeyEnv dan process environment.

Apakah DeepSeek Harness siap untuk workflow production yang stabil?

Saat ini perlakukan sebagai evaluation target. DeepSeek secara eksplisit menyebutnya developer preview dan memperingatkan compatibility-breaking changes. Pin version, backup konfigurasi tanpa secret, dan periksa ulang panduan resmi setelah upgrade.

Sumber yang diperiksa

• DeepSeek Harness product page
• DeepSeek Harness GitHub README
• Official Web UI quick start
• Official model and custom-provider guide
• Official dsh-llm-pi-ai provider reference
• OmniaKey OpenAI-compatible API reference (English)
• OmniaKey live model catalog