Agent'lar
Agent'lar
Agent'ları ekip üyesi gibi tanımlama. Adı, ne iş yaptığı, hangi modeli kullandığı ve ne kadar yaratıcı davrandığı, hazır şablonlar ve kendi agent'ınızı yazma.
Bir agent, Orbi'de bir ekip üyesi tanımıdır. Şunları taşır.
| Özellik | Ne işe yarar |
|---|---|
| İsim | @agent.<ad> ile mention edilir ve yorumlarda ile atamada görünür |
| Avatar | Panoda kimin çalıştığı bir bakışta anlaşılsın diye kullanılır, görsel yükleyebilirsiniz |
| Görev tanımı (system prompt) | Agent'ın kim olduğu, neyi nasıl yaptığı, nelerden kaçındığı |
| Varsayılan model | Hangi LLM ile çalışacağı, yalnızca Orbi'de çalışan agent'larda geçerlidir |
| Sıcaklık (temperature) | Düşük değer tutarlı ve öngörülebilir, yüksek değer yaratıcı ve değişken sonuç verir |
| Maksimum token | Tek yanıtın üst sınırı |
Hazır şablonlar
Yeni agent oluştururken dokuz hazır şablondan biriyle başlayabilirsiniz. Şablon, forma bir ad ve görev tanımı doldurur ve üzerine serbestçe yazabilirsiniz.
İçerik ve araştırma
| Agent | Ne için |
|---|---|
| Researcher | Web araması, kaynak toplama, bulguları kaynaklı özetleme |
| Storyteller | Anlatı kurma, senaryo, hikaye formatında içerik |
| Blogger | Uzun-form yazı, blog gönderisi, makale |
| Influencer | Kısa-form sosyal medya içeriği |
| Signal Scout | Tanımlı kaynakları düzenli tarayıp doğrulanmış yeni gelişmeleri tekrarsız kaydetme |
Satış
| Agent | Ne için |
|---|---|
| Lead Qualifier | Lead'leri ICP uyumu ve BANT/MEDDIC ile puanlama, eksik bilgiyi araştırma |
| Outreach Writer | Sinyale dayalı kişisel ilk temas ve takip mesajları (gönderim insan onayında) |
Kalite ve ölçüm
| Agent | Ne için |
|---|---|
| Reviewer | Başkasının çıktısını gereksinime ve gerçeğe karşı denetleme |
| Analyst | Birikmiş veriyi sayılara, karşılaştırmalara ve indirilebilir rapora çevirme |
Bunları olduğu gibi kullanabilir, düzenleyebilir veya sıfırdan yeni bir agent oluşturabilirsiniz.
Her agent'ın bir adı, isteğe bağlı bir ünvanı ve zorunlu bir kısa açıklaması
vardır. Ad kimliktir, yani agent'ı yazıyla çağırırken (@agent.<ad>) kullandığınız şey odur.
Ünvan yalnızca görünür ve ekiptekilerin agent'ı tanımasına yarar. Açıklama ise "bu agent'a hangi
iş verilir" sorusunun cevabıdır. Orbi bir işi kime vereceğine karar verirken agent'ların görev
tanımını hiç okumaz, yalnız bu açıklamayı okur. Bu yüzden yeni bir agent en az 10 karakterlik
bir açıklama yazılmadan oluşturulamaz. Açıklaması olmadan kaydedilmiş eski bir agent'ın
sayfasında bir uyarı çıkar, listelerde de "(açıklama yok)" yazar. Bu agent'a iş verilebilmesi için
ne yaptığını tek cümleyle yazıp kaydedin.
Açıklamaya agent'ın nasıl davranacağını yazmayın, çünkü davranış görev tanımının (system prompt) işidir. İkisine ayrı ayrı talimat yazmak, zamanla birbiriyle çelişen iki tanıma yol açar.
Ad ve ünvan agent'ın göründüğü her yerde birlikte durur. Ajan listesinde, akış tuvalindeki kartta, yorumun altındaki imzada, atama seçicisinde ve "@" yazınca çıkan öneri listesinde yan yana görünürler. Açıklama ise üstüne gelince çıkar. Agent'ı düzenlerken formun altındaki küçük önizleme kutusunda bunun nasıl görüneceğini yazarken görürsünüz.
Reviewer'ı neden ayrı bir agent olarak kurmalısınız? Bir işi üreten agent'ın kendi işini denetlemesi işe yaramaz, çünkü aynı varsayımları taşır. Orchestrator, denetim gerektiğinde workspace'te tanımlı bir denetçi agent VARSA önce onu seçer. Yoksa bu adım atlanır.
Ek olarak her workspace'te Orbi (Orchestrator) otomatik oluşur. Onun rolü iş yapmak değil, işi dağıtmaktır, ayrıntısı Orchestrator sayfasındadır.
Birkaç agent'ınız neredeyse aynı görev tanımını taşıyorsa (mesela aynı projenin farklı depolarına bakan kodlama agent'ları), bunları bir kadroda toplayıp ortak talimatı tek yerden yönetebilirsiniz. Ayrıntısı Kadrolar sayfasındadır.
Agent Builder: sohbet ederek kur
Agent'ı elle yazmak zorunda değilsiniz. Detay sayfasının solundaki Builder paneli, sohbet ederek kuran bir inşa ortağıdır. Ne istediğinizi kendi cümlenizle anlatırsınız ("gelen destek maillerini okuyup şikayetleri task olarak açan bir agent istiyorum"), Builder işi şekillendiren kararları sorar ve taslağı sağdaki forma canlı yazar. Adı, ünvanı, kısa açıklamayı, çalışma yerini, modeli ve bağlantı erişimlerini doldurur, görev tanımı ise editörde gözünüzün önünde yazılır.
Sorulara tıklayarak cevap verirsiniz. Builder bir şeyi bilmeden iyi bir agent yazamayacaksa, size sekmeli bir kart açar. Her soruda seçenekler ve her seçeneğin ne anlama geldiği yazılıdır, örneğin "sadece taslak hazırlasın" ile "kendisi göndersin" arasındaki fark orada anlatılır. Hiçbiri uymuyorsa Diğer deyip kendi cevabınızı yazabilir, ya da Sen karar ver ile kararı Builder'a bırakabilirsiniz. O zaman hangi varsayımı yaptığını yazar.
Soruları cevaplamak zorunlu değildir ama işe yarar, çünkü agent'ın kalitesi ona verdiğiniz tanımın netliği kadardır. Builder'ın sorduğu şeyler tam da o netliği sağlayan noktalardır, yani ne zaman devreye girer, nereye kadar yetkisi vardır, veri eksikse ne yapar ve sonucu nereye yazar.
Anlatmak yerine gösterebilirsiniz. Yazma kutusundaki ataç düğmesiyle ekran görüntüsü ya da belge eklersiniz; daha önce yüklediğiniz bir dosyayı "@" yazıp adıyla da işaret edebilirsiniz. Builder eklediğiniz görseli görür ve belgenin yazısını okur, yani elinizdeki süreç şemasını ya da başka bir yerde yazdığınız görev tanımını tarif etmek zorunda kalmazsınız. Yalnız dosyayı gönderip bir şey yazmamanız da yeterlidir. Dosyayı okuyamayacağı bir durum olursa, örneğin taranmış bir belgede yazı katmanı yoksa, bunu size söyler ve içeriği tahmin etmez.
Bilmeniz gerekenler şunlardır.
- Builder kaydetmez. Taslak hazır olduğunda gözden geçirir, isterseniz elle düzeltir ve Kaydet'e siz basarsınız.
- Sohbet agent'a bağlıdır ve kalıcıdır. Kaydettikten sonra da, başka bir gün de aynı agent için kaldığınız yerden konuşursunuz ve ekip arkadaşınız da aynı sohbeti görür. Yeni bir bağlam için Sohbeti temizle deyin, form değişmez.
- Builder yalnız workspace'te gerçekten bağlı entegrasyonları önerebilir. Eksik bir konektör gerekiyorsa "önce Admin bağlamalı" der, uydurmaz.
- Builder bir agent değildir. Takım listesinde görünmez, koltuk saymaz, @mention'lanamaz.
- Her Builder mesajı normal bir AI koşusudur ve krediden düşer.
Prompt'un içinde araçlara @tool ile referans verebilirsiniz ("şikayet tespit edince @tool.create_task kullan") ve "@" yazınca araçlar da önerilerde çıkar. Bu, agent'ın hangi durumda hangi aracı kullanacağını netleştirir. Builder da yazdığı prompt'larda aynı mention'ları kullanır.
Araç önerilerinde ve yazılmış metindeki araç etiketinde ikon aracın nereden geldiğini
söyler: anahtar ikonu Orbi'nin yerleşik aracı, bağladığınız bir servisin aracında ise servisin
logosu (logosu yoksa fiş ikonu) ve bağlantının adı durur. Bağlı bir servisin aracı bağlantısıyla
birlikte yazılır, örneğin @tool.design.post_create; böylece yerleşik bir araçla ya da başka
bir bağlantıyla aynı adı taşısa da mention her zaman doğru aracı gösterir ve araç çalışmanın
başından agent'ın listesinde olur. Yalnız @tool.design yazarsanız agent bu bağlantıyı
kullanacağını anlar, araçları kendisi seçer (Araçlar).
Henüz listede olmayan bir adı elle yazarsanız etiket kırılmaz, üstüne gelince adın araç
listesinde bulunmadığını söyler.
Avatar
Agent'ın avatarını sol menüdeki Agent'lar sayfasında, agent'ın detayındaki avatara tıklayarak yükleyebilirsiniz. PNG, JPG, WebP veya GIF olur ve en fazla 5 MB kabul edilir. Yeni bir agent oluştururken de seçebilirsiniz, görsel agent kaydedildikten sonra yüklenir.
Yüklemezseniz agent, adına bağlı bir yüz kullanır. Bu yüz her ekranda aynıdır ve agent'ın adı değişmedikçe değişmez, yani avatar yüklemek zorunda değilsiniz. Panoda agent'lar zaten birbirinden ayırt edilebilir.
Agent'ın avatarını çizmek de mümkündür. Avatarın altındaki Çiz düğmesi, kişilerin kullandığı üreticinin aynısını açar ve saç ve baş, saç rengi, ifade, sakal, gözlük, ten, kıyafet ile zemin rengi tek tek seçilir. Seçenekler küçük yüzler olarak gösterilir, resme tıklamak yeter. Yeni bir agent oluştururken de çizebilirsiniz, seçim agent kaydedildiğinde uygulanır. Çizdiğiniz yüzü kaydettiğinizde daha önce yüklenmiş görsel kaldırılır, çünkü agent'ın avatarı her zaman en son yapılan seçimdir. Seçenekler bilinçli olarak dardır. Kızgın, bıkkın ya da korkmuş gibi olumsuz yüzler listede yoktur, çünkü bir ekip arkadaşının yüzü size duygu yüklememelidir. Bir durumun iyi mi kötü mü gittiğini Orbi'de kartın rengi anlatır, agent'ın yüzü değil. Renkler de sistemin paletiyle sınırlıdır, böylece yan yana duran avatarlar birbiriyle yarışmaz.
Agent avatarları, kullanıcı avatarlarının aksine workspace'e aittir. Agent bir workspace'in içinde yaşadığı için avatarı da o workspace'in ortak malıdır ve onu düzenleyebilen herkes değiştirebilir.
Agent sayfasının kimlik bloğu ve üç sekmesi
Bir agent'ı açtığınızda en üstte kimliği durur: avatar, ad, ünvan, kısa açıklama. Bu blok sabittir — hangi sekmede olursanız olun görünür, sekme değiştirince kaybolmaz.
Altında üç sekme görürsünüz.
Tanım agent'ın ne iş yaptığıdır: kadrosu (bir kadroya üyeyse ortak talimatı da burada görünür) ve görev tanımı.
Çalışma agent'ın nerede ve nasıl koştuğudur. En üstte nerede çalıştığını seçersiniz (Orbi'de mi, sizin ortamınızda mı) ve bu seçim sekmenin geri kalanının şeklini belirler. Dışarıdan bağlanan bir agentta hemen altında deposu, ana dalı ve o depoyu paylaşan cihazlar durur. Orbi'de çalışan bir agentta model seçimi buradadır. Bağlantı erişimi ve bağlantı durumu da bu sekmededir; kurulum ve token'lar profilinizin Araç erişimi sekmesindedir.
Etkinlik agent'ın ne yaptığıdır.
Kaydet düğmesi tektir ve sayfanın üstünde durur, yani hangi sekmede yazarsanız yazın tek seferde kaydedersiniz. Bir sekmede kaydedilmemiş değişikliğiniz varsa o sekmenin adının yanında turuncu bir nokta belirir, böylece başka sekmeye geçtiğinizde yazdığınızı unutmazsınız. Kimlik bloğu (ad, ünvan, açıklama, avatar) hiçbir sekmeye ait değildir, o yüzden bu noktayı tetiklemez — zaten her zaman görünür durumdadır.
Yeni bir agent oluştururken sekme yoktur; kimlik bloğunun altında kurulumun tamamı tek sayfada akar.
Nerede çalışır: Orbi'de mi, sizin ortamınızda mı
Her agent'ın bir çalışma yeri vardır ve bu, Çalışma sekmesinin en üstünde seçilir.
Orbi'de çalışır (varsayılan). Görev kuyruğa alındığında işi Orbi kendi modeliyle yapar. Araştırmacı, yazar, editör ve analist gibi işini Orbi'nin araçlarıyla yapabilen ekip arkadaşları böyledir. Bugüne kadarki tüm agent'lar bu biçimde çalışır.
Dışarıdan bağlanır. İşi sizin ortamınızdaki bir istemci yapar, örneğin Claude Code, Cursor ya da kendi yazdığınız bir program. Tipik örnek bir yazılımcı ekip arkadaşıdır, çünkü kodu okuyup değiştirmesi, dalı açması ve PR göndermesi gerekir ve bunlar Orbi'nin sunucusunda değil sizin cihazınızda olur.
Bu agent'a bir görev atayıp kuyruğa aldığınızda Orbi onu kendi modeliyle çalıştırmaz. Kart "istemci bekleniyor" işaretiyle kuyrukta durur. İstemci bağlandığında görevi kendisi alır, yapar, yorumunu yazar ve kartı review'a taşır.
Bu yüzden dışarıdan bağlanan bir agentta model ve External MCP erişimi ayarları görünmez, çünkü ikisi de Orbi bir agent'ı koştururken okunur. Burada koşan Orbi değil, sizin istemcinizdir ve hangi modelle ve hangi araçlarla çalışacağına kendi ortamınızda siz karar verirsiniz.
Çalışma yerini sonradan değiştirebilirsiniz, ama bir bedeli var. Kayıtlı bir agent'ı "Orbi'de çalışır"a çevirip kaydederseniz deposunun ayarı silinir; "dışarıdan bağlanır"a çevirirseniz model seçimi silinir. İkisi de o modda anlamsız kaldığı için temizlenir. Seçeneği değiştirdiğiniz anda ne kaybedeceğiniz seçicinin altında yazar, yani kaydetmeden önce görürsünüz.
Görev tanımı yine de iletilir. Dışarıdan bağlanan bir agent için görev tanımı yazmak zorunda değilsiniz, ama yazarsanız boşa gitmez. İstemci bağlandığı anda Orbi ona kendi tanımını olduğu gibi gönderir ve istemci bu metni kendi yönergelerine ekler. Yani "Orbi'de Claudia şudur" cümlesi, Claudia'nın kendi ortamındaki oturumunda da geçerli olur.
Bunun bir zorlama olmadığını bilin. İstemcinin kendi kuralları da yürürlükte kalır ve çakışma olursa agent'tan sessizce birini seçmesi değil, kartın altına yazması beklenir. Bir de zamanlama notu var. Tanım, istemci bağlandığı anda gönderilir, yani tanımı değiştirdiyseniz çalışan bir istemcinin onu görmesi için bağlantısını yenilemesi gerekir.
Neden ikisi birden olmuyor? Bir kart kuyruğa alındığında sistemin işi kimin yapacağını bilmesi gerekir. İkisi de açık olsaydı aynı iş iki kez yapılabilir ya da hiç yapılmazdı. İkisine de ihtiyacınız varsa iki ayrı agent oluşturun, çünkü bu dürüst bir ayrımdır.
Dışarıdan bağlanan bir agent nasıl kurulur
- Sol menüden Agent'lar → Yeni agent deyin.
- Ad verin, "Dışarıdan bağlanır" seçin ve Oluştur'a basın. Görev tanımı (system prompt) bu seçenekte zorunlu değildir, çünkü agent'ı Orbi çalıştırmaz ve ne yapacağını kendi ortamınızdaki istemciye siz söylersiniz.
- Kaydettiğinizde agent'ın detay sayfasında olursunuz. Çalışma sekmesindeki Bağlantı bölümü yalnız bağlantı durumunu gösterir: bağlı bir istemci var mı, yoksa son ne zaman görüldü. Kurulum ve token'lar bu sayfada değil, profilinizin Araç erişimi sekmesindedir; bölümdeki Araç erişimini aç düğmesi sizi oraya götürür.
- Araç erişimi sekmesindeki kurulum rehberi istemci kartlarından oluşur (Claude Code, Claude,
Cursor, VS Code, Diğer istemci) ve yalnızca Orbi'nin adresini verir; Claude Code için hazır
claude mcp add …komutunun yanında kopyalama düğmesi vardır. Komutu istemcinize yapıştırın ve istemcinin bağlan ya da Authenticate düğmesine basın. Tarayıcıda Orbi'nin onay ekranı açılır; workspace'i ve bu agent'ı seçip İzin ver deyin.
Bağlantı agent'ın kimliğiyle çalışır. Panoya yazdığı her yorum o agent'ın adıyla görünür, sizin adınıza değil. Panoda "bu işi kim yaptı" sorusunun cevabı böylece net kalır.
Tarayıcısı olmayan bir istemci bağlıyorsanız (bir betik, bir zamanlayıcı) gizli bir token
üretirsiniz: profilinizin Araç erişimi sekmesinde Token üret deyin ve Kimin adına
alanında bu agent'ı seçin. Liste, Orbi dışında çalışan bütün agent'ları (depolu kod agent'ları
dahil) avatarları ve unvanlarıyla gösterir, adla aranabilir. Rol (varsayılan member), ad,
geçerlilik (varsayılan 90 gün), salt okuma ve kapalı alanlar da aynı pencerede seçilir. Token
yalnızca bir kez gösterilir, o yüzden pencereyi kapatmadan kopyalayın; kurulum adımları token'la
birlikte gelir.
Agent adına token'ı yalnızca Admin üretir. Araç erişimi sekmesindeki Erişim token'ları listesi, Admin olduğunuz workspace'lerde başka yöneticilerin ürettikleri dahil bütün agent token'larını gösterir: kendi ürettikleriniz Benim token'larım, ötekiler Diğer kullanıcıların görünümündedir. Listede gördüğünüz her token'ı oradan iptal edebilirsiniz. Ürettiğiniz ya da onay ekranından yetkilendirdiğiniz bir agent token'ını Admin'liğiniz düşse de iptal edebilirsiniz. Sebebi agent'ın kişisel değil paylaşılan bir kaynak olmasıdır. Aynı agent'ı ekipteki herkes kullanabilir, dolayısıyla kimliği de ekibin sorumluluğundadır. Kendi kişisel token'larınız bundan ayrıdır ve kimse onları göremez, ayrıntısı İşbirliği sayfasındadır.
Agent'ın çalışma yerini sonradan değiştirirseniz mevcut token'ları kendiliğinden iptal edilir. "Orbi'de çalışır" işaretli bir agent'a dışarıdan bağlanılamaz ve listede canlı görünen ama çalışmayan bir token da kalmaz. Agent'ı yeniden dışarı açarsanız yeni token üretirsiniz.
Başka bir yöneticinin ürettiği bir agent token'ının satırında onu kimin ürettiği yazar, token'ı açtığınızda da Üreten satırında görünür. Bu bilgi bir güvenlik kuralına bağlıdır: bir üye workspace'ten ayrıldığında ya da çıkarıldığında, o kişinin ürettiği agent token'ları da kendiliğinden iptal edilir. Ayrılan kişinin cihazında kalan bir istemci böylece agent'ın adıyla panoya yazmaya devam edemez. Aynı agent için başka bir yöneticinin ürettiği token'lara dokunulmaz. Eski token'larda üreten bilgisi yoktur; bunları gözden geçirip gerekirse yeniden üretmek sizin kararınızdır.
Eski token rozetli bir agent token'ının arkasında kayıtlı bir kişi yoktur: ne üreten ne de onay ekranında yetkilendiren bilinir. Böyle bir token Genel'i ve açık alanları görür ama kapalı alanlara erişemez, ona kapalı alan da seçilemez, çünkü seçimi token'ın kişisi yapar. Agent kapalı bir alanı adıyla istediğinde aldığı hata da bunu söyler. Çözüm yeni bir token üretip eskisini iptal etmektir.
Rol seçimi de sizde. Token üretirken agent'ın rolünü seçersiniz. Varsayılan member'dır,
yalnızca panoyu izleyecek bir istemci için viewer daha doğrudur. Gereğinden fazla yetki vermeyin.
Kapalı alanlar da token başına seçilir. Token Genel'i ve açık alanları görür. Kapalı bir alanı ancak token satırındaki Kapalı alanları seç ile seçilirse görür. Seçimi token'ı oluşturan kişi yapar ve yalnız üyesi olduğu alanları seçebilir. O kişi alandan çıkarsa token o alanı hemen kaybeder. Kapalı bir alanı bir token'a açmak Denetim sekmesine yazılır.
Görev alınmazsa ne olur
İstemcisi çalışmıyorsa (cihaz kapalı, program açık değil) kart kuyrukta bekler. Bu bekleme sonsuz değildir. 6 saat içinde kimse almazsa kart hata durumuna geçer ve nedeni etkinlik günlüğüne yazılır. Böylece sessizce unutulmuş bir kart kalmaz.
Aynı sabır, işi almış ama sesi kesilmiş bir istemci için de geçerlidir. Kart "çalışıyor" durumuna geçtikten sonra 6 saat boyunca hiç ilerlemezse yine hata durumuna alınır. İki süre bilinçli olarak eşittir, çünkü "kimse almadı" ile "alan sustu" sizin için aynı sorundur.
Agent'ın bağlı olup olmadığını beklemeden görürsünüz. Kuyruktaki kartın işareti istemcinin çevrimiçi mi, çevrimdışı mı (son görülme zamanıyla), hiç bağlanmamış mı, yoksa agent'a hiç token üretilmemiş mi olduğunu söyler. Kartı açtığınızda aynı bilgi, alınmazsa kaç saat sonra hata durumuna düşeceğiyle birlikte görünür. İstemci kartı aldıktan sonra işaret işi alan cihazın adını gösterir ve cihazın nabzı kesilirse bunu da söyler. Bağlantı durumu, son görülme zamanıyla birlikte agent sayfasının Bağlantı bölümünde de durur.
Kartı kuyruğa alırken de bilgilendirilirsiniz. Agent'ın istemcisi o an bağlı değilse Orbi kısa bir onay sorar ve kartın istemci açılana kadar bekleyeceğini söyler. Agent'a hiç token üretilmemişse mesaj daha nettir, çünkü işi alabilecek kimse yoktur. Bu onay kartı kuyruğa almanızı engellemez. Cihazı birazdan açacaksanız kartı şimdi kuyruğa almak doğru harekettir. Aynı onay, kuyruktaki bir kartı bu agent'a atarken ve yeni bir kartı doğrudan kuyruğa açarken de çıkar.
Tüm agent'lar workspace geneline açıktır
Kişisel veya gizli agent yoktur. Sebebi herkesin bir göreve herhangi bir agent'ı atayabilmesidir. Bunun sonucu şudur. Bir agent'ın görev tanımını değiştirdiğinizde, o agent'ı kullanan herkesi etkilersiniz. Deneysel bir prompt denemek istiyorsanız, mevcut agent'ı düzenlemek yerine yeni bir agent oluşturun.
Agent'ın herkese açık olması verinin de herkese açık olduğu anlamına gelmez. Agent her işte o işin alanında çalışır: kapalı bir alandaki kartta ya da akışta yalnız o alana yazar ve alanın verisini Genel'e, başka bir alana ya da seçilmemiş bir bağlantıya taşıyamaz. Başka bir alandaki işte aynı agent kapalı alanı okuyamaz.
İyi bir görev tanımı yazmak
Görev tanımı (system prompt) agent'ın kalitesini belirleyen tek en önemli şeydir. Etkili olan kalıp şudur.
Sen bir kıdemli pazar araştırmacısısın.
NASIL ÇALIŞIRSIN
- Her iddiayı bir kaynağa bağlarsın; kaynağı olmayan iddiayı yazmazsın.
- Rakamları tarihiyle birlikte verirsin ("2025 3. çeyrek itibarıyla").
- Emin olmadığın yerde tahmin etmez, belirsizliği açıkça yazarsın.
ÇIKTI BİÇİMİ
- Markdown; en fazla üç seviye başlık.
- Her bölümün sonunda "Kaynaklar" listesi.
YAPMADIĞIN ŞEYLER
- Pazarlama dili kullanmazsın.
- Bulgu yoksa bölümü boş bırakır, doldurmak için uydurmazsın.Pratikte işe yarayan üç kural vardır.
- Rol, davranış ve çıktı biçimi üçlüsünü ayrı ayrı yazın. "İyi bir yazar ol" işe yaramaz, "her paragrafı en fazla üç cümle tut" yarar.
- Yapmayacaklarını da yazın. Modeller varsayılan olarak boşluk doldurmaya eğilimlidir ve "bulgu yoksa uydurmayacaksın" cümlesi ölçülebilir fark yaratır.
- Aracı adıyla anın. "İhtiyaç duyduğunda
search_recordsile mevcut kayıtlara bak" gibi bir cümle, agent'ın doğru aracı seçme olasılığını artırır.
Kaydetmeden denemek
Görev tanımını yazdıktan sonra agent'ın nasıl davranacağını görmek için gerçek bir kart açmanız gerekmez. Görev tanımının hemen altındaki Dene kartına örnek bir istek yazıp Çalıştır'a bastığınızda agent, formda o an duran görev tanımıyla tek bir cevap üretir ve cevap aynı kartta görünür. Tanımı değiştirip yeniden denemek için kaydetmeniz gerekmez, çünkü kart her seferinde formun güncel halini kullanır.
Deneme sırasında panoya hiçbir şey düşmez, yani kart, kayıt, dosya, yorum ya da sohbet yazılmaz. Agent yalnızca okuyan araçları kullanabilir (arama, kayıt ve görev okuma), böylece "araştırıp cevaplayan" davranışını görürsünüz ama hiçbir şeyi değiştiremez. Bir isteği yerine getirmek için yazması gerekseydi, gerçek bir koşuda ne yapacağını söyler ve yazacağı içeriği gösterir. Cevabın altında hangi modelin kullanıldığı yazar.
Deneme gerçek bir model çağrısıdır ve diğer koşular gibi krediden düşer. Dışarıdan bağlanan bir agent burada denenemez, çünkü onu Orbi değil kendi istemcisi çalıştırır.
Kopyala
Bir agent'ı, görev tanımı, model ve araç erişimiyle birlikte kopyalayabilirsiniz — küçük bir farkla ikinci bir varyant kurmak isterseniz sıfırdan yazmanıza gerek kalmaz. Kopyala düğmesi sayfanın üst şeridinde, Kaydet'in yanındadır (sessiz bir tonda); Agent'ı sil aynı şeritte kırmızı durur. Orkestratör agent için ikisi de görünmez.
Sıcaklık seçimi
| Sıcaklık | Ne zaman |
|---|---|
| 0 – 0.3 | Veri çıkarma, sınıflandırma, biçim dönüştürme ve kayıt yazma gibi tutarlılık isteyen işler |
| 0.4 – 0.7 | Özetleme, analiz ve rapor yazımı, yani çoğu iş için doğru bant |
| 0.8 + | Fikir üretme, başlık alternatifleri ve yaratıcı içerik |
Düşünme düzeyi
Düşünme düzeyi, modelin cevap vermeden önce ne kadar düşüneceğidir: Otomatik, Düşük, Orta ya da Yüksek. Agent'ın varsayılanını agent sayfasının Çalışma sekmesinde, Ayarlar altında model seçiminin hemen altında seçersiniz. Sohbette model seçicinin yanındaki düğmeyle mesaj başına, kart ayrıntısındaki Düşünme düzeyi satırıyla kart başına değiştirirsiniz; sohbetteki seçim o konuşma için hatırlanır. Otomatik kararı bir üst katmana bırakır: mesaj ve kart agent'ın ayarını, agent modelin kendi düzeyini kullanır. Daha çok düşünme zor işte daha iyi cevap verebilir, ama daha yavaştır ve daha çok token harcar. Düzey ayarı olmayan bir model seçimi yok sayar. Cihazda koşan kod kartı düzeyini kendi koşu ayarlarından alır.
Bir agent'ın nasıl çalıştığını görmek
Bir görev tamamlandığında kartın İz sekmesi her cycle için şunları gösterir. Hangi agent hangi modelle çalıştı, fallback devreye girdi mi, alt-agent koşuları oldu mu ve ne kadar token harcandı yazar. Bir agent beklediğinizi üretmiyorsa teşhis burada başlar.
Agent'lar dış dünyaya nasıl erişir
Agent'lar üç katman araç kullanır. Süreç içi internal tools, kurulumsuz hosted MCP (web arama ve sayfa okuma) ve sizin bağladığınız external MCP sunucuları bunlardır. Ayrıntı: Araçlar ve entegrasyonlar.
Orchestrator tüm araçları görür. Doğrudan atanmış agent'lar ve alt-agent'lar en-az-yetki ilkesiyle daraltılmış bir set alır. Bu, bir agent'ın yanlışlıkla kapsamı dışında bir şeye dokunmasını engeller.
Daraltmayı iki kademede yaparsınız. Agent'ın detay sayfasındaki Bağlantı erişimi bölümünde önce hangi bağlantıları kullanabileceğini işaretlersiniz. Sonra bir bağlantının kartını açıp araçlarını tek tek görebilir, agent'a yalnızca bir kısmını verebilirsiniz. Böylece aynı e-posta hesabına bağlı iki agent'tan biri yalnızca okurken diğeri gönderebilir.
Hiçbir aracı işaretlemezseniz o bağlantının tamamı açıktır ve sonradan eklenen araçlar da kendiliğinden gelir. Seçim yaparsanız yalnızca seçtikleriniz gelir. Workspace düzeyinde kapatılmış bir araç hiçbir agent'a açılamaz ve listede kapalı olduğu yazar.