Birlikte çalışan agent'lar

Bir ekip, müşteri beklerken yanıt verir: ana agent uzmanlarına sorar ve tek bir yanıt yazar. Gerçek iş çoğu zaman tersine işler. Bir agent bir şeyi fark eder, diğerleri ona göre harekete geçer, riskli adımı bir kişi onaylar ve sonucu biri sonra kontrol eder; ortada hiç müşteri mesajı yoktur.

Bu sayfa bunu mümkün kılan parçaları anlatır:

• Bir agent'ın yayınladığı olaylar, örneğin stock_low.
• Abonelikler: başka bir agent'ın, o olayla başlayan bir otomasyonu.
• Otomasyon görevlerindeki ekip: karar veren agent uzmanlarına sorar.
• Akışlar: zincirdeki her çalıştırma birbirine bağlanır, sınırları vardır ve tek bir sayfada görünür.

Örnek: Stok agent'ı her 15 dakikada stoğu kontrol eder. Fesleğen azalınca stock_low yayınlar. Ana agent bunu duyar, Satış ve Menü agent'larına ne yapılacağını sorar ve bir kampanya önerir. Bir yönetici onaylar, Menü agent'ı uygular. Hepsi tek bir akıştır.

Copilot kursun

Zinciri ana agent'ın Copilot'una tek cümleyle anlatın ("stok azalınca satış ve menü bir kampanya önersin, onaylamam için bana sorsun"). Agent'ları, olayı ve otomasyonları oluşturur ve siz bir şeyi açmadan önce tüm zinciri test eder. Bkz. Copilot ile çalışmak.

Agent'ın yayınladığı olaylar

Olay, bir agent'ın çalışma alanındaki diğer agent'lara küçük bir veriyle bildirdiği şeydir. Agent'ı açın ve kenar çubuğunda Olaylar'a tıklayarak ekleyin:

Ayar	Ne	Sınır
Anahtar	Olayın adı, örneğin stock_low.	Küçük harf, rakam ve _, harfle başlar, en fazla 50 karakter. Agent içinde benzersiz.
Ne anlama geldiği ve ne zaman yayınlandığı	İnsanlar ve abone olan her agent'ın Copilot'u okur.	Zorunlu, en fazla 500 karakter
Alanlar	Verinin biçimi. Kayıtlar ile aynı alan türleri (metin, sayı, para, tarih, seçim vb.), referans ve dosya hariç. Her alanın bir anahtarı, türü, açıklaması ve Zorunlu seçeneği vardır.	En fazla 20 alan
Aynı uyarıyı yalnızca bir kez yayınla	Tekrar önleme penceresi.	1 ile 168 saat, varsayılan 24

Bir agent'ın en fazla 20 olayı olabilir. Olaylar agent'ın taslağının parçasıdır; yani araçlar gibi sürümlenir ve yayınlanır. Diğer agent'lar yalnızca yayınlanmış olayları görür: agent'ı yayınlayana kadar olay Taslak görünür ve sayfa Diğer ajanların abone olabilmesi için ajanı yayınlayın. der.

