Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

DaxBax Neo Hakkında

DaxBax Neo, kendi sunucularınızda çalışan bir ekip YZ ajanı için kontrol panelidir. Her ajanın şu anda ne yaptığını gösterir, ajan oluşturmanıza veya kapatmanıza, onlara servisler ve mesajlaşma uygulamaları bağlamanıza, onlara zamanlanmış görevler atamanıza olanak tanır — her sunucuya elinizle SSH ile girmeden.

Neo’daki bir ajan, kendi sunucunuzda çalışan bir Claude Code (veya Codex) örneğidir ve Neo’da bir “çalışan” olarak gösterilir: kendi adı, kartı, kendi bağlantıları ve — açarsanız — kendi tarayıcısı ve Telegram’da kendi konuları vardır. Ajanların kendisi sunucularınızda çalışır; Neo onları yönetme ve izleme yolunuzdur, işi sizin için bulutta bir yerde yapan bir servis değildir.

Neden oluşur

  • Sunucular — ajanlarınızın gerçekten çalıştığı makineler. Bir sunucuyu bir kez bağlarsınız, Neo ardından üzerinde bir veya birkaç ajan çalıştırabilir.
  • Ajanlar — her biri kendi bağlamına ve bağlantılarına sahip, bağımsız YZ “çalışanları”.
  • Projeler — birkaç ajan için ortak bağlam: siz kimsiniz, ne iş yapıyorsunuz, müşterileriniz kim. Bir projeye bağlı herhangi bir ajan bu açıklamayı kendi talimatlarında görür.
  • Entegrasyonlar — bir ajanın kullanabileceği mesajlaşma uygulamaları (Telegram, MAX) ve kendi servisleriniz (REST API, webhook’lar, MCP sunucuları).
  • Zamanlanmış görevler — bir ajanın sizsiz, bir takvime göre yaptığı işler.
  • Oturumlar — ajanların canlı terminalleri ve bir ajandan kendi hesabınız altında bir yere giriş yapmasını istediğinizde açılan tarayıcı oturumları.

Bu belgeler kimler için

Neo’yu gerçekten kullanan kişiler için: sunucu ve ajan kurmak, servis bağlamak, görevleri ve ajanların ne yaptığını izlemek. Bu bir API referansı değildir — Neo’nun, sıradan bir SaaS ürününün bir token ile sunduğu türden üçüncü taraf entegrasyonlar için herkese açık bir API’si yoktur. Her şey bu arayüz üzerinden yönetilir.

Başlarken

Giriş yapmaktan ilk çalışan ajanınıza kadar en kısa yol.

1. Giriş yapın veya kayıt olun

Giriş sayfasında e-posta ve şifre ile kayıt olabilir, ya da bağlı bir sağlayıcı üzerinden (Google, Yandex — hangi seçeneklerin mevcut olduğu hangi alan adından giriş yaptığınıza bağlıdır) giriş yapabilirsiniz. Kayıt olmak size hemen kendi, izole çalışma alanınızı verir — sunucularınız, ajanlarınız ve bağlantılarınız başka hiç kimse tarafından görülemez.

Şifrenizi mi unuttunuz? Giriş sayfasında bir “Şifrenizi mi unuttunuz?” bağlantısı var: eski şifreye gerek kalmadan yeni bir şifre belirlemeniz için e-postanıza bir bağlantı gönderir.

2. Bir sunucu bağlayın

Sunucular → “Sunucu ekle”. Bir adres, bir kullanıcı ve bir giriş yöntemi verin:

  • DaxBax Neo anahtarı (varsayılan) — Neo bu sunucu için bir anahtar oluşturur ve sunucuda çalıştırmanız için anahtarın genel yarısını authorized_keys’e ekleyen tek bir komut gösterir.
  • Kendi anahtarınız — mevcut bir özel anahtarı tamamen yapıştırın (ilk ve son satır dahil).
  • Şifre — Neo bir kez giriş yapar, kendi anahtarını ekler ve o andan itibaren onu kullanır; sunucu anahtarla girişi reddediyorsa şifreyi kaydedilmiş tutabilirsiniz.

Kullanıcının root olması gerekmez — parolasız sudo yeterlidir.

3. Bir ajan oluşturun

Ajanlar → “Yeni ajan”. Bir ad verin (teknik ad sizin için oluşturulur) ve çalışacağı doğrulanmış bir sunucu seçin. Hemen bir projeye bağlayabilirsiniz, böylece ekibin ortak bağlamını alır, ve belleğini seçebilirsiniz: izole, veya aynı sunucudaki başka bir ajanla paylaşılan.

