İçeriğe geç
ajan.io

Belgeler menüsü

Bu sayfada

İş akışları

Otomatik iş akışlarını doğrudan sohbetten tetikleyin — @ ile bahsedin veya ajanlar üzerinden kullanın.

Sohbette iş akışları nedir?

İş akışları, İş akışı oluşturucu'da oluşturulan çok adımlı otomasyonlardır. Normalde bunları İş akışları sayfasından çalıştırırsınız; ancak doğrudan bir sohbet konuşmasından da tetikleyebilirsiniz — ya bir iş akışından @ ile bahsederek ya da iş akışları aksiyon olarak eklenmiş bir ajanla sohbet ederek.

Bir iş akışı sohbetten çalıştığında gerçek zamanlı ilerlemeyi ve nihai sonucu konuşmanın içinde görürsünüz. İş akışı çalıştırma geçmişine geçmeniz gerekmez.

Sohbetten iş akışlarını tetiklemenin iki yolu:

YöntemNasıl çalışır
Sohbette bahsetmeİleti girişinde @ yazın, bir iş akışı seçin ve iletinizi gönderin
İş akışlı ajanAksiyon olarak iş akışları eklenmiş bir ajanla sohbet edin — yapay zeka ne zaman çağıracağına karar verir

Sohbetten bir iş akışını tetikleme

Bahsetme menüsünü açmak için sohbet girişinde @ yazın. Erişiminiz olan tüm iş akışlarını listeleyen bir İş akışları bölümü görürsünüz. İletinizde etiketlemek için birini seçin.

İletiyi gönderdiğinizde yapay zeka isteğinizi okur ve etiketlenen iş akışını tetikleyip tetiklemeyeceğine karar verir. Tetiklerse iş akışı gerçekten çalışmadan önce bir onay paneli görürsünüz.

@ ile etiketlenen iş akışları konuşmayla ilişkili kalır. Bir iletide bir iş akışını etiketlerseniz yapay zeka aynı konuşmadaki takip iletilerinde de kullanabilir — her seferinde yeniden etiketlemeniz gerekmez.

Bahsetme menüsünde yalnızca tüm şu koşulları karşılayan iş akışları görünür:

  • İş akışı workspace'inize aittir
  • Erişiminiz vardır (sahibisiniz veya sizinle paylaşılmıştır)
  • İş akışı etkindir (yayımlanmış)
  • İş akışı desteklenen bir tetikleyici türü kullanır (aşağıya bakın)

Desteklenen tetikleyici türleri

Her iş akışı sohbetten tetiklenemez. Yalnızca şu tetikleyici türleri desteklenir:

Tetikleyici türüSohbette kullanılabilir mi?Notlar
ManuelEvetBasit onayla-çalıştır — giriş alanları yok
FormEvetForm alanlarını doldurmanız için sohbet içinde gösterir
ZamanlanmışEvetSohbetten isteğe bağlı da tetiklenebilir
WebhookHayırHarici bir HTTP çağrısıyla tetiklenmelidir
EntegrasyonHayırBir entegrasyon olayıyla tetiklenmelidir

İş akışlarını ajanlar üzerinden kullanma

Ajanlara ajan düzenleyicisinde aksiyon olarak iş akışları eklenebilir. Ajanla sohbet ettiğinizde yapay zeka, herhangi bir başka araçta olduğu gibi isteğinize göre bir iş akışını ne zaman çağıracağına otomatik karar verir.

Bir ajana iş akışı ekleme

  1. Ajanı ajan düzenleyicide açın
  2. Aksiyonlar bölümüne gidin
  3. Aksiyon ekle'ye tıklayın ve İş akışları sekmesine geçin
  4. Eklemek istediğiniz iş akışını seçin

Bir iş akışını ayırmak için Aksiyonlar bölümündeki kartındaki X'e tıklayın.

Ajan düzenleyicideki İş akışları sekmesi hem etkin hem etkin olmayan iş akışlarını gösterir. Bu, hâlâ geliştirilmekte olan bir iş akışını önceden eklemenize ve ajanı yeniden düzenlemeden sonra etkinleştirmenize olanak tanır.

İş akışlarını Ajan Oluşturucu sohbetinde de ekleyebilir veya ayırabilirsiniz. "Bu ajana Raporu Özetle iş akışını ekle" veya "Onboarding iş akışını kaldır" gibi bir şey sorun. Oluşturucu erişiminiz olan iş akışlarını arar, eşleşenleri ekler ve değişikliği satır içi gösterir. Bu aramada yalnızca etkin iş akışları görünür.

Yapay zeka bir iş akışını ne zaman çağıracağına nasıl karar verir

