Legend

Legend (/legend), birden fazla agent'ı ve aracı (tool) bir DAG (yönlü çevrimsiz graf) iş akışında zincirlediğiniz modüldür. Tek bir agent çağrısının ötesine geçip çok adımlı otomasyonlar kurarsınız. Bu sayfa akışı uçtan uca anlatır: genel bakış → DAG oluşturma → araçlar ve onay → çalıştırma → observability.

flowchart LR
    A[Trigger] --> B[Agent]
    B --> C{Condition}
    C -->|true| D[HTTP / Lore]
    C -->|false| E[Agent]
    D --> F[End]
    E --> F

Genel Bakış

DAG Oluşturma

Bir Legend, düğümlerden (node) ve onları bağlayan kenarlardan (edge) oluşur.

1. New ile boş bir akış açın veya Templates'ten bir şablon seçin (Starter workflow, Support triage, Content pipeline).
2. Soldaki paletten düğüm ekleyin (tıklayın veya canvas'a sürükleyin).
3. Bir düğümün çıkış portundan diğerinin giriş portuna sürükleyerek bağlayın.
4. Düğümü seçip sağdaki NODE INSPECTOR'da ayarlarını yapın.
5. Save ile kaydedin; her kayıt bir sürüm (revision) oluşturur.

Condition Node — IF/ELSE Dallanma

Condition düğümü akışınıza deterministik karar mantığı ekler; LLM prompt'una bırakmadan belirli kurallara göre iki farklı yola yönlendirebilirsiniz.

flowchart LR
    A[Agent: Araştırma] --> C{Condition}
    C -->|true| B[Agent: Rapor Yaz]
    C -->|false| D[Agent: Hata Bildir]
    B --> E[End]
    D --> E

Kural örnekleri:

• Operatörler: contains, not_contains, equals, not_equals, not_empty, is_empty; karşılaştırma büyük/küçük harf duyarsızdır.
• Birden fazla kural AND mantığıyla değerlendirilir (hepsi sağlanmalı → true); kuralsız bir condition her zaman false döner.
• Çıkan kenarları seçip LABEL alanına true veya false yazın.
• Seçilmeyen dal tamamen atlanır (skipped).
• Check düğümü aynı kural yapısını kullanır, ancak dallanmaz: kural sağlanmazsa koşuyu durdurur.

Variable Template

Agent ve prompt düğümlerinde önceki düğümlerin çıktısına {{node_id.output}} (veya kısaca {{node_id}}) söz dizimiyle referans verebilirsiniz:

Şu araştırma sonucunu göz önüne alarak özet yaz: {{researcher.output}}

• node_id, referans verilen düğümün ID'sidir.
• Aynı söz dizimi HTTP düğümünün adresinde ve gövdesinde, Lore sorgusunda ve condition alanlarında da çalışır; JSON gövdeye eklenen değerler kaçışlanır.
• {{ içermeyen metinler olduğu gibi kalır.

Canvas — Kenar (Edge) Etkileşimi

Kenar çizme: Çıkış portundan giriş portuna sürükleyin; bırakma noktası bir giriş portuna yakınsa bağlantı ona oturur. Esc devam eden bağlama sürüklemesini iptal eder.

Kenar seçme: Çizginin yakınına tıklayın; sağda CONNECTION paneli açılır. Buradan etiket (LABEL) verebilir, araya Add condition ile bir condition düğümü ekleyebilir veya Delete connection ile kenarı silebilirsiniz.

Silme: Seçili düğüm veya kenar Delete ya da Backspace ile silinir.

Görünüm: Fare tekerleği, iki parmakla yakınlaştırma veya köşedeki +/− ve Fit to canvas kontrolleri; ızgarayı gösterme/gizleme, ızgaraya hizalama ve katman (layers) paneli araç çubuğundadır. Undo / Redo son değişiklikleri geri alır ve yineler.

Araçlar, Yetki ve Onay

MCP TOOLSETS: Claude motorundaki bir agent düğümüne bir veya daha fazla toolset bağlayabilirsiniz (OpenAPI'den türetilmiş, native MCP veya Lore türü). Model bir araç çağırır, sonucu okur, gerekirse yeni bir araç çağırır. Bu döngü düğüm başına en fazla 5 turdur; tur sınırı dolunca model araçsız bir son yanıt üretir.

flowchart LR
    M[Model] -->|tool çağır| T[Toolset aracı]
    T -->|sonuç| M
    M -->|yeterli| O[Çıktı]

Require approval (HITL): Agent düğümünde bu anahtar açıksa koşu o düğüme geldiğinde durur ve Awaiting durumuna geçer. Observability ekranında Approve & continue ile devam eder, Reject ile koşu başarısız olarak biter. Bekleme sırasında kredi düşülmez; onay bekleyen akışlar süreç içinde yürütülür.

Lore bağlamı: Kayıtlı bir agent'a bağlı Lore varsa, agent düğümü çalışmadan önce ilgili bilgi tabanı bağlamı prompt'a eklenir (bkz. Lore).

Çalıştırma

1. Araç çubuğunda Execute'a tıklayın; akış önce kaydedilir.
2. Açılan pencerede başlangıç girdisini yazın.
3. Koşu başlar ve Observability izine yönlendirilirsiniz; koşu ayrıca Tale listesinde görünür.

Araç çubuğundaki kredi göstergesi akışın tahmini maliyetini gösterir.

İçe Aktarma, Yayınlama ve Sürümler

Import: n8n, Flowise veya Langflow dışa aktarımını (JSON yapıştırarak veya en fazla 2 MB'lık .json dosyasıyla) içe alabilirsiniz. Analyze önce eşleşmeyi gösterir; karşılığı olmayan düğümler Unsupported yer tutucusu olarak gelir, koşuda girdiyi olduğu gibi geçirir ve elle bağlanabilir. Dify dışa aktarımı API üzerinden desteklenir.

Publish: Akışa ad ve kısa açıklama vererek Public yaparsanız Discover'ın Workflows sekmesinde listelenir; Private ile listeden kalkar.

Sürümler: Kaydedilmiş bir akışta Version history önceki sürümleri açar, Compare versions iki sürüm arasındaki yapısal farkları gösterir.

Observability

Observability (/legend/observability/:id), bir koşunun düğüm düğüm ne yaptığını gösteren iz görüntüleyicisidir. Başlıkta akış adı, koşu kimliği ve durum; altında Duration, Credits spent ve Steps done sayaçları bulunur. TIMELINE bölümünde her düğüm için durum (DONE / FAILED), süre ve çıktı ya da hata mesajı listelenir; onay bekleyen düğüm Approve & continue / Reject düğmeleriyle görünür.

flowchart LR
    A[Düğüm 1 ✓] --> B[Düğüm 2 ✓]
    B --> C[Düğüm 3 ✗ hata]
    C -. resume .-> C2[Düğüm 3 tekrar]

Sonraki Adım

Dış servisleri araç olarak bağlamak için Toolsets'e bakın. Kayıtlı servislerinizi ve tokenlarını Connectors'tan yönetirsiniz.