Oluşturulduktan sonra ajan Oturumlar altında görünür — canlı terminalini burada görürsünüz.

4. İhtiyacınız olanı bağlayın

Entegrasyonlar: mesajlaşma uygulamaları (Telegram, MAX) ve genel seçenekler — kendi REST API’niz, gelen webhook’lar, MCP sunucuları. Bir servisi bir kez bağlayın ve ihtiyacı olan ajanlara atayın.

5. Gerekirse, zamanlanmış görevler

Zamanlanmış görevler: bir ajanın bir takvime göre (cron, her N dakikada bir, veya bir kez) ne yapması gerektiği ve hangi ajanlara atandığı. Çalışma alanınızın herhangi bir üyesi görevleri yönetebilir; sadece kendi kalıcı Claude oturumu olan ajanlar bunları alabilir.

Buradan sonra, her konunun bölümünü daha ayrıntılı okuyun.

Sunucular

Bir sunucu, ajanların işini gerçekten yapan bir makinedir. Neo, kendi SSH anahtarı (veya sertifikası) ile üzerinde kurduğunuz bağlantıların ve ajanların gerektirdiği şeyler dışında hiçbir şey saklamaz.

Sunucu ekleme

Sunucular → “Sunucu ekle” → “Bir çalışan düğüm bağlayın”: adres, port, kullanıcı ve bir giriş yöntemi.

Giriş yöntemleri:

  • DaxBax Neo anahtarı (varsayılan). Neo bu sunucu için özel bir anahtar oluşturur ve genel yarısını authorized_keys’e ekleyen tek bir komut gösterir. O andan sonra Neo sadece bu anahtarla giriş yapar.
  • Kendi anahtarınız. Mevcut bir özel anahtarı tamamen yapıştırın (ilk ve son satır dahil). Anahtar parola korumalıysa, parola yalnızca anahtarı okumak için bir kez kullanılır ve hiçbir zaman saklanmaz — anahtarın kendisi parolasız, şifrelenmiş olarak tutulur.
  • Şifre. Varsayılan olarak şifre bir kez kullanılır: Neo giriş yapar, kendi anahtarını authorized_keys’e ekler, anahtarın çalıştığını kontrol eder ve o andan sonra anahtarla giriş yapar, şifreyi unutur. Sunucu anahtarla girişi reddediyorsa, şifreyi kaydedilmiş tutabilirsiniz ve Neo onu kullanmaya devam eder (sudo istemlerini yanıtlamak dahil).

Ne anahtar ne de şifre arayüz üzerinden asla geri gösterilmez — denetim günlüğü kullanılan yöntemi kaydeder, asla sırrın kendisini değil.

Kullanıcının root olması gerekmez: parolasız sudo yeterlidir (<kullanıcı> ALL=(ALL) NOPASSWD:ALL). “Kontrol et” düğmesi bu olmadan sunucuyu reddeder.

Adresi veya kullanıcıyı değiştirme

Ana makineyi, portu veya kullanıcıyı değiştirmek bağlantının yeniden doğrulanmasını gerektirir.

Bir sunucu, birden fazla ajan

Aynı sunucuya birden fazla ajan bağlanabilir; sunucuyu paylaşabilirler, ama her birinin kendi belleği vardır — izole, veya ajan oluşturulurken seçilen aynı sunucudaki belirli bir başka ajanla paylaşılan.

Kalıcı anahtar yerine SSH sertifikaları

Bazı çalışma alanlarında ek bir koruma katmanı açıktır: kalıcı bir anahtar yerine Neo, ayrı bir sertifika servisi tarafından verilen kısa ömürlü bir sertifika (yaklaşık 30 dakika geçerli) ile her bağlantıyı imzalar. Bu çalışma alanınız için açıksa, sunucular kendiliğinden, arka planda, sizin hiçbir şey yapmanıza gerek kalmadan buna geçer — eski anahtar basitçe kullanılmaz hale gelir. Ayarlar → “SSH sertifikaları” kaç sunucunun zaten geçtiğini gösterir.

Ajanlar

Neo’daki bir ajan, sunucularınızdan birinde çalışan ve arayüzde ayrı bir “çalışan” olarak gösterilen bir Claude Code (veya Codex) örneğidir: kendi adı, kartı, bağlantıları ve durumu.