Eklenen her iş akışı, yapay zekanın çağırabileceği bir araç olur. Araç adı iş akışı adından türetilir (ör. "Raporu Özetle" adlı bir iş akışı workflow_summarize_report aracı olur). Yapay zeka, aracın isteğinizle ne zaman ilgili olduğuna karar vermek için iş akışının açıklamasını ve tetikleyici alanlarını okur.

Form tetikleyicili iş akışlarında yapay zeka form alanı tanımlarını (adlar, türler, açıklamalar) aracın giriş şeması olarak görür. Form alanlarını ileti bağlamınızdan doldurabilir — örneğin "bu belgeyi özetle" derseniz ve bir DOSYA alanı varsa yapay zeka konuşmanın eklerine atıf yapar.

Manuel ve zamanlanmış iş akışlarında araç girişi basit bir onaydır — yapay zeka iş akışını tetiklemeyi önerir; siz onaylar veya reddedersiniz.

Onay akışı

Sohbetten tetiklenen her iş akışı, çalışmadan önce açık onayınızı gerektirir. İş akışları harici aksiyonlar gerçekleştirebilir (e-posta gönderme, kayıt oluşturma, API çağırma); bu nedenle yürütmeden önce her zaman gözden geçirme şansınız olur.

Manuel ve zamanlanmış iş akışları

İş akışı adıyla ve iki düğmeyle kompakt bir panel görürsünüz:

  • Tetikle — onaylar ve iş akışı çalıştırmasını başlatır
  • Reddet — iş akışı çağrısını iptal eder. Yapay zeka reddi kabul eder ve yeniden sormadan devam eder.

Form iş akışları

Form alanları sohbet içinde işlenir. Konuşmada dosya ekleriniz varsa DOSYA alanları otomatik önceden doldurulur:

  • Tek dosyalı alanlar en son dosyayı alır; formda birkaç tane varsa her alan yükleme sırasındaki en yeni dosyalardan birini alır
  • Çok dosyalı alanlar konuşmadaki en son dosyaları alır (en fazla 50)

Bir formda birkaç DOSYA alanı varsa ve bunlardan en az biri birden çok dosya kabul ediyorsa hiçbir şey önceden doldurulmaz; dosyaları kendiniz seçersiniz.

Göndermeden önce önceden doldurulmuş değerleri gözden geçirebilir, değiştirebilir veya temizleyebilirsiniz. İş akışını form verisiyle çalıştırmak için Tetikle'ye veya iptal etmek için Reddet'e tıklayın.

Önceden doldurulmuş dosyalar konuşmada olana dayalı önerilerdir. Özellikle çok sayıda belge yüklenmiş konuşmalarda tetiklemeden önce doğru dosyaların ekli olduğunu her zaman iki kez kontrol edin.

Canlı ilerleme ve sonuçlar

Onayladığınızda sohbet gerçek zamanlı durum güncellemeleri gösterir:

DurumNe görürsünüz
ÇalışıyorAnimasyonlu "[iş akışı adı]" iş akışı çalışıyor göstergesi
Tamamlandı"[iş akışı adı]" iş akışı Xs içinde çalıştı ve altında çıktı
Başarısız"[iş akışı adı]" iş akışı başarısız oldu ve hata ayrıntılarını gösteren kırmızı panel
Reddedildi[iş akışı adı] (iptal edildi) başlığı. Genişlettiğinizde kehribar İş akışı yürütmesi reddedildi bildirimi

Bir iş akışı tetiklendiğinde, iş akışı çalıştığı sürece ilerleme görünür.

İş akışı bir Çıktı düğümü üzerinden çıktı döndürür dönmez çıktı değeri sohbet iletisinde biçimlendirilmiş bir sonuç paneli olarak doğrudan gösterilir. Çıktı düğümü yoksa ayrıntılı çıktı olmadan genel bir "tamamlandı" iletisi görürsünüz.

Erişim denetimi

Sohbetteki iş akışı erişimi, ajan ekli iş akışları için önemli bir nüansla ajan'daki diğer her yerle aynı izin modelini izler.

Bir iş akışından @ ile bahsettiğinizde, yalnızca erişiminiz varsa bahsetme menüsünde görünür. Göremiyorsanız tetikleyemezsiniz.

Bir iş akışı bir ajana eklendiğinde erişim denetimi ajanı açtığınızda değil, yürütme zamanında yapılır. Bu şu anlama gelir:

  • Erişiminiz olmayan bir iş akışına sahip bir ajanla sohbet edebilirsiniz
  • Yapay zeka iş akışının varlığını bilir ve çağırmayı deneyebilir
  • Çağırdığında erişiminiz olmadığını ve bir yöneticiyle iletişime geçmeniz gerektiğini söyleyen bir hata iletisi görürsünüz

Bir ajanla sohbette "\[iş akışı adı] iş akışına erişiminiz yok" görürseniz temel iş akışına erişim istemek için workspace yöneticinizle iletişime geçin. Ajana erişim, ekli iş akışlarına otomatik erişim vermez.

