Panduan agen Flaq AI

Panduan Praktis Menggunakan DeepSeek Harness dengan API Kompatibel OpenAI dari Flaq AI

Jalankan Web UI DeepSeek Harness sumber terbuka dengan endpoint kompatibel OpenAI dari Flaq AI, lalu hubungkan model DeepSeek v4 yang didukung untuk analisis repositori dan alur kerja pemrograman. DeepSeek Harness mengikuti arsitektur “semuanya adalah plugin”: adaptor model, alat, loop agen, penyimpanan sesi, izin, sandboxing, telemetri, dan Web UI dapat disusun atau diganti melalui plugin dan konfigurasi.

Panduan agen

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1DeepSeek Harness/api/v1ZCode/api/v1

Instal

Menjalankan DeepSeek Harness

DeepSeek Harness memerlukan Node.js 22.19+ atau rilis 24+. Jalankan dari direktori proyek yang ingin Anda gunakan sebagai lokasi sistem file default; perintah npm resmi menjalankan Web UI di http://127.0.0.1:3080 secara default.

1

Menjalankan Web UI DeepSeek Harness

Gunakan paket npm resmi untuk menjalankan Web UI. Biarkan terminal ini tetap berjalan selama Anda menggunakan DeepSeek Harness.

Proses pertama kali dijalankan akan mengunduh paket @deepseek-ai/dsh terbaru dan menginisialisasi profil Web UI.

Perintah npm resmi

npx @deepseek-ai/dsh web

Repositori: Tinjau petunjuk instalasi, rilis, catatan kompatibilitas, dan kode sumber terbaru di repositori GitHub resmi DeepSeek Harness.

Konfigurasi

Menghubungkan DeepSeek Harness ke Flaq AI

Buka Settings → Models di DeepSeek Harness, tambahkan Flaq AI sebagai penyedia kustom, lalu masukkan kunci API Flaq Anda. Provider ID bersifat permanen setelah disimpan, jadi gunakan flaq kecuali Anda memang memerlukan nama rute lain. Setelah menyimpan penyedia, pilih ruang kerja sebelum memulai sesi.

Model DeepSeek v4 Pro yang direkomendasikan untuk analisis repositori, tugas pemrograman, dan alur kerja yang mendapat manfaat dari penalaran lebih kuat.

Di Settings → Models, pilih Add provider → Add a custom provider. Masukkan nilai di bawah dan tambahkan ID model yang dipilih secara manual alih-alih menggunakan Fetch available models. Simpan penyedia, lalu pilih model tersebut untuk sesi baru. DeepSeek Harness memperlakukan model yang dimasukkan secara manual sebagai model khusus teks kecuali modalitas tambahan dideklarasikan.

  • Gunakan URL dasar Flaq dan protokol openai-completions yang tepat.
  • Ganti placeholder dengan kunci API Flaq Anda, dan pertahankan ID model persis seperti yang ditampilkan.

Penyedia kustom Flaq AI

Provider ID: flaqDisplay name: Flaq AIBase URL: https://api.flaq.ai/api/v1API protocol: openai-completionsCredential / API key: Your_Flaq_Api_KeyModel ID: deepseek-v4-pro-text-to-text

Verifikasi

Memverifikasi Flaq di DeepSeek Harness

Buka Web UI, pilih direktori proyek tempat Anda menjalankan DeepSeek Harness, pilih model Flaq yang telah dikonfigurasi, lalu buat sesi baru. Kolom penulisan tidak dapat digunakan hingga ruang kerja dipilih.

  • DeepSeek Harness menampilkan URL aktif di terminal.
  • Alamat lokal default ditampilkan di bawah ini.

Membuka Web UI

http://127.0.0.1:3080
  • Kirim tugas hanya-baca terlebih dahulu.
  • Jawaban normal yang mencerminkan ruang kerja terpilih memastikan bahwa DeepSeek Harness dapat menjangkau endpoint Flaq dan menggunakan model yang dikonfigurasi.

Menguji akses repositori

Summarize this repository and identify its main packages. Do not modify any files.

