Kendi cihazınızı bağlamak

Orbi bulutta çalışır, dosyalarınızın çoğu ise kendi cihazınızdadır. Orbi Node, o iki yeri birbirine bağlayan küçük bir uygulamadır. Kurduğunuzda panodaki bir agent sizin izin verdiğiniz klasörlerde çalışabilir, cihazınız bir şey olduğunda Orbi'ye haber verebilir ve kod agent'ınız kendi cihazınızda koşabilir.

Sınırları beş cümlede toplayalım; gerisi bu beş cümlenin ayrıntısıdır.

• Cihazınız Orbi'ye haber verebilir: bir dosya değişince, bir eşik aşılınca, belirli saatte.
• Orbi'deki agent'lar cihazınızda yalnız izin verdiğiniz klasörlerde dosya okuyup yazabilir ve yalnız sizin tanımladığınız işleri yapabilir.
• Cihazınızda kod agent'ınız varsa kartlar orada koşar.
• Cihazınız kendi başına karar vermez. Ne yapılacağına her zaman Orbi'deki agent'lar ve akışlar karar verir.
• Cihazınız kapalıysa hiçbir şey olmaz, iş bekler.

#Kurmak

İndirme sayfası orbiwork.space/download adresindedir. macOS ve Linux'ta kurulum tek satırdır; Windows'ta indirdiğiniz dosyayı çalıştırırsınız. Hiçbir durumda yönetici parolası sorulmaz, uygulama kendi kullanıcı klasörünüze kurulur.

Ekranı olmayan bir sunucuya kuruyorsanız pencereye ihtiyacınız yok: aynı kurulum satırını --cli seçeneğiyle çalıştırdığınızda yalnız komut satırı sürümü kurulur. Sunucu için tam reçete aşağıdaki Sunucuya kurulum bölümünde yer alır.

Uygulama ilk açılışta bir kod gösterir. O kodu Orbi'de onayladığınızda cihaz sizin hesabınıza bağlanır. Sonra hangi workspace'lerin bu cihazı görebileceğini seçersiniz; her seçim ayrı bir bağlantıdır ve boş başlar. Bir workspace'in bu cihazda bir şey görebilmesi için klasörü ayrıca eklemeniz gerekir.

Masaüstü uygulaması kendini günceller; yeni sürüm çıktığında bir şey yapmanız gerekmez. Sunucuya kurduğunuz komut satırı sürümü ise kendini güncellemez, yalnızca haber verir: nasıl güncelleneceği Güncellemek bölümünde yazıyor.

Komut satırı sürümünde de komut ezberlemenize gerek yoktur. Terminalde yalnızca orbi-node yazdığınızda tam ekran, ok tuşlarıyla gezilen bir uygulama açılır; klasörler, yetenekler ve ayarlar hep aynı yerden yönetilir. Sunucuda orbi-node zaten arka planda çalışıyorsa (örneğin systemd ile) bu uygulama ikinci bir bağlantı açmadan iliştirme kipinde çalışır: ekranlar ve yaptığınız değişiklikler yine işe yarar, yalnızca canlı akış servisin kendi günlüğünden okunur.

#Sunucuya kurulum

Sunucu, masaüstü cihazınızdan iki noktada ayrılır: ekranı yoktur ve siz başında olmadığınız zamanlarda da Orbi'ye bağlı kalması beklenir. Bu nedenle sunucularda uygulama servis olarak kurulur. Servis, sunucu her açıldığında kendiliğinden başlayan ve siz bağlantınızı sonlandırdığınızda çalışmaya devam eden bir programdır.

Aşağıdaki adımlar Linux içindir ve sırayla uygulanmak üzere hazırlanmıştır. Linux bilmeniz gerekmez; komutları olduğu gibi kopyalayabilirsiniz. Sunucunuza ssh ile bağlanarak başlayın.

#1. Uygulamayı kurun

curl -fsSL https://get.orbiwork.space/install | sh -s -- --cli

Bu komut yalnızca komut satırı sürümünü kurar ve yönetici parolası istemez. Kurulum tamamlandığında uygulamanın hangi dizine kurulduğu ekranda belirtilir. orbi-node komutunu çalıştırdığınızda "komut bulunamadı" uyarısı alırsanız, kurulum çıktısındaki export PATH=... satırını çalıştırıp tekrar deneyin.

#2. Sunucuyu hesabınıza bağlayın

orbi-node login --url https://api.orbiwork.space
orbi-node link
orbi-node dirs add /srv/proje --write

İlk komut ekranda bir doğrulama kodu gösterir; bu kodu kendi cihazınızın tarayıcısından Orbi'de onaylarsınız. İkinci komut sunucuyu bir workspace'e açar. Üçüncü komut ise erişilecek ilk klasörü tanımlar; /srv/proje yerine kendi klasörünüzün yolunu yazın. --write eklemediğinizde klasör yalnızca okunabilir olarak tanımlanır.

