İçeriğe geç
ajan.io

Belgeler menüsü

Bu sayfada

Çıktı

İş akışı çalıştırmanızın nihai sonucu olarak bir değeri yakalayın ve kalıcı hale getirin.

Genel bakış

Çıktı düğümü, çözümlenen bir değeri iş akışı çalıştırmasının sonucu olarak saklar. Terminal bir düğümdür — girdi tutamacı vardır ancak çıktı tutamacı yoktur; bu da onu iş akışı grafiğinizde yapısal bir uç nokta yapar.

İş akışı bittiğinde çıktı, çalıştırma geçmişinde, API üzerinden ve — iş akışı sohbetten tetiklendiyse — doğrudan sohbet mesajında kullanılabilir.

En uygun olduğu durum: Özetler, yapılandırılmış veri, çıkarılmış değerler veya bir iş akışı çalıştırmasından herhangi bir nihai sonuç döndürme.

Nasıl çalışır?

  1. Değer alanını Manuel, Prompt AI veya Otomatik modda yapılandırırsınız.
  2. Yürütme zamanında Manuel mod, {{agent.output.structured.summary}} gibi şablon değişkenlerini çözümler. Prompt AI ve Otomatik, değeri üretmek için seçtiğiniz tamamlanma modelini kullanır.
  3. Çözümlenen değer, düğümün slug’ı altında iş akışı çalıştırmasının output JSON nesnesinde kalıcı hale getirilir.
  4. İş akışı sohbetten tetiklendiyse çıktı, sonucun satır içi görünmesi için kaynak mesaja geri gönderilir.

Birden fazla Çıktı düğümü

Bir iş akışında birden fazla Çıktı düğümü olabilir. Her biri çalıştırmanın çıktı nesnesine ayrı bir anahtar (slug’ı) katkıda bulunur. Örneğin, slug’ları summary ve actionItems olan iki Çıktı düğümünüz varsa çalıştırma çıktısı şöyle görünür:

json
{
  "summary": "Q1 revenue grew by 12% driven by enterprise expansion...",
  "actionItems": "1. Schedule board review\n2. Update forecast model\n3. ..."
}

Yapılandırma

Değer

Değer alanı üç modu destekler:

Manuel: Önceki düğümlerden statik metin, değişkenler veya her ikisini kullanarak tam değeri tanımlayın.

Prompt AI: Değeri üretmesi için yapay zekaya talimat verin.

Otomatik: Yapay zekanın değeri iş akışı bağlamından üretmesine izin verin.

Aşağıdaki örnekler Manuel modu kullanır:

handlebars
{{agent.output.structured.summary}}

Birden fazla değişkeni ve statik metni birleştirebilirsiniz:

handlebars
Report for {{trigger.output.customer_name}}:

{{agent.output.structured.analysis}}

Generated on {{trigger.output.date}}

Prompt AI ve Otomatik modlar için Model alanında bir tamamlanma modeli seçin. Model seçilmemişse veya seçilen model kullanılamıyorsa düzenleyici sizi uyarır. Çıktı değeri yapay zeka üretimi gerektiriyorsa ve model seçilmemişse, Çıktı düğümü değeri çözümlerken başarısız olur.

Slug

Slug, bu çıktının altında saklandığı anahtardır. Düğüm adından camelCase olarak otomatik üretilir (ör. "Final Summary" → finalSummary). İş akışınızda birden fazla Çıktı düğümü varsa her birinin benzersiz bir slug’ı olmalıdır.

Hata işleme

Değer çözümlenemiyorsa hataların nasıl işleneceğini yapılandırın:

StratejiDavranış
DurdurHatada iş akışı hemen durur
Geri çağrıHata işleme dalına yönlendir
Devam etHata verisi kullanılabilirken devam et

Varsayılan: Durdur

Sohbet entegrasyonu

Bir iş akışı sohbetten tetiklendiğinde (@-mention veya bir ajan üzerinden), Çıktı düğümü sonucunu doğrudan sohbet mesajına yazar. Kullanıcı, iş akışı çalıştırma geçmişine gitmeden sonucu satır içi görür.

Çıktı, sohbette iş akışı adını, yürütme süresini ve çıktı içeriğini gösteren biçimlendirilmiş bir sonuç paneli olarak görünür.

İş akışında Çıktı düğümü yoksa sohbet, ayrıntılı sonuç yerine genel bir "tamamlandı" durumu gösterir.

Örnek

Bir destek talebini analiz edip yapılandırılmış yanıt döndüren bir iş akışı:

handlebars
**Priority:** {{agent.output.structured.priority}}
**Category:** {{agent.output.structured.category}}
**Suggested response:**

{{agent.output.structured.draft_reply}}

Bu, çalışma zamanında gerçek değerlere çözümlenir ve düğümün slug’ı altında tek bir dize olarak saklanır.

En iyi uygulamalar

Yalnızca tüketicinizin ihtiyaç duyduğu veriyi döndürün. İş akışı sohbetten tetiklendiyse özlü bir özet, tüm ara veriyi dökmekten daha yararlıdır.

Birden fazla Çıktı düğümünüz varsa çıktı anahtarlarının kendini açıklayan olması için açıklayıcı adlar verin (ör. summary, recommendations, rawData).

Birden fazla önceki adımdan veriyi sentezlemek için bir Ajan düğümü kullanın, ardından ajanın yapılandırılmış çıktısını Çıktı düğümüne iletin. Bu, nihai sonucunuzu temiz ve iyi biçimlendirilmiş tutar.

Bir iş akışını çalıştırdıktan sonra yakalanan değeri görmek için çalıştırma zaman çizelgesindeki Çıktı düğümünü kontrol edin. Bu, şablon ifade sorunlarını ayıklamaya yardımcı olur.

Sonraki adımlar