Akışlar ve takvim

#Akış nedir?

Akış, bir tetik gerçekleşince kendi kendine çalışan iştir. Dört tetik türü vardır. Cron ile tekrar eden, tek seferlik hatırlatıcı, olay tetiği (Orbi'nin içinde bir şey olduğunda) ve servis tetiği (bağladığınız bir serviste bir şey olduğunda) türleri vardır ve son ikisi aşağıda anlatılıyor. Kanban'da görünmez. Her akış bir projeye aittir ve o projenin Akışlar sekmesinde yaşar. Sol menüdeki Akışlar, bütün projelerin akışlarını tek listede gösterir.

Akış her çalıştığında bir koşu kaydı oluşur. Koşu, bir görev gibi kendi adım listesini tutar ve ne yaptığını kaydeder, ama panodaki kartlardan bağımsızdır. Bir koşu üç durumdan birinde olur, yani Çalışıyor, Tamamlandı ya da Hata durumundadır.

#Tuval: akışın evi

Bir akışa tıkladığınızda tuval açılır. Tuval, akışın şemasını çizdiğiniz yerdir ve tek bir cümleyi okutur: akışı ne başlatır, sonra kim ne yapar.

En üstte tetik kartları durur. Hemen altlarında, hepsinin bağlandığı Başla düğümü vardır ve akışın adı, modeli ile görev tanımı oradadır. Görev tanımı akışın tamamına aittir, yani hangi tetik başlatırsa başlatsın aynı iş yapılır. Başla'nın altında işi yapan agent kartları sıralanır. En yalın akış tetik ve Başla'dan oluşur ve o durumda işi Orbi'nin kendi yardımcısı yapar.

Soldaki listeden hem tetik hem agent sürükleyip bırakabilirsiniz. Bıraktığınız tetik kendiliğinden Başla'ya bağlanır ve gelen bağlantısı olmayan her agent de Başla'dan beslenir. Bu yüzden tuvalde havada kalmış, hiçbir yere bağlanmayan bir kart oluşamaz.

Agent listesinde önce Orbi'nin kendisinin çalıştırdığı agent'lar gelir. Dışarıdan bağlanan agent'lar akışa konamaz; bu yüzden listenin en altında, "Dışarıdan bağlananlar" başlığı altında katlı dururlar ve tıklayınca açılır. Agent sayısı arttığında listenin üstünde bir arama kutusu belirir; ada ya da ünvana göre süzer ve dışarıdan bağlananları da bulur.

Agent'ların altında Kadrolar listelenir. Bir kadroyu tuvale bıraktığınızda o adımı tek bir agent değil kadro yürütür: bir koordinatör adımın işini kadronun Orbi'de çalışan üyeleri arasında böler, iki ya da daha çok üyede bir üyenin işini başka bir üye eleştirir ve adımın çıktısı sonraki adıma öyle geçer. Kart yüzünde kadronun üyeleri üst üste görünür. Kendi cihazında çalışan üyeler akış adımında yer almaz, çünkü akış bir cihazı bekleyemez. Ayrıntı: Kadrolar.

Akışı çalıştıran düğmeler tuvalin sol alt köşesinde, birlikte durur: Çalıştır, Test et ve Duraklat. Yanlarında akışın son durumu yazar — en son ne zaman çalıştığı, o an çalışıp çalışmadığı, duraklatılmışsa tetiğinin artık çalışmadığı. O yazıya tıklayınca sağdaki Çalışmalar sekmesi açılır. Akış duraklatılmışken bu köşe sararır ve Çalıştır yerini Sürdür'e bırakır.

Kartları düzgün yerleştirme. Tuvalin sağ alt köşesinde, yakınlaştırma düğmelerinin yanında Düzgün yerleştir düğmesi durur. Kartlar üst üste bindiyse ya da bağlantılar birbirinin üstünden geçiyorsa bu düğme şemayı baştan dizer: her kart kendisini besleyen kartın altına iner, aynı kartın beslediği kartlar yan yana gelir ve hiçbir kart bir diğerinin altında kalmaz. Yeni dizilim hemen kalıcı olmaz. Beğenmezseniz köşede çıkan bildirime tıklayıp eski düzene dönersiniz, beğenirseniz Kaydet'e basarsınız.

Üst çubukta akışın adı, Kaydet ve bir ⋯ düğmesi kalır. Odaklanma, Zen modu ve silme o menünün içindedir.

Zen modu. Üst çubuktaki ⋯ menüsünden açılır ve tuvali tüm ekrana yayar. Sol menü ve üst çubuk çekilir, parça listesi ile ayar paneli tuvalin üstüne gelir ve istediğinizde açılıp kapanır. Çalıştırma düğmeleri sol alt köşede yerinde kalır, yani Zen'de de akışı çalıştırabilirsiniz. Büyük akışlarda şemanın tamamını görmek için işe yarar. Çıkmak için Esc ya da sağ üstteki Çık düğmesini kullanın.

• Bir agent'ı başka bir agent'ın üstüne bırakın. Sürüklediğiniz agent, bıraktığınız agent'tan sonra çalışır ve kartı onun altına yerleşir. Bu, soldaki listeden ilk kez sürüklediğinizde de geçerlidir, yani agent'ı doğrudan bağlamak istediğiniz kartın üstüne bırakabilirsiniz. Bağlantıları kartların kenarındaki noktalardan elle de çekebilirsiniz. Bir döngü oluşturacak bağlantı kurulmaz.
• Bir agent kartına tıklayın. Sağ panelde o agent'ın özeti ve bu akışa özel talimat kutusu açılır. Buraya yazdığınız metin agent'ın kendi tanımını değiştirmez, yalnızca bu akışta onun üstüne eklenir.
• Aynı panelde "Bu adım panoya yazamaz" seçeneği vardır. İşaretlerseniz o adım kayıt, görev, dosya ve takvim yazamaz; bulduklarını yalnızca çıktısıyla bir sonraki adıma aktarır. Araştırma ve sınıflandırma adımları için idealdir, çünkü yazma işini akışın sonundaki tek bir adımda toplarsınız ve aynı bilginin iki kez kaydedilmesi baştan engellenir. Okuma ve web araması bu seçenekten etkilenmez. İşaretli kartın üstünde "yalnız okur" rozeti görünür.
• Çift tıklayın. Agent'ın kendi sayfasına gidersiniz.
• Bir tetik kartına tıklayın. Sağ panelde yalnız o tetiğin ayarları açılır. Tetik türü bir kez kaydedildikten sonra değiştirilemez, başka bir tür istiyorsanız yeni bir tetik eklersiniz.
• Boş bir yere tıklayın. Sağ panel akışın kendisine döner ve adı, görev tanımı ile modeli gösterir.
• Çalışmalar sekmesi geçmişi listeler, ayrıntısı aşağıdadır.
• Yaptığınız değişiklikler Kaydet'e basana kadar kaydedilmez. Bir şey eksikse Kaydet düğmesi çalışmaz ve eksiğin ne olduğu sağ panelde tek tek yazar. Kaydetmeden sayfadan çıkmaya kalkarsanız sorulur.

Tuvalde bağlantı isteği ya da veri dönüştürme kartları bilinçli olarak yoktur. Uzmanlık agent'ın talimatında yaşar ve tuval yalnızca kimin kimden sonra ve hangi durumda çalışacağını gösterir.

#Her agent ne görür?

Bir agent kartı çalıştığında eline şunlar geçer.

• Görev tanımı, yani Başla düğümüne yazdığınız metnin tamamı. Böylece akışın hedefini her agent bilir.
• Kendi özel talimatı, yani o karta yazdığınız ve yalnız bu akışta geçerli olan metin.
• Akıştaki yeri, yani kendisinden önce çalışanlar, hemen sonra çalışacaklar ve akışın daha sonraki adımlarındaki agent'ların adları. Kendisinden sonra gelen herhangi bir adıma ait işi yapmaması, onu çıktısıyla devretmesi gerektiği açıkça söylenir.
• Kendisine ok gelen kartların çıktıları, kimin ürettiği belli olacak şekilde.
• Akışı başlatan olayın verisi, örneğin gelen postanın göndereni, konusu ve içeriğinden bir alıntı. Alıntı postanın hem başından hem sonundan alınır, böylece imzadaki iletişim bilgileri de görünür. Çok uzun postalarda ortası kısaltılır ve kısaltıldığı belirtilir.
• Workspace tanıtımı, projenin amacı, koleksiyon listesi ve ilgili hafıza notları.

Görmediği şey, kendisiyle aynı anda çalışan kardeş kartların ne yaptığı ve onların çıktılarıdır. Paralel iki dal birbirini beklemez ve birbirini görmez.

Bu yüzden görev tanımı ile kart talimatı farklı işler yapar. Görev tanımına akışın hedefini yazın, her kartın talimatına o kartın payını yazın. Görev tanımına adım adım dört iş sayarsanız, kartların hepsi dördünü de okur.

Başla'ya bir agent bağladıysanız görev tanımını boş bırakabilirsiniz, çünkü işi kartların talimatları anlatır. Aynı metni hem görev tanımına hem karta yazmak gereksizdir, çünkü kart o metni iki kez okur ve talimat uzadıkça odak dağılır. Görev tanımı yalnızca kartların ortak bağlamı için vardır, yani hepsinin bilmesi gereken bir şey varsa oraya yazılır. Tuvalde agent yoksa görev tanımı zorunludur, çünkü işi anlatan başka bir yer kalmaz.

Görev tanımı (Başla):
  Gelen taleplerden potansiyel müşteri kaydı çıkar ve ekip hazır bulsun.

Toplayıcı kartı:
  Yalnız arama yap ve bulguları listele. Koleksiyona yazma, görev açma.

Yazar kartı:
  Sana gelen bulguları özetle ve Leads koleksiyonuna yaz.

Çok uzun bir postanın tamamını okuması gerekiyorsa, o agent'a posta servisinin bağlantısı verilmiş olmalıdır (agent sayfasındaki bağlantılar bölümü). Verilmemişse eline gönderen, konu ve yukarıdaki alıntı geçer ve çoğu iş için bu yeterlidir.

#Agent'lar bilgi uydurmaz

Bir agent yalnızca girdisinde ya da bir aracın döndürdüğü sonuçta gerçekten bulunan değerleri yazar. Postada telefon numarası yoksa o değer boş kalır ve gerçeğe benzeyen bir numara üretilmez. Eksik kalan bilgileri çıktısında sayar, siz de gerekiyorsa tamamlarsınız.

Bu bilinçli bir tercihtir. Eksik bir değer size hiçbir şey söylemez, doldurulmuş bir değer ise doğru sanılır, bu yüzden yalnızca gerçekten bilinen değerler yazılır.

#Koşul: bir dal ne zaman çalışsın?

Paralel çalışan dalların hepsinin her seferinde çalışması gerekmez. Bir bağlantının üstüne gelin, beliren "+ koşul" düğmesine tıklayın ve kendi cümlenizle yazın.

müşteri şikayet ediyorsa

Koşul yazılmış bir bağlantı kesik çizgiyle çizilir ve üstünde cümleniz durur. Önceki adım bittiğinde Orbi onun sonucunu bu cümleye göre değerlendirir ve cümle tutmuyorsa o dal çalışmaz. Böylece aynı akış içinde karar verebilirsiniz, örneğin "olumsuz geri bildirimse destek ekibine yaz, değilse yalnız kaydet" dersiniz.

Koşulu bir form yerine cümleyle yazmanız bilinçlidir. Sonuçlar metindir ve "sütun eşittir değer" biçimindeki bir kural onların çoğunu ifade edemez.

Bilmeniz gerekenler şunlardır.

• Koşul, Başla'dan çıkan bağlantılara da konabilir. Orada değerlendirilen şey, tetiğin getirdiği veridir, örneğin gelen e-postanın içeriği ya da koleksiyon tetiğinde değişen kaydın sütunları ("durumu kazanıldı ise") değerlendirilir.
• Bir adıma birden çok yol geliyorsa, en az biri geçerse çalışır. Aksi halde tek bir "hayır" bütün alt dalları susturur ve karar verme anlamını yitirirdi.
• Aynı adımdan çıkan koşullar birlikte okunur. "İK ile ilgiliyse", "satış talebiyse" ve "diğer" gibi cümleler tek bir seçimin şıklarıysa, en iyi uyan tek dal çalışır; "ekinde dosya varsa" ile "İngilizceyse" gibi bağımsız özellikler ise ayrı ayrı değerlendirilir ve birkaçı birden geçebilir. Önceki adımın çıktısı kararı zaten yazıyorsa ("Kategori: İK" gibi) ona uyulur.
• "X ise" ve "X değilse" birbirini tamamlamaz. Koşul, önceki adımın sonucuna sorulur, dünyaya değil. Sonuç konuyu netleştirmiyorsa iki cümle de doğrulanamaz ve iki dal birden çalışmaz. Bir adımın bütün çıkışları koşulluysa tuval bunu size söyler.
• Kararı öngörülebilir yapmanın en kolay yolu şudur. Önceki adımın talimatına "çıktının ilk satırına DURUM: evet ya da DURUM: hayır yaz" gibi net bir kural koyun ve koşulda da onu aratın. Böylece karar her çalışmada aynı çıkar.
• Karar verilemezse dal çalışmaz. Emin olunamayan bir durumda dalı çalıştırmamak, çalışma geçmişinde açıkça görünen bir eksiklik bırakır ve bu, yanlış dalın dışarıya bir e-posta göndermesinden daha kolay düzeltilir.
• Hiçbir dal sessizce atlanmaz. Çalışma geçmişi üç durumu ayırır, yani koşul sağlandı, koşul sağlanmadı ve karar verilemedi durumlarını gösterir. Çalışmayan adım gerekçesiyle birlikte listelenir ve çalışma özeti kaç adımın çalışmadığını söyler. Seçili bir çalışmada tuvaldeki koşul etiketi de ✓, ✗ ya da ! işaretini gösterir.
• Koşul değerlendirmesi de kredi harcar. Küçük bir işlemdir, ama kullanım dökümünde ayrı bir satır olarak görünür.

#Test et: kuru koşu

🧪 Test et, akışı gerçekten koşar. Model çalışır ve okuma araçları gerçek veriyle çalışır, ama dışa yazan her araç (görev açma, kayıt yazma, mail ya da mesaj gönderme) çalıştırılmaz, yerine "şunu yapacaktım" önizlemesi düşer. Koşu özetinde bu eylemler "→ şunu yapacaktı: …" satırlarıyla listelenir ve tuvaldeki kartlar yine yeşil ya da kırmızı boyanır. Bir olay tetiğini test ettiğinizde prova, gerçekleşen son olayın verisiyle yapılır. Test, tek seferlik bir hatırlatıcıyı kapatmaz ve geçmişte 🧪 işaretiyle görünür. Model gerçekten çalıştığı için normal bir çalışma kadar kredi harcar.

#Çalışma geçmişi: ne oldu, ne zaman?

Çalışmalar sekmesi düz bir liste gösterir. Her çalışma iki satırdır. Üstte durumu, zamanı ve ölçüleri ("7 adım · 17 sn · 101,6K token"), altında ise neyle başladığı yazar, örneğin gelen postanın göndereni ve konusu görünür. Aradığınız çalışmayı genellikle bu ikinci satırdan bulursunuz.

Bir çalışmanın üstüne tıklayınca ayrıntısı açılır. Aynı anda yalnız biri açık kalır, böylece hikaye hep aynı yerden okunur. En son çalışma siz açmadan da açıktır, ama kapatırsanız kapalı kalır.

#Tuvalde göster

Listenin başındaki anahtar, seçili çalışmayı tuvale yansıtır. Kapalıyken tuval akışın kendisini gösterir, yani düzenleme yaparken kartlar sizi yanıltmaz. Açtığınızda kartlar o çalışmada ne olduğuna göre yeşil, kırmızı ya da soluk boyanır, çalışan yollar hareketlenir ve koşul etiketleri kararlarını gösterir. Tuvalin üstünde hangi çalışmayı gösterdiğiniz yazar ve oradan tek tıkla akışa dönersiniz.

#Ayrıntının içinde ne var?

Açılan ayrıntı tek bir akıştır. Önce ne yapıldı, sonra ne çalışmadı, en sonda ne çıktı gelir.

Yapılan işler zaman çizelgesi olarak sıralanır. Her adımın başlığı agent'ın kendi iş cümlesidir ("Hesabı ve sahibini arıyorum" gibi), sağında süresi, altında gri bir satırla o adımdan ne çıktığı yazar. Bir adım hata verirse nedeni kırmızı olarak satırın altında görünür.

Koşul yüzünden çalışmayan adımlar sebebiyle birlikte tek satırda listelenir. Agent'ların tam çıktıları, deneme çalışmasında yapılacak işlemler ve kontrol listesi uzun oldukları için katlanmış durur, başlıklarına tıklayarak açarsınız. Kontrol listesi işaretlemek gibi ara işlemler hikayeyi boğmasın diye varsayılan olarak gizlenir ve "ara adımlar" bağlantısıyla açabilirsiniz. Çalışma sürerken çizelge birkaç saniyede bir kendiliğinden uzar. Çalışma bittiğinde kalıcı olur ve aylar sonra açsanız da aynı hikayeyi okursunuz.

Aynı gösterimi görev kartında (agent çalışırken görünen "şu an: …" satırı ve İz sekmesi) ve sohbette (yanıtın üstündeki "N adım · M araç" bloğu) de bulursunuz, çünkü üç yerde de aynı dil konuşulur.

#Cron ayarlama

Soldaki listeden "Belirli aralıklarla" tetiğini tuvale sürükleyin, sonra kartına tıklayıp sağ panelden ayarlayın. Önce günlük, haftalık ya da aylık sıklığı, sonra saati seçersiniz. Zaman dilimi akışın tamamına aittir ve akış panelinden seçilir.

Zamanı serbest cümleyle yazmanız bilerek istenmez. "Her pazartesi sabah" ifadesinden saatin altı mı dokuz mu olduğu anlaşılmaz ve kendi kendine çalışan bir işte bu belirsizliğin bedeli, aylar sonra fark edilen yanlış bir çalışmadır.

#Tek seferlik hatırlatıcı

Her iş tekrar etmez. "Yarın 11:00'da şu görevi merge etmeyi hatırlat" gibi istekler için "Bir kez, belirli anda" tetiğini tuvale sürükleyin ve kartına tıklayıp tarih ile saat girin. Kartın üstünde ne anlaşıldığı düz cümleyle yazar.

Hatırlatıcı hedef anında bir kez çalışır ve kapanır. Listeden düşer ve Geçmiş hatırlatıcılar bölümüne iner (ürettiği görevin bağlantısıyla birlikte). Sohbette "yarın bana hatırlat" dediğinizde agent da bunu tek seferlik hatırlatıcı olarak kurar, her gün tekrar eden bir iş oluşturmaz.

Bilinmesi gerekenler şunlardır.

• Şimdi çalıştır, hatırlatıcıyı beklemeden çalıştırır ve kapatır.
• Duraklatılan bir hatırlatıcının anı geçerse, devam ettirildiğinde iş yine çalışır. Ancak an 24 saatten eski kaldıysa artık çalıştırılmaz ve geçmişte "kaçırıldı" olarak işaretlenir. Kaçırılmış bir iş sessizce yutulmaz.
• Biten hatırlatıcı düzenlenip yeni bir tarih verilerek yeniden kurulabilir.

#Bir akışı birden çok şey başlatabilir

Bir akışa istediğiniz kadar tetik ekleyebilirsiniz, örneğin hem her sabah dokuzda hem de alanda yeni bir görev açıldığında çalışsın diyebilirsiniz. Akışı açın ve soldaki listeden istediğiniz tetiği tuvale sürükleyin, kendiliğinden Başla düğümüne bağlanır.

Her tetik kendi başına yönetilir. Kartına tıklayıp ayarlarını açar, ayrı ayrı duraklatabilir, her birine kendi daraltmasını verebilir ve tek tek silebilirsiniz. Bir tetiği duraklatmak diğerlerini etkilemez.

Bilmeniz gerekenler şunlardır.

• Hangi tetik çalışırsa çalışsın aynı görev tanımı işler. Akışın ne yapacağı tektir ve tetikler yalnızca onu ne zaman başlatacağınızı söyler.
• Aynı anda yalnızca bir çalışma sürer. İki tetik aynı anda ateşlense bile akış iki kopya çalıştırmaz.
• Son tetik silinemez. Tetiksiz bir akış hiç çalışamaz, akışın tümünü silmek isterseniz üst bardaki Sil düğmesini kullanın.
• Aynı olay iki kez eklenemez, çünkü aynı şeyi iki kez dinlemek işi iki kez çalıştırırdı. Ölçüt tetiğin türü değil, hangi olaya uyduğudur. İki ayrı koleksiyonu ya da iki ayrı hedef durumu dinleyen tetikler birlikte durabilir, çünkü hiçbir olayda buluşmazlar. Biri diğerinin kapsadığı bir şeyi dinliyorsa (örneğin biri tek bir koleksiyonu, diğeri tümünü) engellenir.

#Olay tetiği: bir şey olduğunda çalış

Üçüncü tetik türü zamana değil olaya bağlıdır. Soldaki listede her olay kendi kartıyla durur, istediğinizi tuvale sürükleyin. Dört olay vardır.

Daraltma kutusunu boş bırakmak "tümü" demektir ve sonradan daraltabilirsiniz. Olay gerçekleştiğinde koşu açılır, olayın özeti çalışmaya veri olarak girer ve görev tanımınız ne yapılacağını söyler. Görev olaylarında bu özet görevin numarası ve başlığıdır. Koleksiyon olayında ise değişen kaydın numarası, adı ve sütunları gelir, böylece Başla'dan çıkan bağlantıya "durumu kazanıldı ise" gibi bir koşul yazabilirsiniz. Uzun metin sütunları kısaltılır ve kayıt çok genişse özete sığmayan sütunlar olduğu ayrıca belirtilir. Adımlar kaydın tamamını her zaman kendisi okuyabilir.

Zincirleme tetiklemelere karşı üç koruma vardır ve hepsi otomatiktir. Bir çalışmanın ürettiği olay aynı akışı yeniden tetikleyemez, zincirleme tetiklemeler 30 adımda kesilir ve kredi tavanı dolduğunda yeni koşu açılmaz. Meşru zincirler (görev aç, sonra başka tetik onu işlesin) serbestçe çalışır.

#Servis tetiği: bağlı bir serviste bir şey olduğunda

Dördüncü tür Orbi'nin dışına bakar, çünkü bağladığınız bir servisteki olay akışı başlatır. Soldaki listeden "Bağlı bir serviste olay olunca" kartını tuvale sürükleyin, sonra kartına tıklayıp hangi olayı ve hangi hesabı izleyeceğini seçin.

Slack, GitHub ve Telegram tetikleri diğerlerinden bir noktada ayrılır. Bu üç servis bir şey olduğunda Orbi'ye kendisi haber verir, bu yüzden beklemeden çalışırlar. Diğer servisler düzenli aralıklarla sorulduğu için orada birkaç dakikalık gecikme normaldir.

GitHub tetiğinde bilmeniz gerekenler şunlardır.

• Taslak PR "açıldı" sayılmaz. Taslak, incelemeye hazır işaretlendiğinde tetiklenir; "açıldı" olayını daraltmasına yazan bir akış taslaklar için boşuna çalışmaz.
• Olay türlerini virgülle ayırarak yazın: opened, ready_for_review, merged, closed. Boş bırakılırsa dördü de tetikler.
• Akışın agent'ı diff'i araçla okur. Tetik yalnızca PR'ın numarasını, başlığını, dalını ve adresini taşır; "PR açılınca incele" diyen bir akış diff'i GitHub konektörünün araçlarıyla çeker. Bunun için akıştaki agent'a GitHub bağlantısına erişim vermiş olmanız gerekir.
• Karta referans eden PR aynı anda karta da bağlanır. Tetik kurmasanız bile PR'ın durumu kartta görünür; bkz. Görevler.
• İnceleme tetiği inceleme başına bir kez çalışır. Bir inceleme kırk satır içi yorum taşısa da akış bir kez başlar; satır satır ne istendiğini akışın agent'ı GitHub konektörünün inceleme listeleme aracıyla okur. İnceleme sonucunu virgülle ayırarak daraltabilirsiniz: approved, changes_requested, commented. "PR'a değişiklik istendiğinde düzelt" akışı bu tetikle kurulur.

Slack tetiklerinde işinize yarayacak birkaç ayrıntı vardır.

• Orbi kanala davet edilmiş olmalıdır. Üyesi olmadığı bir kanalı dinleyemez.
• Kanalı adıyla ya da kimliğiyle daraltabilirsiniz. #satis yazmanız yeterlidir, büyük harf ve Türkçe karakter farkı gözetilmez.
• Orbi'nin kendi yazdığı mesajlar tetiklemez. Aksi halde akış, kanala yazdığı cevabı yeni bir olay sanıp kendini sonsuza dek besleyebilirdi.
• Komut ve kısayol aynı tetiği besler. İkisi de "bilerek çağırdım" demektir ve ayırmak akışı gereksiz yere ikiye bölerdi. Komutu yazan kişi, çalışmanın başladığını yazdığı yerde anında görür.

Telegram tetiklerinde bilmeniz gerekenler şunlardır.

• Bot sohbete eklenmiş olmalıdır. Gruplarda bot varsayılan olarak yalnızca kendisine yazılan komutları görür; bütün mesajları dinlemesini istiyorsanız BotFather'da o bot için gizlilik kipini kapatın.
• Sohbeti adıyla ya da kimliğiyle daraltabilirsiniz. @kanal_adi yazmanız yeterlidir, büyük harf ve Türkçe karakter farkı gözetilmez.
• Botun kendi mesajları tetiklemez. Aksi halde akış, sohbete yazdığı cevabı yeni bir olay sanıp kendini sonsuza dek besleyebilirdi.
• Cevabı akış yazar. Tetik sohbetin kimliğini taşır ve akıştaki agent, Telegram konektörünün mesaj gönderme aracıyla aynı sohbete yanıt yazar. Bunun için agent'a Telegram bağlantısına erişim vermiş olmanız gerekir.

Google Meet tetiğinde bilmeniz gerekenler şunlardır.

• Toplantıda transkript açık olmalıdır. Kapalıysa toplantı hiç tetiklemez.
• Transkript toplantı biter bitmez hazır olmaz. Google onu birkaç dakika sonra üretir; Orbi bunu bilir ve biten toplantıyı bir süre bekletip transkripti gelince tetikler. Yarım saat içinde transkript oluşmazsa o toplantı bırakılır.
• Tetik transkriptin bir bölümünü taşır, tamamını akışın agent'ı Google Meet konektörünün transkript okuma aracıyla çeker.

Bütün servis tetikleri için bilmeniz gerekenler şunlardır.

• Tetik kurulduğu andan sonrasını izler. Açtığınız anda gelen kutunuzdaki mevcut postalar için çalışmaz, yoksa bir tetiği açmak onlarca koşu başlatırdı.
• Servisin bağlı olması gerekir (Ayarlar → Entegrasyonlar). Bağlı değilse olay listede görünür ama seçildiğinde bunu söyler.
• Kişisel bağlantı kullanılamaz. Tetik kendi kendine, kimsenin başlatmadığı bir anda koşar ve kişisel bağlantının tek garantisi "yalnız sahibinin başlattığı koşularda yüklenir" olmasıdır. Bu yüzden tetikte yalnız workspace bağlantıları seçilir.
• Akışın kendi gönderdiği posta tetiklemez. Bir akış e-posta atıp aynı kutuyu dinliyorsa kendini sonsuza dek besleyebilirdi, o yüzden bağlı hesabın yazdığı öğeler atlanır.
• Olaylar sıraya girer, kaybolmaz. Bir akış aynı anda tek bir çalışma yürütür. Önceki çalışma sürerken yeni bir olay bulunursa sırada bekler ve çalışma biter bitmez geliş sırasına göre işlenir. Aynısı krediniz bittiğinde de geçerlidir, yani olay beklemeye alınır ve kredi yenilenince çalışır. Beklemek servis olaylarına özgüdür, çünkü zamanlanmış bir çalışma aynı durumda atlanır ve bunu aşağıdaki "Çakışma davranışı" bölümü anlatır.
• Sırada en fazla 50 olay birikebilir. Bu sayıya ulaştıysanız akış gelen olayları yetiştiremiyor demektir, o yüzden tetiğin daraltmasını gözden geçirin.
• Kontrol dakikada bir yapılır. Akış anında değil, olaydan birkaç dakika sonra çalışır. Uzun süre hiçbir şey bulunmayan bir tetik daha seyrek kontrol edilmeye başlar, kontrol aralığı en fazla beş dakikaya çıkar ve ilk olayda yeniden sıklaşır. İki istisna vardır. "Etkinlik başlamak üzereyken" tetikleri toplantıyı kaçırmamak için her zaman sık kontrol edilir, Slack, GitHub ve Telegram tetikleri ise hiç kontrol edilmez, çünkü haber servisin kendisinden geldiği için beklemeye gerek yoktur.

#"İşini bitir, bırak, git"

Bir koşu, görevleri oluşturur ve biter. Oluşturduğu görevlerin sonrasında ne olduğuyla ilgilenmez.

Bu ayrım önemlidir. Koşunun işi başlatmaktır, bitirmek değildir. Oluşturduğu görevler panoya düşer, normal iş akışına girer ve kendi incelemelerinden geçer. Bir koşunun Tamamlandı görünmesi "işler üretildi" demektir, "işler bitti" demek değildir.

#Var olan bir görevi yoklamak

Bir akış yalnızca yeni görev üretmez. Prompt'unuz açıkça bir görevi işaret ediyorsa o göreve yorum da yazabilir. Tipik kullanım, bir işi periyodik yoklayıp sahibini dürtmektir.

Her pazartesi 09:00:

@task.50 numaralı görevi kontrol et. Hala "Yapılacak" durumundaysa
@user.deniz'e "ilerleme durumunu kontrol et" diye bir yorum ekle.
Görev tamamlandıysa hiçbir şey yapma.

Görevi numarasıyla belirtin (@task.50), çünkü akışın kendi yorum akışı yoktur ve yorum daima belirli bir göreve yazılır. Aynı şekilde görevin durumunu değiştirebilir veya başkasına atayabilir. Yorumdaki @user.<ad> anması, o kişiye normal bildirim gönderir.

Her yoklamada yeni görev açtırmak yerine bu kalıbı tercih edin, böylece pano temiz kalır.

#Çakışma davranışı

Bir akış aynı anda tek bir çalışma yürütür. Önceki çalışma sürerken yeni bir tetikleme gelirse ne olacağı, tetiklemenin nereden geldiğine bağlıdır. İki ayrı yol vardır ve ayrım şudur. Bir olay yalnızca bir kez olur, bir zamanlama ise yeniden gelir.

Beklemeye alınanlar: servis tetikleri ve dışarıdan gelen çağrılar. Bağladığınız bir serviste olan bir şey (yeni posta, başlamak üzere olan etkinlik, Slack mesajı) ve akışın kendi adresine düşen bir istek (İşbirliği) sıraya girer, çalışma biter bitmez geliş sırasına göre işlenir. Bunlar kaçırılırsa geri getirilemez, o yüzden atmak veri kaybı olurdu. Sıranın tavanı bir tetikte 50 olaydır.

Birleşenler: olay tetikleri. Bir olay tetiği (görev açıldı, durumu değişti, birine atandı, koleksiyona kayıt yazıldı, cihazınızdaki bir gözlemci haber verdi) önceki çalışma sürerken gelirse kaybolmaz: akışın bekleme kovasına girer ve çalışma biter bitmez kovadaki olayların tamamı için tek bir çalışma daha açılır. Ajan olayları toplu görür: kaç olay geldi, ilki ve sonuncusu neydi, ilk yirmisi tam haliyle. Kova en çok 100 olay ya da bir saat tutar; taşarsa en eskiler düşer ve bu, açılan çalışmaya yazılır. Böylece indirme klasörüne art arda düşen beş fatura tek çalışmada işlenir, konuşkan bir günlük dosyası ise her satır için ayrı bir çalışma açamaz.

Atlananlar: zamanlamalar. Yinelenen bir zamanlama ya da tek seferlik bir hatırlatıcı önceki çalışma sürerken gelirse atlanır. Biriktirmek, yavaşlayan bir işin arkasında onlarca kopya toplar, maliyeti büyütür ve aynı veriyi tekrar tekrar yazar. Zamanlama zaten bir sonraki sırasında yeniden gelir.

Şimdi çalıştır ne bekler ne atlar. Önceki çalışma sürerken düğmeye bastığınızda Orbi size bir çalışmanın sürdüğünü söyler ve ikincisini açmaz.

#Duraklat, devam ettir, şimdi çalıştır

• Pause / Resume akışı silmeden geçici olarak durdurur.
• Şimdi çalıştır, cron beklemeden manuel tetikler. Yeni bir akış kurarken çıktısını görmek için en pratik yoldur.
• Log ekranı tüm geçmiş çalıştırmaları, durumlarını ve çıktılarını gösterir.

#Akış adımı ajanın bilgisayarında

Ajanın kendi bilgisayarı açık olan çalışma alanlarında akışlar da bilgisayarı kartlar gibi kullanır. Adımı olan akışta her ajan adımı işe başlamadan önce karar verir: eldeki bilgiyle tek seferde cevaplanacak bir işse adımı Orbi'de yapar, araştırma, yazı, dosya ya da analiz gibi bir işse bilgisayarına devreder. Adımı olmayan akış bu kararı bir kez, bütün koşu için verir. Zamanlanmış koşu da, elle başlatılan koşu da aynı yoldan geçer.

• Her koşu temiz bir klasörle başlar. Bir koşunun adımları aynı klasörü paylaşır: ilk adımın bıraktığı dosyayı sonraki adım okur. Akışın bir sonraki koşusu bu klasörü görmez. Klasör koşu bittikten 30 gün sonra silinir; asıl ürünü ajan Orbi Dosyalar'a kaydeder.

• Adımın çıktısı ajanın son mesajıdır. Sonraki adım onu, Orbi'de çalışan bir adımın çıktısı gibi alır.

• Kimse beklenmez. Koşuyu izleyen kimse olmadığı için ajan soru sorup beklemez; makul olanı seçer ve varsaydığını son mesajında yazar.

• Kimin adına çalışır. Koşuyu elle başlatan kişinin, zamanlanmış ya da tetikle başlayan koşuda akışı kuran kişinin yetkisiyle çalışır. Akışı kuran kişi çalışma alanından ayrıldıysa koşu başlamaz, hata olarak kapanır ve çalışma alanı yöneticilerine bildirim gider. Üye biri Şimdi çalıştır ile koşuyu kendi adına başlatabilir.

• Durum satırı. Çalışma geçmişinde koşunun ayrıntısını açtığınızda kartlardaki durum satırı görünür: sırada, hazırlanıyor, çalışıyor, bitti ya da neden durdu. Durdurma menüsü de oradadır.

• Kadro adımı ve iş verilen ajan. Kadro adımında bilgisayarı koordinatör seçerse kadronun üyeleri koşunun bilgisayarında aynı klasörde aynı anda çalışır; koordinatör planı Orbi'de yapar ve işi onlara paylaştırır. Koşunun iş verdiği bir ajan da aynı kararı verir ve bilgisayarı seçerse aynı bilgisayarda çalışır. Bilgisayardaki ajanın açtığı kart, Orbi'de açılan kart gibi koşunun ayrıntısındaki kart listesinde görünür.

Kuru koşu ve salt okur adım her zaman Orbi'de çalışır.

#Kopyala

Bir akışı, tüm kartları ve kablolarıyla birlikte kopyalayabilirsiniz — küçük bir farkla yeni bir akış kurmak isterseniz sıfırdan başlamanıza gerek kalmaz. Kopya duraklatılmış doğar, siz gözden geçirip kendiniz açarsınız. Akışta gelen bir webhook adresi varsa kopya kendi yeni adresini alır; eski adres olduğu gibi kalır ve çalışmaya devam eder. Kopyalama düğmesi üst bardaki ⋯ menüsündedir.

#Koşular birbirini hatırlamaz

Bir koşu, önceki çalışmasını hatırlamaz. Geçmiş çıktıya erişim yalnızca storage üzerinden olur. Koşu çıktısını bir koleksiyona yazar, sonraki çalıştırma o koleksiyonu okur.

Bu aynı zamanda tekrar yazımı engelleyen mekanizmayı devreye sokar, çünkü koleksiyona yazarken semantik duplicate önleme çalışır ve aynı haberi ikinci kez eklemez.

#Akış Builder: tuvalde sohbet ederek kur

Tuvalin solundaki Builder paneli, akışı sohbet ederek kuran inşa ortağıdır. İsteğe bağlıdır ve üstteki Akış Builder düğmesiyle açılır (açıkken parça listesinin yerini alır). Ne istediğinizi kendi cümlenizle anlatırsınız ("her pazartesi 09:00'da konu araştırılsın, sonra taslak yazılsın, editör beğenirse yayına hazır işaretlensin"). Builder gerekirse seçenekli bir soru kartı açar (neyle başlasın, hangi agent hangi adımı yapsın, sıralı mı paralel mi, sonuç nereye yazılsın), sonra tetiği, kartları ve kabloları tuvale canlı çizer. Kartın talimatı, kablonun koşulu ve BAŞLA'nın ortak görev tanımı gözünüzün önünde dolar.

Var olan bir akışta "şu adımdan sonra şunu da yapsın" dediğinizde mevcut kartlar korunur, çünkü koşu geçmişleri onlara bağlıdır. Yeni kart eklenir ve gerekirse kablo koşulu yazılır. Bir kart ya da bağlantı eklendiğinde tuval şemayı kendiliğinden yeniden dizer, böylece yeni kart görünmeyen bir yere düşmez; yalnızca bir talimat ya da koşul değiştiyse kartlar yerinden oynamaz. Tuvalde elle yaptığınız her değişikliği Builder bir sonraki mesajda görür, çünkü ikisi aynı tuvali konuşur.

Akışı anlatmak yerine gösterebilirsiniz. Yazma kutusundaki ataç düğmesiyle bir şema görüntüsü ya da süreç belgesi eklersiniz; daha önce yüklediğiniz bir dosyayı "@" yazıp adıyla da işaret edebilirsiniz. Builder görseli görür ve belgenin yazısını okur, sonra gördüğü adımları tuvale çizer. Dosyayı okuyamayacağı bir durum olursa bunu söyler ve içeriği tahmin etmez.

Bilmeniz gerekenler şunlardır.

• Builder kaydetmez. Tuvali inceler, isterseniz elle düzeltir ve Kaydet'e siz basarsınız. Tuvalin "kontrol edilmeye değer" notları Builder'ın da önündedir.
• Sohbet akışa bağlıdır ve kalıcıdır. Kaydedince, sayfadan çıkıp dönünce ya da başka bir gün açınca konuşma yerinde durur ve o akış için Builder'la her zaman kaldığınız yerden konuşursunuz. Ekip arkadaşınız da aynı sohbeti görür. Yeni bir bağlamla başlamak için paneldeki Sohbeti temizle düğmesini kullanın, tuval değişmez.
• Kart olarak yalnız workspace'teki Orbi'de çalışan agent'lar kullanılır. Uygun agent yoksa Builder önce agent kurmanızı söyler, uydurmaz. Servis tetiği ancak bağlı bir servis varsa önerilir.
• Her Builder mesajı normal bir AI koşusudur ve krediden düşer.

#Sohbetten akış kurma

Tuvale dokunmadan da akış kurabilirsiniz. Sohbette Orbi'ye (ya da bir agent'a) ne istediğinizi anlatın. "Her pazartesi 09:00'da önce konu araştırılsın, sonra taslak yazılsın, editör beğenirse yayına hazır işaretlensin" gibi bir cümle yeter. Agent akışın üç parçasını bilmeden kurmaz.