Her olay kartı ayrıca Yayınlayan (agent'ın publish_ aracı ve onu yayınlayan fonksiyonlar) ve Aboneler (dinleyen otomasyonlar; durmuş olanın yanında duraklatıldı yazar) gösterir.

Yayınlama

İki yolu vardır.

• Bir model çalışmasından. Bir konuşmada, otomasyon görevinde ya da ekip çağrısında agent her olay için publish_<anahtar> adında bir araç alır (örneğin publish_stock_low). Model alanları doldurur; olaya göre kontrol edilir ve uymayan bir veri yayınlanmaz.

• Kodla, model olmadan. Bir otomasyonun kontrolü ya da eylemi olarak çalışan bir Fonksiyon şunu çağırır:

  await ctx.events.publish('stock_low', { product: 'Fesleğen', remaining: 3, level: 'critical' }, { dedupeKey: 'feslegen-2026-11-07' });

  Model çalışmadığı için 15 dakikada bir kontrol, bir şey bulana kadar neredeyse hiçbir şeye mal olmaz. Bir çalışma en fazla 10 olay yayınlayabilir.

Bir veri en fazla 8 KB'tır. Bir konuşma çalışması yayınladığında müşterinin kişisel verileri, ekip özetlerinde olduğu gibi yer tutucu olarak kalır.

Tekrar önleme

Uyarılar sık geri gelir. Olaya bir tekrar anahtarı (dedupeKey) verin, örneğin ürün ve gün. Aynı agent ve olaydan gelen aynı tekrar anahtarı, olayın penceresi içinde yeniden yayınlanmak yerine düşürülür ve Tekrar (yayınlanmadı) olarak kaydedilir. Tekrar anahtarı yoksa hiçbir şey tekrar sayılmaz. Tekrar anahtarı en fazla 200 karakterdir.

Testler aboneye ulaşmaz

Deneme çalıştırmaları ve test konuşmaları gerçek olay yayınlamaz. Olay çalıştırmada ve akışta Simüle edildi ("yayınlanacaktı") görünür ve hiçbir gerçek abone başlamaz. Yayınlanan bir olayı yan etki olmadan zincir boyunca izlemek için Akışı test edin bölümüne bakın.

Başka bir agent'ın olayına abone olun

Bir otomasyon başka bir agent'ın olayıyla başlayabilir.

1. Karar veren agent'ın Otomasyonlar sayfasında bir otomasyon oluşturun ya da açın.
2. Ne zaman altında Peki olayı'nı, sonra Başka bir ajanın olayı'nı seçin.
3. Ajan'ı, sonra Olay'ı seçin. Yalnızca yayınlanmış olaylar listelenir. Hiç yoksa Henüz hiçbir ajan olay yayınlamıyor. Ajanın Olaylar bölümünde bir olay ekleyip yayınlayın. yazar.
4. İsteğe bağlı olarak olayın verisine kurallar ekleyin: otomasyonun çalışması için hepsi geçerli olmalıdır, örneğin level critical'a eşit ya da remaining 10'dan küçük.

Tetikleyiciden sonraki her şey (kontrol, devam koşulu, eylem, görev, bildirim, sınırlar) Otomasyonlar sayfasındaki gibi çalışır. Agent'ın Olaylar sayfası da bu agent'ı abone yapabileceğiniz Diğer ajanların olaylarını listeler.

Kontrol ve eylem fonksiyonu olayı ctx.trigger.payload içinde alır:

Başka bir agent'ın olayı

{
  "from": { "id": "6720…", "name": "Stok" },
  "key": "stock_low",
  "data": { "product": "Fesleğen", "remaining": 3, "level": "critical" },
  "flowId": "6721…"
}

Görev aynı verinin kısa, boyutu sınırlı bir özetini alır. Bu şekilde başlayan çalışma, Çalışmalar sekmesinde Ajan olayı: stock_low olarak etiketlenir.

Notlar:

• Yalnızca aynı çalışma alanındaki agent'lar abone olabilir. Bir agent kendi olaylarına da abone olabilir.
• Her abone bağımsız çalışır. Teslimat en az bir kez yapılır.
• Testlerden gelen olaylar gerçek bir aboneyi hiç başlatmaz.
• Kaynak ortadan kalkarsa abone kendini şu nedenle duraklatır: "Source event no longer exists: the agent that published it removed it or was deleted. Pick another event, then resume." Bu, kaynak agent olayı kaldırdığında ya da silindiğinde olur.

Otomasyon görevinde ekip

Bir otomasyonun görevi, müşteri yanıtı gibi, agent'ın ekibine sorabilir. İzinli eylemler altına ekibin ask_<ad> araçlarını ekleyin. Her biri üyenin adıyla listelenir ("Satış ajanına sorar").

• ask_ araçları yazan eylem sayılmaz; bu yüzden eklemek için yazma onayı gerekmez. Görevin olay yayınlamak için kullanabileceği agent'ın kendi publish_<anahtar> araçları için de aynısı geçerlidir.
• Üyenin agent'ın ekibinde ve yayınlanmış olması gerekir; açık bir otomasyon için araç yayınlanmış sürümde de bulunmalıdır.
• Üyeler vekil modunda çalışır: hiçbir kanala ya da müşteriye yazmaz. Mesajı yalnızca otomasyonun kendi Bildir ayarı gönderir, o da yalnızca kendi agent'ının kanallarından.
• Çağrıları çalışmanın Ekip çağrıları'dır; otomasyon çalışmasına bağlıdır ve üyenin Inbox → Ekip çağrıları sekmesinde görünür. Agent ekipleri kuralları, üyelerin yayınlanmış olması dahil, geçerlidir.

Kararı ve onayları ana agent'a, işin yapılmasını uzmanlara koyun.

Akışlar

Akış, tek bir iş zinciridir. Peki, tek bir başlangıç noktasının neden olduğu her çalıştırmayı birbirine bağlar; böylece hikâyenin tamamını tek yerde okursunuz.

Akış bir başlangıçla başlar: bir müşteri mesajı, bir zamanlama, bir webhook isteği, Şimdi çalıştır ya da bir Peki olayı. Başlangıç bir akış kimliği oluşturur ve onun neden olduğu her şey aynı akışa katılır:

• otomasyon çalıştırmaları ve yaptıkları ekip çağrıları,
• yayınlanan olaylar,
• yazılan kayıtlar,
• onay istekleri ve bir onay kararının başlattığı çalıştırmalar (approval.decided akışı sürdürür).

Adım, başlangıçtan itibaren sayılan, bir olay ya da onay boyunca atılan tek adımdır. Ekip çağrıları adım değil derinliktir. Bir akışın durumu Çalışıyor, Onay bekliyor, Tamamlandı ya da Durduruldu'dur.

Sınırlar

Bir zincirin başıboş koşmaması için her akışın sınırları vardır. Bir sınırı aşacak çalıştırma başlatılmaz: Atlandı — akış sınırı olarak kaydedilir ve akış nedeniyle birlikte Durduruldu olur.

Sınır	Varsayılan	İzin verilen aralık
Adım	6	1 ile 20
Akış başına çalıştırma	30	1 ile 500
Akış başına kredi	500 kredi	1 ile 100.000
Akış başına saat (onay beklemek sayılır)	24	1 ile 168

Yöneticiler bunları Ayarlar → Çalışma alanı → Akış sınırları altında değiştirebilir. Krediler her zamanki gibi ücretlendirilir: her çalıştırma kendi maliyetini öder, akış yalnızca toplar.

Döngü koruması

Bir otomasyon, kendisinin neden olduğu bir olayla, doğrudan ya da başka çalıştırmalar üzerinden, asla başlatılmaz. Peki her olayın arkasındaki otomasyon zincirini taşır; başlayacak otomasyon bu zincirdeyse çalışma Atlandı — döngü olarak kaydedilir. Bu zincir, bir otomasyonun yayınladığı olayları, kaydettiği kayıtları ve istediği onayları izler.

Yayılma bir döngü değildir: bir çalışma üç stock_low olayı yayınlarsa abone her olay için bir kez, üç kez çalışır. Akış sınırları bunu sınırlar. Tek istisna, kendi istediği bir onaydan sonra devam eden otomasyondur.

Bir otomasyonun zaten 100 bekleyen çalışması varsa yeni bir olay Atlandı — önceki çalışma sürüyor olarak kaydedilir ve düşürülür. Bkz. Tetikleyiciler.

Akışlar sayfası

Kenar çubuğunda Akışlar'a tıklayın. Sayfa çalışma alanının her akışını, en yenisi önce olacak şekilde; başlangıç, işe karışan agent'lar, durum, adım ve çalıştırma sayısı, kredi ve süreyle listeler. Ajan ve Durum'a göre filtreleyin. Akışlar 30 gün saklanır.

Bir akışı açınca iki şekilde görürsünüz:

• Akış diyagramı. Her adım bir kutudur: hangi agent çalıştı ve Tamamlandı, Çalışıyor, Bekliyor, Atlandı ya da Başarısız mı. Kutular olayların sırasıyla bağlıdır.

• Seçili adım. Diyagramın altında, bir kutuya tıklayarak o adımın ne yaptığını görürsünüz:

  • nasıl başladığı (zamanlaması, "Stok ajanının stock_low olayıyla başladı", bir onay kararı vb.),
  • Kontrol sonucu ve Yanıt,
  • Yayınlanan olaylar; her biri Yayınlandı, Tekrar (yayınlanmadı), Simüle edildi ya da Yayınlanmadı olarak işaretli,
  • yaptığı Ekip çağrıları,
  • Yazılan kayıtlar,
  • Onaylar,
  • gönderilen Mesajlar,
  • kredisi ve süresi.

  Bağlantılar çalıştırmayı, konuşmayı, onayı ya da kaydı açar. Copilot'ta aç, Copilot'tan akışa bakıp bir sorun olup olmadığını söylemesini ister. Aşağıdaki bir zaman çizelgesi aynı adımları sırayla listeler.

Akışı test edin

Bir zinciri açmadan önce tamamını yan etkisiz çalıştırın. Başlatan otomasyonda Bir kez çalıştır sekmesini açın ve Akışı test et'e tıklayın. Peki otomasyonu ve başlattığı her şeyi taslakların deneme çalıştırması olarak çalıştırır:

• yayınlanan olaylar abonelerine deneme çalıştırması olarak ulaşır,
• yazma işlemleri simüle edilir,
• hiçbir şey gönderilmez,
• her onay onaylandı sayılır ve öyle işaretlenir.

Test etiketli, tam diyagramlı akış sayfasını alırsınız. Beklediğiniz her adımın orada olduğunu kontrol edin.

Copilot aynısını test_flow aracıyla yapar; bir otomasyondan ya da agent'ın bir olayından, sanki yeni yayınlanmış gibi başlayabilir.

Bir bakışta sınırlar

Sınır	Değer
Agent başına olay	20
Olay başına alan	20
Olay verisi	8 KB
Bir fonksiyon çalışmasının yayınladığı olay	10
Tekrar önleme penceresi	1 ile 168 saat, varsayılan 24
Akış başına adım / çalıştırma / kredi / saat	Varsayılan 6 / 30 / 500 / 24, yöneticiler değiştirebilir
Akışların saklanması	30 gün

İlgili sayfalar

• Agent ekipleri
• Otomasyonlar
• Tetikleyiciler, webhook'lar ve olaylar
• Kayıtlar
• Onaylar
• Fonksiyonlar
• Copilot ile çalışmak
• Sınırlar