Bloga dön

Ajanlar ve otomasyonKılavuz

dsh-superagent'ı ucuz bir modelde çalıştırın: GitHub issue'sundan PR'a

DeepSeek'in dsh-superagent'ını, agent hesabından bahseden bir issue'nun pull request'e dönüşeceği şekilde ayarlayın ve bir ticket'ın token cinsinden maliyetini tahmin edin.

Yazan: CheapTokens TeamYayınlanma tarihi: 5 dk okuma

DeepSeek Harness ve dsh-superagent işaretlerinin yanında dsh-superagent başlatmayı gösteren terminal
Bu sayfada
  1. Gerçekte ne yapıyor
  2. Başlamadan önce
  3. Kurulum ve başlatma
  4. Agent'a kendi GitHub hesabını verin
  5. İlk test issue'nuz
  6. Bir ticket'ın maliyeti
  7. Kısa tasma üzerinde tutun
  8. Kaynaklar

Yeni bir GitHub issue'sunda bir agent'tan bahsedin, gidip çay yapın ve bir pull request ile geri dönün. DeepSeek'in dsh-superagent aracının yaptığı tam olarak budur ve bunu DeepSeek Harness (DSH) üzerinden bir CheapTokens modeliyle çalıştırabilirsiniz. Aşağıda: kurulum, agent'ın kendi GitHub hesabı, ilk test issue'su ve tek bir ticket için bütçe.

Deponun kendisinden bir uyarı. README'si (2 Kasım 2026'da kontrol edildi) bunu yalnızca referans amaçlı bir araştırma prototipi olarak adlandırıyor, resmi bir DeepSeek ürünü olmadığını söylüyor ve hâlâ hata içerebileceğini belirtiyor. MIT lisanslı, main üzerinde tek bir commit'i var ve hiç sürümü yok. Denemeyi göze alabileceğiniz bir depoda çalıştırın.

Gerçekte ne yapıyor#

dsh-superagent, tek bir GitHub deposu için proaktif bir kodlama agent'ıdır ve DeepSeek Harness için bir paket olarak sunulur. GitHub'ı dinler. İzin listenizdeki biri sorduğunda, bir iş öğesi açar (dokümanlar buna Ticket diyor), kendi agent oturumunda ve kendi dizininde çalışır ve orijinal konuşmada yanıt verir, örneğin bir pull request ile. Bir web paneli, bir insana ihtiyaç duyan öğeleri gösterir.

Yani bir issue bir oturumdur ve bir oturum da model çağrılarından oluşan bir döngüdür. Token'lar bu döngüde harcanır; nedenini görmediyseniz, AI agent'ları neden bu kadar çok token kullanır 20 adımlık bir örneği ele alıyor.

Issue'dan pull request'e: agent hesabından bahsedilir, bir Ticket açılır, bir oturum çalışır, bir PR geri döner
dsh-superagent içinde bir ticket'ın yolu

Başlamadan önce#

Dağıtım dokümanına göre şunlara ihtiyacınız var:

  • Node.js 22.19+ veya 24+, pnpm, git 2.32+, tmux, Python 3.8+
  • GitHub CLI 2.48+ (küçük bir sarmalayıcı üzerinden kullanılır, aşağıya bakın)
  • github.com üzerinde bir depo (GitHub Enterprise Server desteklenmez)
  • deponun package.json dosyasındaki engines.dsh aralığındaki sürümde DSH
  • bir DSH model sağlayıcısı

Son madde, deponun size bıraktığı maddedir: kurulum kılavuzu sağlayıcıyı bir operatör adımı olarak adlandırıyor. CheapTokens için önce DeepSeek Harness'ı CheapTokens'a bağlayın ve geri dönün. Kullanılacak model kimliği deepseek-ai/DeepSeek-V4-Flash-0731 (tam kimlik, fiyat tablolarındaki kısa ad API tarafından kabul edilmez) ve API tabanı https://api.cheaptokens.dev/v1. Ayrıntılar CheapTokens doküman sayfasında.