Bu komutları hangi kullanıcı hesabıyla çalıştırdığınız önemlidir. Bir sonraki adımda oluşturacağınız servisin aynı kullanıcıyla çalışması gerekir; aksi halde servis başlarken "bağlı workspace yok" uyarısı vererek durur.

#3. Bağlantıyı deneyin

orbi-node start
orbi-node status

İlk komut uygulamayı arka plana alır ve size hemen geri döner. İkinci komutun çıktısında running yes yazıyorsa sunucunuz Orbi'ye bağlanmıştır ve Cihazlar ekranında çevrimiçi görünür.

Bağlantınızı kapatsanız da sunucu bağlı kalır. Durdurmak isterseniz orbi-node stop yazmanız yeterli.

Bir sorun varsa sebebini uygulamanın kendi kaydı söyler:

orbi-node log --out

#4. Sunucu yeniden başladığında da bağlansın

Üçüncü adım bağlantınız kapandığında ayakta kalır ama sunucu yeniden başlatılırsa kalmaz. Sunucunun her açılışta kendiliğinden bağlanması için bir servis tanımlayın.

Önce elle başlattığınızı durdurun; aksi halde servis ikinci bir kopya açmaya çalışır ve başlayamaz:

orbi-node stop

Sonra aşağıdaki bloğun tamamını olduğu gibi kopyalayıp yapıştırın. Uygulamanın nerede kurulu olduğunu ve hangi kullanıcı olduğunuzu kendisi bulur, sizin yazmanız gereken bir şey yoktur:

sudo tee /etc/systemd/system/orbi-node.service >/dev/null <<EOF
[Unit]
Description=Orbi Node
After=network-online.target
Wants=network-online.target

[Service]
User=$(id -un)
ExecStart=$(command -v orbi-node) start --foreground
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable --now orbi-node

Tanımdaki --foreground, uygulamanın kendini arka plana atmamasını söyler: servisi yöneten program göremediği bir süreci denetleyemez.

Bu komutları ikinci adımdaki komutları çalıştırdığınız kullanıcıyla çalıştırın. Uygulamanın ayarları o kullanıcının klasöründe durur; başka bir kullanıcıyla başlatılan servis "bağlı workspace yok" diyerek durur.

Bu işlemden sonra sunucu her açıldığında Orbi'ye kendiliğinden bağlanır. Bağlantı herhangi bir nedenle koparsa on saniye içinde yeniden kurulur.

#5. Kurulumu doğrulayın

systemctl status orbi-node

Çıktıda active (running) ifadesi yer alıyorsa kurulum tamamlanmıştır. Bir sorun varsa nedenini aşağıdaki komut gösterir:

journalctl -u orbi-node -n 50

status=203 ya da status=127 görüyorsanız servis uygulamayı bulamamış demektir. Bu, servis tanımına uygulamanın tam yolu yerine yalnızca adı yazıldığında olur; yukarıdaki blok tam yolu kendisi bulduğu için bloğu olduğu gibi kopyalamak bunu önler.

#Kurulumdan sonra sunucuyu yönetmek

Sunucunuza ssh ile bağlanıp orbi-node yazdığınızda, masaüstü kurulumundaki tam ekran arayüzün aynısı açılır. Klasörleri görüntüleyebilir, yetenekleri onaylayabilir ve o anda yapılan işleri izleyebilirsiniz. Bu arayüz servisin yerine geçmez; yalnızca servisin üzerine açılan bir penceredir ve q ile kapatmanız servisi durdurmaz.

Servisi durdurmak, yeniden başlatmak veya tamamen kaldırmak için:

sudo systemctl stop orbi-node
sudo systemctl start orbi-node
sudo systemctl disable --now orbi-node

#Sunucuyu kopyalayarak çoğaltıyorsanız

Orbi bir cihazı donanım kimliğinden tanır, adından değil. Bu sayede cihazınızı yeniden kurup adını değiştirseniz bile Orbi'deki kaydınız aynı kalır; klasörleriniz, izinleriniz ve ayarlarınız yerinde durur.

Sanal bir sunucuyu kopyalayarak çoğalttığınızda kopya, aslının donanım kimliğini de taşır. Aynı şey bir cihaza ikinci bir Orbi Node kurulumu yaptığınızda da olur. Orbi ikisini tek cihaz sanabilir ve biri diğerinin bağlantısını devralır. Bu yüzden kodu tarayıcıda onaylarken Orbi, aynı cihaz hesabınızda başka bir adla zaten kayıtlıysa size sorar: "Aynı cihaz, yeniden kuruldu" kaydı yeni adla günceller (klasörler ve izinler yerinde kalır, eski kurulum bağlanamaz); "Ayrı cihaz olarak ekle" yeni bir kayıt açar ve eski kurulum olduğu gibi çalışmaya devam eder. Aynı adla gelen kurulum soru sorulmadan yeniden kurulum sayılır.

Sunucuda, tarayıcıya gitmeden aynı kararı komut satırında da verebilirsiniz:

orbi-node login --url https://api.orbiwork.space --separate

Bunu yalnızca kopyada çalıştırın. Aslında çalıştırmanıza gerek yoktur.

#Sık yapılan hatalar

Sunucusu Orbi'de çevrimdışı görünen kullanıcıların büyük bölümü aşağıdaki iki durumdan biriyle karşılaşmıştır.

• Yalnızca orbi-node start demek. Bu komut bağlantınız kapandığında ayakta kalır ama sunucu yeniden başlatılırsa geri gelmez. Sürekli bağlı kalması gereken her sunucuda dördüncü adımı da uygulayın.
• Tam ekran arayüzü açık bırakmak. Arayüz servisin yerine geçmez; kapatmanız bir şeyi durdurmaz, ama açık bırakmanız da sunucu yeniden başlatıldığında bir şey getirmez.
• Servisi başka bir kullanıcıyla tanımlamak. Uygulamanın ayarları, giriş yaptığınız kullanıcının klasöründe durur. Başka bir kullanıcıyla başlatılan servis "bağlı workspace yok" diyerek durur.

Sunucunuz çevrimdışı görünüyorsa önce sunucuya bağlanıp orbi-node status yazın. Çıktı uygulamanın çalışıp çalışmadığını ve çalışmıyorsa son ne söylediğini gösterir.

#macOS ve Windows sunucular

macOS'ta systemctl bulunmaz; aynı görevi launchd üstlenir ve orbi-node start --foreground komutunu çağıran bir tanım dosyası gerektirir. Servis tanımlarında --foreground yazılır: servisi yöneten program, göremediği bir süreci denetleyemez. Windows'ta kurulum PowerShell üzerinden yapılır:

irm https://get.orbiwork.space/cli.ps1 | iex

Bu iki ortam için servis tanımını sizin adınıza hazırlamamızı isterseniz platform@orbiwork.space adresine yazabilirsiniz.

#Güncellemek

Masaüstü uygulaması yeni sürümü kendi indirir ve kurar. Sunucuya --cli ile kurduğunuz sürüm bunu yapmaz: yeni sürüm çıktığında yalnız günlüğüne bir satır yazar ve güncellemeyi siz başlatırsınız. Kurulum satırı aynıdır, yeniden çalıştırmanız yeterlidir:

curl -fsSL https://get.orbiwork.space/install | sh -s -- --cli

Sonrasında cihazı bir kez yeniden başlatın. Kurulum yalnız diskteki dosyayı değiştirir; o sırada çalışan uygulama eski sürümüyle çalışmaya devam eder ve yeniden başlatılana kadar güncelleme işe yaramaz:

sudo systemctl restart orbi-node

Servis kurmadan elle başlattıysanız orbi-node stop ve ardından orbi-node start aynı işi görür.

#Sürüm neden eski görünüyor

Cihazlar ekranında cihazın adının yanında yazan sürüm, o cihazda o anda çalışan sürümdür — diskte kurulu olan değil. Güncellemeyi kurup cihazı yeniden başlatmadıysanız eski sürüm çalışmaya devam eder ve ekranda da eski sürüm yazar. Yeni bir sürüm yayımlandığında Orbi bunu aynı satırın altında söyler; yeniden başlattığınızda uyarı kendiliğinden kaybolur.

#Cihazın adı

Kurulumda yazdığınız ad hem listede gördüğünüz addır hem de agent'ların o cihaza seslendiği adrestir: @device.kullaniciadi.cihaz-adi. Adı sonradan değiştirebilirsiniz. İki yerden yapılır: cihazdaki uygulamanın Ayarlar ekranından ya da Orbi'deki Cihazlar ekranından, cihazın sahibi olarak. Boşluk ve noktalama işaretleri - olur, ad hesabınızda tekildir.

Ad adres olduğu için değiştirmek eskiden yazılmış metinleri etkiler. Kaydetmeden önce Orbi kaç akışın ve kaç kartın eski adresi andığını söyler. O metinleri sizin yerinize değiştirmez: eski adresi yazan kart ya da yorum olduğu gibi kalır, artık bir cihaza karşılık gelmez. Bir akışın bu cihaza erişim izni de metnindeki adresten doğar; adresi güncellemezseniz akış bir sonraki kaydında iznini yitirir. Adı değiştirdikten sonra o akışları açıp adresi düzeltmek iyi olur.

#Klasörler

Orbi cihazınızın tamamını görmez. Yalnız sizin eklediğiniz klasörleri görür ve her klasör için "yalnız okusun" ya da "yazabilsin" diyebilirsiniz. Klasörler cihazdaki uygulamadan eklenip çıkarılır; Orbi'deki Cihazlar ekranında yalnız görünürler.

Bir klasörün gerçek yolu Orbi'ye hiç yazılmaz. Panoda klasörü verdiğiniz adla görürsünüz.

#Yapabildikleri

Bir agent cihazınızda serbestçe komut çalıştıramaz. Yalnız yetenek dediğimiz, önceden tanımlı işleri yapabilir. İki türü vardır.