Bir ajan oluşturma

Ajanlar → “Yeni ajan”: bir ad (herhangi bir dilde — teknik ad sizin için oluşturulur) ve çalışacağı sunucu. En az bir doğrulanmış sunucuya ihtiyacınız var; henüz yoksa, aynı ekrandan hemen ekleyebilirsiniz.

Ayrıca şunları yapabilirsiniz:

  • ajanı bir projeye bağlamak — bu durumda projenin ortak bağlamını (siz kimsiniz, ne iş yapıyorsunuz, müşterileriniz kim) alır;
  • ona izole bellek vermek, veya aynı sunucuda zaten çalışan başka bir ajanla bellek paylaştırmak.

Oluşturulduktan sonra ajan hemen Oturumlar altında görünür.

Ajanın tarayıcısı

Ajana kendi tarayıcısını açabilirsiniz (ajan kartı → “Tarayıcı oturumları”). Kalıcı bir profil tutar: bir kez yapılan giriş saklanır ve o andan sonra otomatik olarak yeniden kullanılır.

Ajanın kendi kişisel hesabınız altında bir yere giriş yapması gerekiyorsa, şifreyi kendisi asla yazmaz ve sohbette sizden asla istemez — bir giriş isteği gönderir, bunu Oturumlar altında görür ve onaylarsınız (bkz. Oturumlar).

Telegram konuları

Ajan kartı → “Telegram konuları”: bir ajan, bütün bir Telegram grubunu kendi konuları üzerinden yönetebilir, her biri kendi bağlamına sahip ayrı bir konuşmadır — bir konuda /new onu yeniden başlatır, bir konuyu kapatmak onu arşivler. Bir ajanın tüm konuları onun uzun süreli belleğini paylaşır. Bir grup, ajanın kartında gösterilen bir kodla bağlanır (grupta /bind <kod> gönderilir) — bota sadece eklenen bir grup, kod gönderilene kadar hiçbir şey almaz. Botun bir grup yöneticisi olması, veya @BotFather’da gizlilik modunun kapalı olması gerekir — aksi halde konular içindeki mesajları görmez.

Neo geçici olarak erişilemezse

Tarayıcı ve Telegram konuları, Neo yanıt vermese bile bir hafta kadar çalışmaya devam eden bir lisans üzerinde çalışır — her iki taraftaki kısa bir kesinti bu özellikleri kapatmaz.

Oturumlar: ajanları izlemek ve onlar için giriş yapmak

Oturumlar, tüm sunucularınızdaki her ajanın şu anda ne yaptığını gösterir.

Canlı terminal

Her ajanın mevcut çalışma oturumu vardır — kendi terminalinde yazdığı ve gördüğü şey. Onu açabilir, izleyebilir ve gerekirse ajanı anında yönlendirmek veya düzeltmek için kendiniz yazabilirsiniz.

Tarayıcı oturumları

Bir ajanın kendi tarayıcısı açıksa (ajan kartı → “Tarayıcı oturumları”), asıl kullanımının ortaya çıktığı yer burasıdır: bir ajanın bazen kendi kişisel hesabınız altında bir yere giriş yapması gerekir — girişsiz açılmayan bir site. Bu olduğunda:

  1. ajan bir giriş isteği gönderir — bunu tam olarak burada, Oturumlar içinde görürsünüz;
  2. bu ekrandan ajanın tarayıcısını açar, giriş sayfasını görür ve kontrolü alırsınız;
  3. her zamanki gibi kendiniz giriş yaparsınız;
  4. tarayıcıyı ajana geri verirsiniz.

Onu geri vermediğiniz sürece, ajanın tarayıcıya komutları bekler. Ajanın kendisi şifreyi asla görmez veya hatırlamaz — sadece girişin başarılı olduğunu öğrenir. Tarayıcı profili saklanır, böylece bir dahaki sefere yeniden giriş yapmanıza gerek kalmaz: sıradan bir tarayıcının bir girişi hatırlaması gibi hatırlanır.

Oturumlarda Telegram konuları

Bir ajanın Telegram konuları açıksa, her konu (ayrı bir konuşma) da burada, mesajlarıyla ve “Yeniden Başlat” / “Arşivle” eylemleriyle birlikte görünür.

Projeler