Dikkat edilmesi gereken bir şey. Dağıtım dokümanına göre kurulum, adlarında KEY, PASSWORD, SECRET veya TOKEN içeren ortam değişkenlerini temizler ve worker ortamından GH_TOKEN ve GITHUB_TOKEN değişkenlerini kaldırır. Yani shell'de dışa aktarılan bir sağlayıcı anahtarı worker'a ulaşmaz; bağlantı makalesinde anlatıldığı gibi ayarlayın.

Kurulum ve başlatma#

Adım adım

Paketi kurun

DSH'yi ve depoyu kurun

Doküman (docs/006-deployment.md, 2 Kasım 2026'da kontrol edildi) bir sürüm adayını sabitliyor:

bash
npm install -g @deepseek-ai/dsh@0.2.1-rc.3
git clone https://github.com/deepseek-ai/dsh-superagent-prototype dsh-superagent
cd dsh-superagent
pnpm install && pnpm build

Profili oluşturun (yalnızca temiz kurulumda)

bash
dsh superagent --from-default-profile web --dump-config > /dev/null
dsh plugin --profile superagent add "link:$PWD"

İlk satırı yalnızca bir kez çalıştırın. Mevcut bir superagent profilinde profili değiştirir ve cordis.patch.yml dizinini siler.

Yapılandırmayı ekleyin

examples/profile.cordis.patch.yml dosyasını ~/.dsh/profiles/superagent/cordis.patch.yml konumuna kopyalayın. Tek zorunlu anahtar stateDir, veritabanının, kilitlerin ve worker dosyalarının bulunduğu mutlak yoldur. webserver girdisi portu ayarlar (varsayılan olarak 3082).

Başlatın

bash
scripts/dsh-superagent start
scripts/dsh-superagent status

start, dsh-superagent adlı bir tmux oturumu içinde çalışır.

Bir terminalde dsh-superagent için kurulum ve başlatma komutları
Önemli olan dört komut, docs/006-deployment.md'den

Durum komutu bir çıkış koduyla yanıt verir: 0 normaldir, 1 yeniden başlatmanın yardımcı olabileceği anlamına gelir, 2 bir parçanın başarısız olduğu ve yeniden başlatmanın bunu düzeltmeyeceği anlamına gelir, 3 hâlâ kurulum gerektiği anlamına gelir. Varsayılanlarla başlayın: profil superagent, dal öneki agent/ ve kabul modu observe, bu mod proaktif işi yapmadan kaydeder.

Agent'a kendi GitHub hesabını verin#

İnsanların atladığı ve sonra neden hiçbir şeyin olmadığını merak ettiği adım budur. Agent'ın deponuza yazma erişimi olan normal bir GitHub kullanıcısına ihtiyacı vardır; bir GitHub App bu rolü üstlenemez.

  1. Kullanıcıyı oluşturun ve yazma erişimiyle işbirlikçi olarak ekleyin.
  2. Bir ~/.local/bin/gh-agent sarmalayıcısı yapın: GH_CONFIG_DIR="$HOME/.config/gh-agent" exec gh "$@". Bu, agent'ın oturum açmasını kendi gh oturumunuzdan ayrı tutar.
  3. gh-agent auth login komutunu o kullanıcı olarak çalıştırın.
  4. Web panelinde Sources'u açın, depoyu (owner/name) ve CLI yolunu sarmalayıcıya ayarlayın.
  5. Policy altında, agent'a iş verebilecek oturum açma adlarını policy.sources.github.allowed listesine ekleyin. Birisi bu listede olana kadar hiçbir şey Ticket olmaz.

Kontrol listesi

İlk issue'dan önce

İlk test issue'nuz#

Depoda yeni bir issue açın ve küçük ve net bir şey yazın, agent'ın oturum açma adını kod biçiminde ekleyin, örneğin: @<agent login> fix the typo in README.md: "recieve" should be "receive".

"Yeni" kelimesi önemlidir. Bahsetmeyi eklemek için eski bir issue'yu düzenlemek algılanmaz; yeni bir issue veya yeni bir yorum algılanır. Panel bir Ticket gösterirse ve ardından agent/ ile başlayan bir dal belirirse, zincir çalışıyor demektir.

Kendin deneDeneyin: bahsetmenizden sonra hiçbir şey olmuyor. İlk olarak neyi kontrol edersiniz?Cevabı göster

İzin listesini. Oturum açma adınız policy.sources.github.allowed içinde olana kadar hiçbir şey Ticket olmaz. Bundan sonra, bahsetmenin düzenlenmiş bir issue veya yorumda değil, yeni bir issue veya yorumda olduğunu kontrol edin.

Bir ticket'ın maliyeti#

Depo, ticket başına token kullanımını yayımlamıyor, bu yüzden bu, belirtilen varsayımlara dayanan bir tahmindir. Küçük bir ticket'ın 25 model çağrısı aldığını varsayalım. Her çağrı büyüyen konuşmayı taşır: ortalama yaklaşık 30.000 token girdi ve yaklaşık 800 token yanıt (bir komut, bir yama, kısa bir not).

Ticket başına bu, 30.000 × 25 = 750.000 girdi token'ı ve 800 × 25 = 20.000 çıktı token'ıdır. Bugünkü CheapTokens fiyatlarıyla DeepSeek-V4-Flash üzerinde (1M token başına girdi $0.015 ve çıktı $0.10), böyle bir ticket $0.0133.

Dengesiz kısım: girdi, çıktının yaklaşık 37 katıdır ve bu agent'lar için normaldir, çünkü her adım öncekini yeniden gönderir. Aynı ticket diğer modellerde:

Model Maliyet OpenRouter
GLM-5.3-Flash $0.0158 $0.0268
DeepSeek-V4-Flash $0.0133 $0.0553
MiniMax-M2.7 $0.0405 $0.486

Toplamda 750.000 giriş ve 20.000 çıkış token'ı. 1M token başına fiyatlar günceldir ve tarifelerimizle birlikte değişir; OpenRouter sütunu aynı iş yükü için referans fiyatları gösterir.

Tablo ayrıca, ticket'larınız kısa ve yanıtlar küçükse GLM-5.3-Flash'i (390K bağlam, yanıt başına 8.192 token'a kadar) listeliyor. Uzun araç döngüleri için DeepSeek-V4-Flash size 380K bağlam, yanıt başına 32.768 token'a kadar ve her saatte tek fiyat sunar. Kendi sayılarınız farklı olacaktır, bu yüzden kaydırıcıları hareket ettirin:

Maliyet hesaplayıcı

Beş ticket'lı bir gün (her biri 25 çağrı)

İstek başına giriş token'ı: 30.000 · İstek başına çıkış token'ı: 800 · Günlük istek sayısı: 125

ModelGünlükAylık
GLM-5.3-Flash$0.079$2.37
DeepSeek-V4-Flash$0.0663$1.99
MiniMax-M2.7$0.203$6.08

Girdi tarafını azaltmak istiyorsanız, bir AI agent'ın maliyeti nasıl tahmin edilir en çok önem taşıyan alışkanlıkları ele alıyor.

Kısa tasma üzerinde tutun#

Bir gün observe modunda kalın: agent'ın kendi başına ne yapacağını kaydeder, böylece harekete geçmeden önce deseni görürsünüz. İlk başta yalnızca kendi oturum açma adınıza izin verin. İlk üç pull request'e satır satır bakın ve ilk günden sonra bakiyenizdeki model kullanımını kontrol edin, ardından gerçek ticket sayınızla çarpın.

Depo ayrıca DeepSeek'in eşlik eden makalesindeki bazı tasarımların henüz uygulanmadığını söylüyor, bu yüzden eksik özellikleri bitmemiş olarak değerlendirin, sizin hatanız olarak değil.

Kaynaklar#

Tüm depo bilgileri deepseek-ai/dsh-superagent-prototype (README, SETUP.md, docs/006-deployment.md) kaynağından gelir ve 2 Kasım 2026'da kontrol edilmiştir. Depo sayfası hiçbir commit tarihi göstermiyor ve DSH sürümü 0.2.1-rc.3 bir sürüm adayıdır, bu yüzden kurulumdan önce dokümanı yeniden kontrol edin.