Bir agent'ın cihazınızı kullanabilmesi için ondan söz etmeniz yeterlidir: kartta, yorumda, akışta ya da sohbette @device. yazıp cihazı seçin. O anda agent o cihazın paylaşılan klasörlerini, yeteneklerini ve gözlemcilerini tek seferde görür. Söz etmediğiniz cihazlar agent'ın önüne yığılmaz; ihtiyaç duyarsa onları listeler ve birini kendisi açar.

Hazır gelenler her cihazda aynıdır: dosya okumak, klasör listelemek, bir dosyanın son satırlarını almak, dosyayı Orbi'ye getirmek, Orbi'deki dosyayı cihaza koymak, sistem durumuna bakmak. Hepsi izin verdiğiniz klasörlerin içinde kalır.

Kendi yetenekleriniz sizin tanımladığınız işlerdir; örneğin "eski günlükleri temizle" ya da "raporu Excel'e yaz". Orbi'ye ne istediğinizi anlattığınızda size bir taslak hazırlanır, ama taslak cihazınıza onaysız yazılmaz: tam metnini görür, isterseniz düzeltir, deneyip sonra onaylarsınız.

Hazır paketler bizim yazdığımız yetenek gruplarıdır ve kullanmak için hiç metin görmeniz gerekmez. İlk paket ofis dosyalarıdır: izin verdiğiniz klasörlerde Word ve Excel dosyası oluşturur ve okur. Paketi cihazdaki Orbi Node uygulamasında, Yetenekler ekranındaki anahtarla açıp kapatırsınız. Ekranı olmayan bir sunucuda aynı iş orbi-node verbs enable office ve orbi-node verbs disable office komutlarıyla yapılır. Anahtar yalnız cihazda durur, çünkü cihazınızın ne yapabileceğine son sözü cihazın başındaki kişi söyler. Orbi'deki Cihazlar ekranı açık paketin yeteneklerini "hazır paket" etiketiyle gösterir ve siz anahtarı çevirdiğinizde liste sayfayı yenilemeden güncellenir. Kapalı bir paketin yetenekleri listede görünmez ve agent'lar onları çağıramaz.

Her yeteneğin bir çalışma klasörü vardır ve çıktısı oraya düşer. Bazı yetenekler "hangi klasörde çalışacağını çağıran seçsin" diye tanımlanır; o zaman agent, paylaştığınız klasörler arasından seçer.

Yeteneğin tanımı agent'ın anladığı biçimdedir. Her yeteneğin adı, ne yaptığını ve ne zaman kullanılacağını söyleyen bir açıklaması, aldığı bilgiler, döndürdüğü çıktının biçimi ve bir örnek çağrısı vardır; Orbi taslağı hazırlarken bunların hepsini doldurur, biri eksikse taslak oluşmaz. Agent yeteneği hazır gelen araçlarla aynı biçimde görür ve "eski günlükleri temizle" gibi bir isteği doğru yeteneğe bağlar. Kart bir cihaza bağlıysa (orada yarım iş var ya da tercih edilen cihaz o) agent yalnız o cihazın yeteneklerini görür; bağlı değilse workspace'teki bütün cihazlarınkini.

Sonradan geliştirmek. Cihazlar ekranında yeteneğe tıklayıp Düzenle deyin. Açıklamayı, aldığı bilgileri, çıktı biçimini ve örneği elle değiştirirsiniz; komutun kendisini "şunu da yapsın" diye yazarak Orbi'ye yeniden yazdırır ya da metni kendiniz düzenlersiniz. Kaydettiğiniz her değişiklik cihaza yeni bir taslak olarak gider: eski sürüm çalışmaya devam eder, cihazda onaylayınca yenisi geçer; bekleyen güncelleme Cihazlar ekranında görünür. Windows cihazlarda yetenek üretimi ve düzenleme şimdilik kapalıdır, ekran bunu söyler.

#Haber vermesi

Cihazınızın Orbi'ye kendiliğinden haber vermesini isterseniz bir gözlemci kurarsınız. Beş şey izlenebilir:

• işlemci, bellek ya da disk belirli bir eşiğin üstünde kalırsa (üçünü tek gözlemciyle de izleyebilirsiniz; hangisi aşarsa haber gelir),
• bir dosyaya yeni satır düşerse (örneğin hata günlüğü),
• bir klasöre dosya girer, değişir ya da silinirse,
• belirlediğiniz saatte,
• bir adres cevap vermezse.

Ne izleneceğini cümleyle anlatabilirsiniz; size formun doldurulmuş hali ve "şu olursa haber verilir" diye okunabilir bir özet gösterilir. Onayladığınızda gözlemci cihazınıza iner.

Kaynak haberi cihazın o anki tam tablosunu taşır: işlemci, bellek, disk ve cihazın ne zamandır açık olduğu. Yani neyi izliyor olursanız olun, haber geldiğinde o an cihazda ne olduğunu tek bakışta görürsünüz; ayrı haberleri birleştirmeniz gerekmez.