Contoh Plugin

Menginstal Plugin DeepSeek Harness

Gunakan DSH OpenPencil sebagai contoh konkret arsitektur “semuanya adalah plugin” dari DeepSeek Harness. Selesaikan konfigurasi dan verifikasi penyedia Flaq di atas, hentikan Web UI yang sedang berjalan, lalu tambahkan plugin ke profil web dan mulai ulang versi DeepSeek Harness yang sama. DSH OpenPencil menambahkan alat untuk membuat, mempratinjau, memeriksa, dan mengedit dokumen desain .op di dalam percakapan.

1

Menginstal DSH OpenPencil

Tambahkan paket OpenPencil publik ke profil web dengan versi DeepSeek Harness yang saat ini telah diuji oleh plugin. Jalankan perintah ini dari direktori proyek yang sama dengan yang Anda gunakan untuk DeepSeek Harness.

Menginstal DSH OpenPencil

npx --yes -p @deepseek-ai/[email protected] dsh plugin --profile web add @zseven-w/dsh-openpencil@latest

Repositori: Tinjau kode sumber, persyaratan penyiapan, rilis, dan catatan kompatibilitas di repositori GitHub DSH OpenPencil.

2

Memulai ulang Web UI

Jalankan kembali versi DeepSeek Harness yang telah diuji agar profil web memuat DSH OpenPencil. Biarkan terminal ini tetap berjalan saat Anda membuka kembali Web UI.

Memulai ulang Web UI

npx --yes -p @deepseek-ai/[email protected] dsh web
3

Menguji DSH OpenPencil dengan Flaq AI

Pilih model Flaq dan ruang kerja yang telah dikonfigurasi, mulai sesi baru, lalu kirim permintaan di bawah ini. Jika biner OpenPencil tersedia, plugin seharusnya membuat dokumen .op dan menampilkan pratinjau yang dapat diedit di dalam percakapan.

Menguji DSH OpenPencil dengan Flaq AI

Create a simple editable OpenPencil document with a title, a subtitle, and two feature cards. Save it as openpencil-demo.op, then render an editable preview.

Sumber Terbuka

Menjelajahi Repositori Resmi DeepSeek Harness

DeepSeek Harness adalah harness agen sumber terbuka yang dikembangkan oleh DeepSeek AI. Kunjungi repositori resmi untuk meninjau kode sumber, mengikuti rilis dan perubahan kompatibilitas, membaca dokumentasi terbaru, dan melaporkan masalah selama pratinjau developer.

DeepSeek Harness di GitHub

Buka repositori resmi DeepSeek Harness untuk melihat kode sumber, dokumentasi penyiapan, catatan pengembangan, diskusi, dan pembaruan proyek.

Panduan Sumber Terbuka

Menjelajahi Panduan DeepSeek Harness Sumber Terbuka dari Flaq AI

Lanjutkan melampaui penyiapan awal dengan panduan independen DeepSeek Harness dari Flaq AI yang dikelola komunitas. Pelajari bagaimana pohon plugin, profil, bundel, lapisan patch, loop agen yang dapat diganti, adaptor model, alat, layanan sesi, kebijakan izin, sandbox, dan ekstensi Web UI mendukung alur kerja agen kustom.

Panduan DeepSeek Harness di GitHub

Jelajahi catatan arsitektur praktis, buku panduan penggunaan, resep pengembangan plugin, dokumentasi multibahasa, dan keterampilan agen yang dapat digunakan kembali untuk memahami, memperluas, dan membangun di atas DeepSeek Harness.

Pemecahan masalah

FAQ DeepSeek Harness

Menggunakan setup dalam panduan ini dapat meningkatkan penggunaan token secara signifikan.

Diskusi DeepSeek Harness di X (Twitter)

Jelajahi diskusi para developer dan peserta awal mengenai DeepSeek Harness (DSH), sebuah harness agen sumber terbuka, yang mencakup arsitektur “Semuanya adalah Plugin”, runtime yang dapat disusun, ekosistem plugin, dan pengalaman langsung.