İş akışının nasıl paylaşıldığıSohbetten tetiklenebilir mi?
İş akışının sahibisinizEvet
Tüm workspace ile paylaşılmışEvet — tüm workspace üyeleri
Belirli kişi veya gruplarla paylaşılmışEvet, dahil edildiyseniz
Sizinle paylaşılmamışHayır — erişim hatası alırsınız

Bir ajana eklenen form iş akışları bir istisnadır. Formun Erişim denetimi Workspace veya Herkese açık olarak ayarlandıysa, sizinle hiç paylaşılmamış olsa bile workspace'inizdeki herkes ajan üzerinden iş akışını tetikleyebilir.

Sınırlamalar

SınırlamaAyrıntılar
MobilMobil uygulamada iş akışlarından bahsedemezsiniz. Bir ajan ekli bir iş akışını orada yine çağırabilir; ancak mobilde Tetikle veya Reddet düğmeleri yoktur, bu nedenle çağrı onay beklerken beklemede kalabilir.
Ajanlar arası (A2A)Bir ajan A2A üzerinden başka bir ajanı çağırdığında alt ajan iş akışlarını tetikleyemez. Özyinelemeli tetiklemeleri önlemek için A2A yürütme yolunda iş akışı araçları devre dışıdır.
Dosya ön doldurma üst sınırıDOSYA alanlarını önceden doldururken en fazla 50 konuşma eki, en yeniden başlayarak dikkate alınır. Bu sınırın ötesindeki daha eski dosyalar dahil edilmez.
Araç adı uzunluğuİş akışı araç adları 63 karakterle sınırlıdır (sağlayıcı düzeyinde kısıt). Çok uzun iş akışı adlarının araç adı kısaltılır.
Yinelenen iş akışı çağrılarıYapay zekaya aynı iş akışını kullanıcı isteği başına birden fazla çağırmaması talimatı verilir. Farklı iş akışları aynı yanıttan onayınızı bekleyebilir.
Onay her zaman gerekirSohbetten her iş akışı tetiklemesi açık kullanıcı onayı gerektirir. Sohbetten tetiklenen iş akışları için otomatik yürütme modu yoktur.
Desteklenmeyen tetikleyicilerWebhook veya entegrasyon tetikleyicili iş akışları sohbetten tetiklenemez. Bu tetikleyici türleri harici olay kaynakları için tasarlanmıştır.

Sık sorulan sorular

Evet. Herhangi bir sohbette @ yazın, bahsetme menüsünden bir iş akışı seçin ve iletinizi gönderin. Ajana gerek yok. Yapay zeka isteğinize göre iş akışını tetikleyip tetiklemeyeceğine karar verir.

Sohbet, iş akışı bir son duruma ulaşana kadar kontrol etmeye devam eder. İlerleme sürdüğü sürece "[iş akışı adı]" iş akışı çalışıyor göstergesini görürsünüz. Sohbet görünümünde zaman aşımı yoktur. Dakikalar süren iş akışları bile sonunda sonuçlarını gösterir.

Doğrudan sohbet arayüzünden hayır. Çalışan bir iş akışını iptal etmeniz gerekiyorsa İş akışları bölümünde iş akışının çalıştırma geçmişine gidin.

İş akışının etkin (yayımlanmış) olduğunu, desteklenen bir tetikleyici türü (manuel, form veya zamanlanmış) kullandığını ve erişiminiz olduğunu kontrol edin. Webhook ve entegrasyon tetiklemeli iş akışları menüde asla görünmez.

Evet. Bir ajanın birden çok iş akışı ekliyse yapay zeka aynı yanıtta farklı iş akışlarını çağırabilir.

Evet, DOSYA türü form alanları için. Bir iş akışında DOSYA alanları varsa ve konuşmada ekler varsa bu alanlar konuşmadan önceden doldurulur. Çok dosyalı alanlar en son dosyaları alır (en fazla 50); tek dosyalı alanlar en son olanı alır. Onaylamadan önce bunları her zaman değiştirebilir veya temizleyebilirsiniz.

SSS

Görevde tekrarlanabilir adımlar, yapılandırılmış girdiler, dallanma mantığı, onaylar veya öngörülebilir sırada çalışması gereken entegrasyonlar olduğunda bir iş akışı kullanın. Görev daha konuşmaya dayalıysa veya esnek akıl yürütme gerektiriyorsa bir ajan kullanın.

İş akışları ajanları çağırabilir, aksiyonlar gerçekleştirebilir, dosyaları işleyebilir ve düğümler arasında çıktı aktarabilir. Her adımın net girdileri ve çıktıları olmalı ki sonraki düğümler sonucu güvenilir kullanabilsin.