Günlük dosyasını izlerken adın her gün değişip değişmediğini sorarız. Adı sabitse tek dosyayı seçersiniz. Değişiyorsa, örneğin app-2026-09-09.log gibi, "adı değişen dosyalar"ı seçip app-*.log yazarsınız; yıldız, adın değişen kısmının yerini tutar. Uyan her dosya izlenir, dünkü dosya yazılmayı bıraktığında kendiliğinden susar ve yenisi doğduğunda ilk satırından itibaren okunur. Bunu seçmezseniz gözlemci yalnız yazdığınız dosyayı izler ve adı değiştiği gün sessizce susar. Yıldız her şeyi kapsayamaz: parola dosyaları ve anahtarlar (.env, .pem, id_rsa gibi) tek dosya olarak da, yıldızla da izlenemez; böyle bir kalıp kaydedilmeden önce geri çevrilir. Agent bir gözlemcinin eşiğini ve aralığını değiştirebilir, ama neyin izlendiğini (dosya, klasör, adres) yalnız siz değiştirirsiniz.

Gözlemci kaba bir ağdır: eşiği düşük tutmak doğrudur, eleme işini agent yapar. Gözlemciler birbirinden bağımsızdır; biri takılırsa diğerleri çalışmaya devam eder. Bir gözlemcinin haberi bir akışı başlatabilir.

Sık kullanılan bir düzen şudur: bir klasöre dosya düştüğünde agent onu okur, özetler ve özeti Orbi'ye kaydeder. Klasör gözlemcisinin yanındaki tek düğme bu akışı sizin için kurar.

