Penyiapan Alat AI

DeepSeek Harness

Hubungkan DeepSeek Harness ke Felo melalui adaptor DeepSeek bawaan atau penyedia yang kompatibel dengan OpenAI khusus.

Gunakan panduan ini untuk menjalankan DeepSeek Harness sumber terbuka dengan model yang dilayani oleh Felo API Platform. Jalur yang disarankan menggunakan kembali adapter bawaan deepseek-official milik harness. Anda juga dapat menambahkan Felo sebagai penyedia terpisah yang kompatibel dengan OpenAI di Web UI.

DeepSeek Harness saat ini masih dalam tahap developer preview dan dapat menghadirkan perubahan yang merusak kompatibilitas. Periksa catatan rilis upstream saat opsi atau layar berbeda dari panduan ini.

Sebelum Anda Memulai

Anda memerlukan Node.js dan satu kunci Felo API Platform. Jauhkan kunci dari kontrol sumber.

export FELO_API_KEY="YOUR_API_KEY"

Contoh menggunakan deepseek-v4-flash. Periksa Model dan Harga sebelum memilih ID model lain.

Penyiapan yang Disarankan: Adapter DeepSeek Bawaan

DeepSeek Harness membaca kredensial adapter bawaan dari DEEPSEEK_API_KEY dan endpoint-nya dari DEEPSEEK_BASE_URL.

export DEEPSEEK_API_KEY="$FELO_API_KEY"
export DEEPSEEK_BASE_URL="https://openapi.felo.ai/api/v1"
npx @deepseek-ai/dsh web

Buka http://127.0.0.1:3080, lalu:

Tambahkan atau pilih ruang kerja proyek Anda.
Buka Settings → Models.
Pilih penyedia deepseek-official dan model deepseek-v4-flash.
Mulai sesi baru dan kirim tugas repositori kecil.

Jangan menambahkan /chat/completions ke Base URL. Adapter bawaan mengirim permintaan ke {DEEPSEEK_BASE_URL}/chat/completions sendiri.

Menyimpan nilai lingkungan secara permanen

DeepSeek Harness dapat membaca file .env dari direktori tempat Anda menjalankannya. Tambahkan nilai berikut ke file .env yang tidak dilacak jika Anda tidak ingin mengekspornya untuk setiap sesi:

DEEPSEEK_API_KEY=YOUR_API_KEY
DEEPSEEK_BASE_URL=https://openapi.felo.ai/api/v1

Jangan melakukan commit pada file ini. Anda juga dapat menggunakan file kredensial dan pengaturan harness di bawah $DSH_HOME saat memerlukan konfigurasi tingkat pengguna.

Penyiapan Alternatif: Penyedia Kustom yang Kompatibel dengan OpenAI

Gunakan jalur ini jika Anda ingin Felo muncul sebagai penyedia terpisah alih-alih menimpa koneksi DeepSeek bawaan.

Mulai Web UI dengan npx @deepseek-ai/dsh web.
Buka Settings → Models.
Pilih Add custom provider.
Masukkan nilai berikut dan simpan penyedia.

Field	Nilai
ID penyedia	`felo`
Nama tampilan	`Felo API Platform`
Base URL	`https://openapi.felo.ai/api/v1`
Protokol API	Chat Completions yang kompatibel dengan OpenAI (`openai-completions`)
Kunci API	Kunci API Felo Anda
ID model	`deepseek-v4-flash`

Jika penemuan model gagal, tambahkan ID model secara manual. Tindakan Get available models milik penyedia bergantung pada rute GET /models yang kompatibel dengan OpenAI dan tidak diperlukan untuk konfigurasi manual.

Memverifikasi Penyiapan

Mulai sesi baru dan tanyakan:

Summarize this repository and identify its main packages.

Penyiapan siap ketika sesi selesai dengan deepseek-v4-flash dipilih dan tidak muncul error autentikasi atau model tidak dikenal.

Untuk uji cepat noninteraktif dengan adapter yang disarankan, jalankan dari ruang kerja target:

npx @deepseek-ai/dsh --profile headless "List the top-level files in this workspace."

Catatan Pencarian Web

Penyiapan ini merutekan permintaan model melalui Felo. Penyedia web_search bawaan DeepSeek Harness memiliki persyaratan endpoint tersendiri meskipun variabel kredensial bawaannya juga DEEPSEEK_API_KEY. Jangan arahkan DEEPSEEK_SEARCH_BASE_URL ke Felo kecuali Anda menggunakan endpoint pencarian yang secara eksplisit kompatibel. Gunakan Chat API Felo atau Felo Skills lain secara terpisah saat alur kerja Anda memerlukan pencarian Felo.

Pemecahan Masalah

Masalah	Yang perlu diperiksa
`MISSING_CREDENTIAL` atau 401	Pastikan `DEEPSEEK_API_KEY` berisi kunci Felo di proses yang menjalankan `dsh`
URL permintaan berisi jalur dua kali	Gunakan `https://openapi.felo.ai/api/v1`, bukan URL yang berakhiran `/chat/completions`
`UNKNOWN_MODEL`	Pilih atau tambahkan `deepseek-v4-flash` secara manual, atau gunakan ID model Felo lain yang dipublikasikan
Felo tidak tercantum secara terpisah	Gunakan penyiapan penyedia kustom; jalur yang disarankan mempertahankan ID penyedia `deepseek-official`
Pengaturan diubah tetapi sesi lama berperilaku berbeda	Mulai sesi baru agar sesi tersebut menggunakan penyedia dan rute model yang baru dipilih
Autentikasi pencarian web gagal	Konfigurasikan penyedia pencarian harness secara terpisah; pengaturan endpoint model tidak mengonfigurasi pencarian web