Bir proje, birkaç ajan için aynı anda ortak bağlamdır: siz kimsiniz, nerede bulunuyorsunuz, ne iş yapıyorsunuz, müşterileriniz kim. Bu metin, projeye bağlı her ajanın çalışma talimatlarının bir parçası olur — projenin her “çalışanı” bunu görür.

Neden kullanışlı

Birkaç ajan aynı şey üzerinde çalışıyorsa, kim olduğunuzu ve şirketinizin ne yaptığını her birine ayrı ayrı açıklamanıza gerek yoktur — bunu bir kez, projede yazarsınız ve bağladığınız herhangi bir ajan bu bağlamı hemen alır.

Oluşturma ve düzenleme

Projeler → “Proje oluştur”: bir ad ve şirket ile projenin bir açıklaması. Kaydetmeden önce kartın listede nasıl görüneceğini (“Proje önizlemesi”) görebilirsiniz.

Açıklamadaki değişiklikler, projedeki her ajana aynı anda uygulanabilir.

Bir ajanı projeye bağlama

Ajan oluşturulurken yapılır (isteğe bağlı “Proje” alanı) — projesi olmayan bir ajan sadece kendi bağlamıyla çalışır.

Entegrasyonlar ve bağlantılar

Entegrasyonlar, bağlayabileceğiniz servislerin bir kataloğu ve zaten bağlı olanların bir listesidir. Bir servis bir kez bağlanır, sonra ona ihtiyacı olan ajanlara atanır.

Mesajlaşma uygulamaları

Telegram ve MAX — bir ajanın kendine özel bir botu olabilir (sadece onun için, anında yanıt verir), veya mesajları doğru ajana yönlendiren bir bağlantı üzerinden paylaşılan bir bot olabilir.

Telegram’da ayrıca konular vardır: bir ajan bir grubun her konusunu kendi ayrı konuşması olarak yönetir — ayrıntılar için Ajanlar sayfasına bakın.

Kendi servisleriniz

İhtiyacınız olan bir servis için hazır bir kart yoksa, “Evrensel” kategorisi üç şekilde her şeyi kapsar:

  • Kendi hizmetiniz (REST API) — temel adres, giriş yöntemi, bir sır ve isteğe bağlı olarak bir OpenAPI adresi. Ajan servisi kendisi çağırır; sır sunucunuzdan asla ayrılmaz.
  • Gelen olaylar (webhook) — bağlantı kendi adresini alır, örneğin /api/hooks/<token>, isteğe bağlı olarak HMAC-SHA256 ile imzalanmış. Gelen her olay, ajanın okuyabileceği ve üzerine hareket edebileceği bir mesaj haline gelir, bir mesajlaşma uygulamasındaki bir mesaj gibi. Bağlantı başına dakikada en fazla 120 olay; bir olay gövdesindeki hiçbir şey asla bir komut olarak çalıştırılmaz.
  • MCP sunucusu — Neo, sunucuyu sırları açıkta göstermeden ajanın kendi araç setine ekler. Ajan, bir yeniden başlatmadan sonra yeni araçları görür.

Bir katalog girdisi yeniden adlandırıldığında veya birleştirildiğinde

Bazen bir katalog kartı birkaç eski kartın yerini alır (örneğin Bitrix24, bir bağlantı yöntemi seçimi sunar — webhook veya kullanıcı adı ve şifre). Eski kart altında yapılan bağlantılar değerlerini koruyarak otomatik olarak yeni karta taşınır; seçmediğiniz yöntemin alanları sadece gizlenir, zorunlu olmaz.

Zamanlanmış Görevler

Zamanlanmış görevler, bir ajanın sizsiz, kendi başına yaptığı şeydir: bir cron takvimine göre, her N dakikada bir, veya bir kez.

Nasıl çalışır

Neo takvimi doğrular ve ajanın kendi sunucusuna teslim eder; o andan sonra sunucunun kendisi çalıştırır — bir görevin tetiklenmesi için Neo’nun erişilebilir olması gerekmez ve kısa bir Neo kesintisi hiçbir görevi durdurmaz. Başarısız çalıştırmalar yeniden denenir, kesinti sırasında kaçırılan çalıştırmalar sonradan telafi edilir.

Görevleri kim atayabilir

Çalışma alanınızın herhangi bir üyesi görevleri yönetebilir, sadece ajanı oluşturan kişi değil.

Hangi ajanlar görev alabilir