Her gözlemcinin günlük bir olay sınırı vardır, varsayılan 500. Sınıra ulaşan gözlemci o gün susar: olay üretmez, akış başlatmaz, cihazınızda kaynak harcamaz. Cihazlar ekranında gözlemcinin yanında "bugünkü sınırına ulaştı, yarın devam eder" yazar ve ertesi gün (workspace'inizin saat dilimine göre) kendiliğinden sürer. Sınırı gözlemcinin ayarlarından değiştirebilirsiniz. Bu fren yanlış ayarlanmış tek bir gözlemcinin bütün krediyi bir sabahta bitirmesini önler; olağan kullanımda hiç görmezsiniz. Sınıra ulaşıldığında cihazın sahibine bir bildirim düşer (gözlemci başına günde bir kez; "Bağlı cihazlarım" kategorisi, bildirim tercihlerinden kapatılabilir).

Günlük dosyası gözlemcisinde eşleşen satırlar bir süre toplanıp tek olay olarak gider; yeni gözlemcide bu süre 30 saniyedir. Deseni boş bırakırsanız her yeni satır bir olay olur; form bunu kaydetmeden önce söyler, çünkü yoğun bir günlük sınırı saatler içinde doldurur.

Bir gözlemcinin haberi geldiğinde akışın önceki çalışması hala sürüyorsa haber kaybolmaz, akışın bekleme kovasına girer ve çalışma bitince kovadaki her şey için tek bir çalışma açılır. Ayrıntı Akışlar › Çakışma davranışı bölümünde.

#Kod agent'ı

Cihazınızda Claude Code gibi bir kodlama aracı varsa kartlar orada koşabilir. Bunun için kod agent'ının tanımında deponun adresi yazılıdır; kartı o agent'a atamak hangi depoda çalışılacağını seçmek demektir. Kartta ayrıca depo seçmezsiniz.

Kart, o depoyu paylaşan ve size açık olan bir cihaza düşer. Hangi cihazların o kartı alabileceğini kartın üstünde görürsünüz; hiçbiri açık değilse bunu da söyler.

Hangi aracın kullanılacağı, hangi modelin seçileceği ve işin hangi kopyada koşacağı cihazda belirlenir. Aynı agent bir cihazınızda bir araçla, diğerinde başka bir araçla çalışabilir. Model cihazdaki uygulamada listeden seçilir; seçim koşuya olduğu gibi gider ve komutu kendiniz yazdıysanız uygulama modelin uygulanıp uygulanmadığını size söyler. Bir cihazın aynı anda kaç kart koşacağını Cihazlar ekranından ayarlarsınız; ayar cihaza bağlıyken ulaşır.

Claude Code, Gemini CLI, Qwen Code ve Codex her koşuda Orbi'ye kendiliğinden bağlanır; kartta seçtiğiniz model ve izin kipi de onlara uygulanır. Bu araçlarla agent sonucunu bildirir ve kartta soru sorabilir. Diğer araçlar da kart koşar ama henüz sonuç bildiremez; onlarla kart eski kurala göre kapanır.

Cihazlar ekranındaki "Şu an" bölümü koşan kartı pano kartıyla aynı biçimde gösterir: numara, proje, agent, başlık, kullanılan araç ve dal, en altta da koşunun hangi adımda olduğu (iş alındı, kod dalı hazırlandı, çalışıyor, sonuç gönderiliyor). Cihazdaki uygulama aynı kartı aynı biçimde çizer.

Agent kartı alırken açıklamasını, kontrol listesini, son yorumları ve eklerini birlikte alır. Karta eklediğiniz ekran görüntüsünü de görür: kartı okuduğunda görsel metnin yanında gelir, okunamayan bir görsel varsa (çok büyük ya da modelin okuyamadığı bir tür) bunu söyler. Kart çalışırken yazdığınız yorumlar da kaybolmaz: agent Orbi'ye her dokunduğunda o ana kadar yazılmış yeni yorumları görür ve önce onları okur. Yorumun agent'a ulaşması bir sonraki dokunuşu kadar sürer; hiç dokunmadan biten çok kısa bir koşu yorumu kaçırabilir.

Kartla birlikte agent'ın kendi tanımı ve ekibin hafızası da gider: agent sayfasında yazdığınız tanım, sabitlenmiş kurallar, hafızanın konu başlıkları ve kartın projesine ait notlar kart metninden önce gelir. Agent kim olduğunu ve ekibin kurallarını ayrıca sormak zorunda kalmaz. İşi bitirirken kalıcı bir ders çıkardıysa bunu sonucuyla birlikte bildirir; ders hafızaya girerken koşunun değiştirdiği dosyalara bağlanır ve o dosyalar sonradan değişirse not "eskimiş" adayı olur. Çok uzun bir tanım ya da çok dolu bir hafıza pakete sığmazsa kesilir ve kesildiği agent'a söylenir.

Koşunun nasıl bittiğini agent kendisi bildirir; cihaz aracın son cümlesinden tahmin yürütmez. İşi bitince agent sonucu özetleyerek bildirir ve bu özet kartın kapanış yorumu olur. Sizden bir karar gerekiyorsa soruyu seçenekleriyle karta sorar. Sizden bir şey olmadan devam edemiyorsa neye ihtiyacı olduğunu yazarak durur. Kart buna göre kapanır:

Kartın beklenen çıktısı koşu ayarlarında seçilir. Kod değişikliği seçiliyse agent commit atar, dalı gönderir ve birleştirme isteği açar. Yalnız yanıt seçiliyse hiçbir şeyi commit'lemez ve cevabını kapanış yorumuna yazar; bir soruyu cevaplatmak ya da bir inceleme yaptırmak için bunu seçin. Hiçbir şey bildirmeden biten koşu için cihaz ikinci bir tur açmaz; kartı yeniden kuyruğa alarak tekrar denersiniz.

Cihazın Orbi'ye bağlantısı koparsa uygulama kendi kendine yeniden bağlanır; kapatıp açmanız gerekmez. Cihazlar ekranından duraklattığınız bir cihaz, bağlantısı kopup yeniden kurulsa da duraklatılmış kalır ve ancak siz sürdürdüğünüzde kart almaya başlar.

Cihazı makinenin kendisinde de duraklatabilirsiniz (orbi-node pause). Bu duraklatma o makineye aittir. Cihazlar ekranında "makinede duraklatıldı" diye görünür ve o cihaza düşecek kartın rozeti de bunu söyler. Orbi'deki Sürdür düğmesi bu duraklatmayı kaldırmaz, yalnız Orbi'den verileni kaldırır. Makinedeki duraklatmayı o makinede orbi-node resume çalıştırarak kaldırırsınız.

Kart cihazdan geri döndüğünde sebebi hem kartın yorumunda hem geçmişinde okursunuz; cihaz @device. adresiyle anılır, adı sonradan değişse de bağlantı çözülmeye devam eder. Aynı kart cihaza ulaşamadan bir günde üç kez kuyruğa dönerse artık dönmez: hataya düşer ve size söylenir.

#Kod kartı çekmecesi

Kodlama agent'ına atanmış ya da bir kez cihaza gitmiş kart, kod kartı olarak kendi çekmecesiyle açılır. Kart hangi durumda olursa olsun (yapılacak, kuyrukta, çalışıyor, incelemede) bu görünüm kalır; koşu durdurulduğunda ya da agent iş üretmeden çıktığında hiçbir şey kaybolmaz.

• Durum satırı. Başlığın altındaki tek cümle kartın halini söyler: hangi cihazda ne kadar süredir koştuğu, kuyrukta neyi beklediği, neden geri döndüğü ("Karttan durduruldu", "Ajanın sorusu cevapsız kaldı", "Ajan sonucu bildirmeden bitti", "Araç hata ile çıktı", "Cihaz kapandı") ya da ne zaman bittiği. Cümlenin önündeki nokta koşarken mor, geri dönmüşse sarı, bitince yeşildir. Yapılacak şey aynı satırın sağında durur: koşarken "Durdur", geri dönmüşse "Yeniden kuyruğa al". Durum tek satırdır; ayrıntı cümlesi uzunsa kısaltılır, üstüne gelince tamamı okunur. "Tur bitince durdur", "Serbest bırak", durum değiştirme ve silme kolonun şeridindeki ⋯ menüsündedir.
• Meta etiketleri. Durumun hemen altında dal, kodlama aracı ile model ve birleştirme isteği küçük etiketlerde okunur. Satır kırılmaz; uzun bir dal adı etiketin içinde kısaltılır, üstüne gelince depo ile birlikte tamamı görünür. Birleştirme isteğine tıklayınca sağlayıcıda açılır.
• Oturum sekmesi. Yorumlar, agent'a yazdığınız mesajlar ve aracın adımları aynı çizgide, zamana göre durur; kim ne zaman ne dedi tek bakışta okunur. Aracın adımları kompakt bloklarda gelir: son üç adım görünür, bloğun başlığına tıklayınca tümü açılır. Koşan blok canlı akar ve koşu bittikten sonra da okunur.
• Ayrıntılar sekmesi. Atanan kişi, öncelik, son tarih ve etiketler; üst kart ve alt kartlar; açıklama, birleştirme istekleri, ekler ve checklist.
• Agent'ın sorusu. Agent bir karar isterse soruyu seçenekleriyle birlikte karta sorar; panoda kartın üstünde "Cevabınızı bekliyor" yazar, çekmecede soru yazma kutusunun üstünde durur. Seçeneklerden birini seçerek ya da kendi cevabınızı yazarak cevaplarsınız; agent aynı oturumda kaldığı yerden devam eder. Yarım saat içinde cevap gelmezse kart sorusuyla birlikte size döner. O zaman da aynı kutudan cevaplarsınız: Cevapla ve kuyruğa al cevabınızı karta yazar ve kartı yeniden kuyruğa alır, yeni koşu cevabı okuyarak başlar.
• Tek yazma kutusu. Koşu sürerken çekmecenin dibindeki kutu iki yere yazabilir. Ajana seçiliyse agent mesajı turunun sonunda okur ve aynı oturumda devam eder; Yorum seçiliyse ekibe yazılır. Mesajın yanında "cihaza ulaştı · araç sıradaki turunda okur" notu durur, çünkü araç tur ortasında girdi alamaz. Koşu yokken kutu yorum yazar.
• Koşu ayarları. Koşu yokken yazma kutusunun alt çubuğunda tek bir etiket durur ve seçili ayarları sırayla yazar: cihaz, model, efor ve beklenen çıktı. Etikete tıklayınca kutunun içinde tercih edilen cihaz, model, efor, izin kipi ve beklenen çıktı seçimleri adlarıyla açılır; agent çok depoluysa depo da oradadır. Seçim anında kaydedilir. İncelemedeki ya da hataya düşmüş kartta gönder düğmesinin yanındaki ok Yorumla ve tekrar çalıştır seçeneğini açar. Listeler bağlı cihazlardan gelir ve "varsayılan" yazan seçim klasörün cihazdaki varsayılanını alır.

#Kartın çalışma yeri

Bir kart hangi cihazda koşar? Çoğu zaman düşünmezsiniz: kartı kuyruğa alan kişinin açık cihazı öne geçer, o yoksa depoyu paylaşan ilk boş cihaz alır. İki durumda kartın kendi bir "yeri" olur:

• Yarım iş. Bir koşu, işi dala göndermeden biterse (agent kaydetmeden durdu, komut reddedildi, cihaz kapandı) yapılanlar o cihazda kalır ve kart o cihaza bağlanır: panoda "yarım iş" rozeti görünür, çekmecenin durum satırı kaç dosya ve kaç kayıt beklediğini yazar. Kartı yeniden kuyruğa alırsanız yalnız o cihaz alır ve kaldığı yerden sürer; başka bir cihaz dalı sıfırdan kurup işi ikinci kez yazmaz. Cihaz kapalıysa kart kuyrukta bir saat bekler, sonra size döner ve iki yolu söyler: cihazı açıp kartı yeniden kuyruğa almak, ya da kartı serbest bırakmak. Serbest bırakınca cihaz yarım işi kaydeder, kartın dalına gönderir ve kopyayı temizler; kart artık herhangi bir cihazda sürebilir. Cihaz kapalıysa istek bekler ve açılınca yerine getirilir; kart bunu da söyler. Bağ, iş dala gidince kendiliğinden çözülür.
• Tercih edilen cihaz. Yazma kutusunun alt çubuğundan, koşu başlamadan seçersiniz; yalnız kartı alabilecek cihazlar listelenir. Seçtiğiniz cihaz açıkken kartı yalnız o alır; kapalıysa kart beklemez, sıradaki uygun cihaz alır. Seçim kartta kalır: kartı kaç kez kuyruğa alırsanız alın aynı cihaza gider.

#Cihazda bir kez ayarlanması gerekenler

Kart koşarken başında kimse olmaz. Bu yüzden yol ortasında birine soru soran her şey, işin durması demektir. Üç şeyin önceden hazır olması gerekiyor:

• Kodlama aracının komut çalıştırabilmesi. Kartın işi kodu yazmakla bitmez: değişikliği kaydetmesi, projenin kendi kontrollerini koşturması ve bir birleştirme isteği açması gerekir. Hazır gelen komutlar zaten bunu yapabilecek biçimde ayarlıdır; kendi komutunuzu yazarsanız o kısmı bozmayın. Bu ayar aynı zamanda kodlama araçlarının yeni bir klasörü ilk gördüğünde sorduğu "bu klasöre güveniyor musun" sorusunu da yanıtlar.
• Git'in kimin adına kaydettiğini bilmesi. Değişiklikler cihazınızdaki git ayarındaki isim ve e-postayla kaydedilir; ikisi boşsa kayıt hiç yapılamaz.
• Gönderirken parola sorulmaması. Kart, işi bittiğinde depoyu uzağa gönderir. Bunun için ya parolasız bir anahtar ya da bir kez kaydedilmiş bir erişim anahtarı gerekir.

Bir kart "hiçbir şey kaydedilmedi" diyerek size geri döndüyse sebep neredeyse her zaman bunlardan biridir. Yapılan iş kaybolmaz: cihazdaki çalışma kopyası olduğu gibi durur ve kart nerede durduğunu yazar. Eksiği giderip kartı aynı cihazda yeniden kuyruğa alın, iş kaldığı yerden sürer.

#Kim ne yaptırabilir

Cihaz sizin hesabınıza kayıtlıdır. Başkasının sizin cihazınızda iş yaptırabilmesi için onu erişim listesine eklemeniz gerekir; liste boşken yalnız siz yaptırabilirsiniz. Listede olmayan biri sizin cihazınızı bir kartta anarsa iş yapılmaz ve nedeni karta yazılır.

Erişimi yalnız siz açarsınız. Workspace'in yöneticisi cihazınızın bağlantısını durdurabilir, devredebilir ya da tamamen kapatabilir; ama sizin cihazınızda kimsenin iş yaptırmasına izin veremez. Kapatmak ekibin güvenliği, açmak cihazın sahibinin kararıdır.

Bir kart size açık olmayan bir cihaza yönelmişse pano bunu bekletmeden söyler. Kartı siz kuyruğa aldıysanız kart "cihaza erişiminiz yok" der ve kimden erişim isteyeceğinizi yazar. Aynı kartı başkası açtığında erişimi olmayan kişinin adını görür; böylece cihazın sahibi kimi listeye ekleyeceğini bilir. Eskiden herkes aynı cümleyi görüyordu ve erişimi olan kişi de kendi yetkisini sorguluyordu; daha eskiden kart hiçbir şey demeden saatlerce bekliyordu.

Bir akış cihazınızda bir şey yapacaksa bu ayrı bir izindir ve onu bir kez onaylarsınız. Akış sonradan değiştirilirse izin düşer ve yeniden sorulur. Böylece kimse siz onaylamadan cihazınızda çalışan bir otomasyon kuramaz.

Workspace'ten ayrılan birinin cihaz bağlantısı da kapanır.

#Güvenlik

Karar cihazınızdadır. Orbi bir şey isteyebilir; kabul edip etmemek uygulamanın kararıdır.

• İzin verdiğiniz klasörün dışına çıkan hiçbir istek kabul edilmez. Kısayollar ve bağlantılar da çözülüp kontrol edilir.
• Bazı dosyalar varsayılan olarak hiç okunmaz: parola dosyaları, anahtarlar, depo ayarları.
• Cihazınızda ne yapıldığının kaydı yine cihazınızda tutulur. Uygulamadaki "Şu an" ekranından tek tek okuyabilirsiniz.
• İstediğiniz an durdurabilirsiniz: hem Orbi'deki Cihazlar ekranından hem uygulamanın kendi içinden.
• Cihazınız kapanırken elindeki kart kaybolmaz, kuyruğa geri döner.
• Bağlantı cevap vermeyi keserse (uyuyan dizüstü, düşen ağ) Orbi bunu bir dakika içinde fark eder ve cihazı çevrimdışı gösterir; o cihaza giden istekler beklemez, hemen "çevrimdışı" cevabı alır. Cihaz çökerse kartın geçici erişim anahtarı da aynı anda iptal edilir.

#Planlar

Cihaz bağlamak ücretli planlarda kullanılabilir. Planınız kaç cihaz bağlayabileceğinizi ve her cihazda kaç gözlemci kurabileceğinizi belirler; ayrıntı Planlar ve güvenlik sayfasındadır.

Kod agent'ının kullandığı yapay zeka maliyeti sizin cihazınızdaki araca aittir, Orbi kredinizden düşmez. Cihazınızdan bir şey isteyen Orbi agent'ının maliyeti ise normal şekilde kredinizden düşer.

Bir şey beklediğiniz gibi çalışmıyorsa Sorun giderme sayfasına bakın.