• Tetik, yani ne zaman ya da hangi olayda başlayacağı (zamanlama, tek seferlik, Orbi'de bir olay, bağlı serviste bir olay, gelen webhook, bağlı bir cihazdan gelen haber).
• Adımlar, yani hangi agent'ın ne yapacağı. Birden çok rol anlattıysanız her rol ayrı bir kart olur ve agent'ı siz söylemediyseniz sorar ya da önerdiğini açıkça söyler.
• Bağlantılar, yani adımların sırası ve "editör onayladıysa" gibi koşullar.

Eksik kalan parçayı uydurmaz. Tek turda kısa sorular sorar (sıklık, hangi agent, sıralı mı paralel mi), sonra kurar. Karmaşık kurulumda önce şemayı çizip onay ister. Kurulan akış tuvalde aynen görünür ve oradan düzenlemeye devam edebilirsiniz. "Bu akışa bir adım ekle" dediğinizde mevcut kartlar korunur, yeni kart ve kablosu eklenir.

#Tipik senaryo

Her sabah 07:00 (Europe/Istanbul):

Sektör haberlerini ara, en önemlilerini özetle,
@collection.icerik_fikirleri koleksiyonuna dedup'lı ekle,
en iyi 3 fikir için ayrı task aç ve içerik yazarına ata.

Bu tek akış şunları yapar. Web araması yapar, özetler, yapılandırılmış veri yazar (tekrarları atlayarak), görev üretir ve atar. Sabah panoyu açtığınızda üç görev hazır bekler.

#Takvim

Takvim, Google Calendar benzeri birleşik bir görünümdür. Tek ekranda üç şeyi gösterir.

• Görevlerin bitiş tarihleri
• Akış koşuları
• Elle eklenen özel etkinlikler

#Görünümler

Sağ üstteki düğmelerden dört görünüm arasında geçiş yaparsınız.

Gün ve hafta görünümünde bugünün üstünde kırmızı bir çizgi durur ve içinde bulunduğunuz anı gösterir. Çizgi dakika başı kendini tazeler.

Bugün her görünümde ayrı bir zeminle işaretlidir ve gün numarası dolu bir daire içindedir. Sol üstteki Bugün düğmesi (ya da T tuşu) sizi her zaman bugüne geri getirir.

#Kalabalık bir gün

Ay görünümünde bir güne sığandan fazla öğe varsa, kutunun altında +3 daha gibi bir satır çıkar. Üstüne tıklayın ve o günün tamamı küçük bir panelde açılır. Panelden bir öğeye tıklayarak detayına gidebilir, Gün görünümü düğmesiyle günü saat ızgarasında açabilir ya da doğrudan yeni bir etkinlik ekleyebilirsiniz.

Kaç öğenin sığdığı pencere boyuna göre değişir, yani takvimi büyüttükçe kutuda daha fazlası görünür.

#Etkinlik ekleme ve taşıma

Etkinlik eklemenin üç yolu vardır.

• Sol üstteki Etkinlik ekle düğmesi (ya da N tuşu)
• Ay görünümünde bir günün üstüne gelince beliren + işareti, etkinlik o güne açılır
• Gün ve hafta görünümünde ızgaranın boş bir yerine tıklamak, etkinlik tıkladığınız saate açılır

Taşımak için sürükleyin. Bir etkinliği başka bir güne sürüklerseniz saati ve süresi korunur. Gün ya da hafta görünümünde ızgaranın başka bir saatine bırakırsanız saati de değişir (15 dakikalık adımlarla). Sürüklenebilen yalnızca sizin eklediğiniz etkinliklerdir. Görev termini görevin kendi özelliğidir (kartın çekmecesinden değiştirilir), akış koşusu ise akışın takvimdeki görüntüsüdür (akışın tetiğinden değiştirilir).

#Etkinliği kim ekledi

Bir etkinliğin üstüne tıkladığınızda açılan kartta, başlığın ve açıklamanın altında onu kimin eklediği yazar. Bir ekip arkadaşınız eklediyse adı, bir agent eklediyse adı ve ünvanı görünür. Kalabalık bir takvimde "bu toplantıyı kim koydu, kime soracağım" sorusu böylece kartın kendisinden cevaplanır.

Görev bitişlerinde ve akış koşularında bu satır yoktur: onlar takvime elle eklenmez, başka bir yerdeki kaydın takvimde görünen yüzüdür.

#Etkinliğin süresi

Bir etkinlik yalnızca bir başlangıç saati değil, bir aralıktır. Formda başlangıcın yanında bir Bitiş kutusu vardır ve yeni etkinlik bir saat sürecek şekilde açılır. Başka bir süre yazabilir ya da kutuyu boşaltıp bitişi hiç söylememeyi seçebilirsiniz.

Başlangıcı değiştirdiğinizde bitiş de aynı kadar kayar, çünkü bir toplantıyı iki saat sonraya almak onu kısaltmak anlamına gelmez.

Süre takvimde şu şekilde okunur.

• Gün ve hafta görünümünde kutunun boyu süre kadardır. Uzun bir toplantı ekranda uzun görünür ve öğleden sonranın dolu olup olmadığı bir bakışta anlaşılır.
• Süreyi değiştirmenin en kısa yolu kutunun alt kenarını aşağı ya da yukarı sürüklemektir (15 dakikalık adımlarla). Formu açmanız gerekmez.
• Ay görünümünde birden çok güne yayılan bir etkinlik, kapsadığı günlerin üstünden geçen tek bir şerit olarak çizilir. Şerit haftanın dışına taşıyorsa ucu kesik görünür ve bir sonraki haftada devam eder.
• Gün ve hafta görünümünde birden çok güne yayılan etkinlikler saat ızgarasının üstünde ayrı bir Gün boyu şeridinde durur ve ızgaranın içi tek güne sığan işler için kalır.
• Ajandada böyle bir etkinlik başladığı günde tek satır olarak görünür ve satırda başlangıç ile bitiş saati alt alta yazar.

Bir agent'a "salı 14:00'te iki saatlik tasarım toplantısı" ya da "pazartesiden çarşambaya eğitim" dediğinizde, bunu tek bir etkinlik olarak süresiyle birlikte yazar.

#Süzmek ve aramak

Sol taraftaki Filtreler üç tipi ayrı ayrı açıp kapatır ve her birinin yanında o aralıkta kaç tane olduğunu yazar. Akış koşuları varsayılan olarak kapalıdır, çünkü sık çalışan bir akış takvimi tek başına doldurabilir.

Kapsam kutusundan tüm workspace yerine tek bir panoya bakabilirsiniz.

Arama kutusu (ya da / tuşu) takvimin içini süzer. Yazdığınız kelimeyi başlığında ya da açıklamasında geçirmeyen öğeler görünümden çıkar. Kalabalık bir ayda tek bir toplantıyı bulmak için gün gün bakmanız gerekmez.

Sol alttaki mini takvim başka bir güne gitmenin en kısa yoludur ve altındaki renkli noktalar o gün ne olduğunu (etkinlik, görev ya da akış) söyler.

#Klavye

#Görev terminleri

Termini geçmiş ve hala tamamlanmamış görevler takvimde kırmızı görünür, yaklaşanlar sarıdır. Bir görev satırına tıklamak sizi sayfadan çıkarmaz, çünkü görev ekranın sağındaki kolonda açılır.

Saat dilimi. Zamanlar UTC saklanır ve sizin yerel saatinizde gösterilir. Ekibiniz farklı şehirlerdeyse herkes aynı anı kendi saatinde görür.

Agent'lar takvim etkinliği oluşturabilir, güncelleyebilir ve silebilir. Bunun için create_calendar_event, update_calendar_event, delete_calendar_event ve list_calendar_events araçlarını kullanırlar. Yani bir agent'a "bu araştırmayı bitirdikten sonra sunum için takvime bir blok koy" diyebilirsiniz.