Sadece kendi kalıcı Claude oturumu olan ajanlar — sadece Codex üzerinden çalışan veya kendi oturumu olmayan paylaşılan bir bot üzerinden çalışan ajanlar zamanlanmış görevleri çalıştırmaz.

Takvim eşleşmezse

Neo, sunucunun sizin belirlediğinizden farklı bir takvim çalıştırdığını görürse, doğru olanı yeniden gönderir (en fazla beş dakikada bir) — elinizle düzeltmeniz gereken hiçbir şey yoktur.

Giriş Yapma, Çıkış Yapma ve Güvenlik

Giriş yapma

E-posta ve şifre ile, veya bağlı bir sağlayıcı üzerinden (Google, Yandex — hangi seçeneklerin mevcut olduğu hangi alan adından giriş yaptığınıza bağlıdır) giriş yapabilirsiniz. E-posta ile kayıt, adresinizin doğrulanmasını gerektirir: gelen kutunuza bir bağlantı gönderilir ve onu takip etmeden giriş yapamazsınız.

Şifrenizi mi unuttunuz

Giriş sayfasında bir “Şifrenizi mi unuttunuz?” bağlantısı var. E-postanızı girin: bu adres için bir hesap varsa, yeni bir şifre belirlemeniz için bir bağlantı alırsınız. Bu adres için bir hesap yoksa, sayfa tam olarak aynı şekilde yanıt verir — bu kasıtlıdır, böylece kurtarma formu belirli bir adresin kayıtlı olup olmadığını kontrol etmek için kullanılamaz.

Çıkış yapma

Ayarlar → “Çıkış yap” mevcut oturumunuzu sonlandırır. Her yerden çıkış yap, şu anki dahil tüm oturumlarınızı aynı anda sonlandırır — yeniden giriş yapmanız gerekir. Artık kullanmadığınız bir cihazdan giriş yaptıysanız kullanışlıdır.

Çalışma alanınız

Kayıt olmak size hemen kendi, izole çalışma alanınızı verir — sunucularınız, ajanlarınız, bağlantılarınız ve projeleriniz, davet ettiğiniz kişiler dışında kimse tarafından görülemez.

Sunucu bağlantısı güvenliği

Neo’nun sizin adınıza bağlandığı sunucular, adları bir adrese çözüldükten sonra kontrol edilir: localhost, özel ve dahili aralıklara (bulut meta verisi adresleri dahil) bağlantılar kesinlikle reddedilir, ve bağlantı hataları her zaman genel bir şekilde bildirilir, böylece iç ağınızı araştırmak için kullanılamazlar.

Sık Sorulan Sorular

Neo’nun kendi sistemlerimize bağlamak için herkese açık bir API’si var mı?

Hayır. Neo, üçüncü taraf entegrasyonlar için bir API’ye sahip bir platform değildir — kendi ajanlarınızı yönetmek ve izlemek için bir arayüzdür. Kendi sisteminizden bir ajana veri almanız, veya tersi gerekiyorsa, bu dışarıdan Neo’ya bağlanarak değil, Entegrasyonlar üzerinden yapılır: ajan servisinizi kendisi çağırır, veya servisiniz Neo’nun size verdiği webhook adresine olaylar gönderir.

Anahtarları veya şifreleri açıkta göstermeden bir sunucu ekleyebilir miyim?

Evet — “DaxBax Neo anahtarı” giriş yöntemi kendiliğinden bir anahtar oluşturur ve sadece sunucuda tek bir komut çalıştırmanızı ister; ne anahtar ne de bir şifre daha sonra arayüz üzerinden geri gösterilir. Bkz. Sunucular.

Neo geçici olarak erişilemezse ne olur?

Zaten atanmış zamanlanmış görevler çalışmaya devam eder — takvim ajanın kendi sunucusunda bulunur. Tarayıcı ve Telegram konuları mevcut lisansları üzerinde en az bir hafta çalışmaya devam eder.

Şifremi unuttuysam nasıl geri girebilirim?

Giriş sayfasındaki “Şifrenizi mi unuttunuz?” bağlantısı. Bkz. Giriş Yapma, Çıkış Yapma ve Güvenlik.

Bir ajan sıradan bir sohbet botundan nasıl farklıdır?

Bir ajanın sunucunuzda kendi çalışma oturumu (Oturumlar altında izleyebileceğiniz bir terminal), konuşmalar arasında kalıcı olan bir belleği ve ona bağladığınız servislere erişimi vardır — sadece mesajlara yanıt vermez, işi yapar.