Döngü

Genel bakış

Döngü düğümü veri dizilerini işler—müşteri, sipariş, dosya veya herhangi bir koleksiyon listelerinde yineleyerek her öğeye aynı mantığı uygular.

En uygun olduğu durum: Toplu işleme, birden fazla kaydı işleme, bireysel raporlar üretme ve listeler üzerinde yineleme.

Yapılandırma

Girdi dizisi: Üzerinde döngü kurulacak diziyi seçin

{{ trigger.output.customers }}
{{ api_response.output.items }}
{{ google_sheets.output.rows }}

Maks. yineleme: Güvenlik limiti (varsayılan: 200, maks: 2000)

Gelişmiş seçenekler

Eşzamanlılık: Döngü yinelemelerinin paralel işlenmesini etkinleştirin

Etkinleştirildiğinde tüm yinelemeler birbiri ardına değil eşzamanlı çalışır. Bu döngüleri önemli ölçüde hızlandırır; ancak yinelemelerin birbirine bağımlı olmamasını gerektirir.

Eşzamanlılık açıkken yinelemeler herhangi bir sırada tamamlanabilir. Sonraki yinelemeler öncekilerin sonuçlarına bağlıysa eşzamanlılık kullanmayın.

Çıktıları topla: Tüm yineleme sonuçlarını tek bir dizide toplayın

Etkinleştirildiğinde döngü bitiş düğümü her yinelemeden sonuçlar içeren bir dizi çıktılar. Bu, döngüde işlenen veriyi birleştirmek için yararlıdır.

Toplanan çıktı, aynı iş akışı çalıştırmasında daha sonra çalışan düğümler için de kullanılabilir; dış bir döngünün içindeki düğümler dahil.

{{ loop_end.output.iterations }}            → Array of all iteration data
{{ loop_end.output.iterations[0].item }}    → First iteration's input item
{{ loop_end.output.iterations[0].executions }}  → Nodes executed in first iteration
{{ loop_end.output.total }}                 → Total number of iterations

Toplanan çıktı yapısı:

{
  "iterations": [
    {
      "index": 0,
      "item": { "original": "data" },
      "executions": [
        {
          "nodeId": "abc123",
          "nodeSlug": "agent",
          "nodeType": "agent",
          "input": { ... },
          "output": { "result": "processed" }
        }
      ]
    }
  ],
  "total": 10
}

Sonuçları birleştirmeniz, tüm yinelemelerden rapor oluşturmanız veya nihai işleme için döngü sonuçlarını aşağı akış bir düğüme iletmeniz gerektiğinde Çıktıları topla’yı kullanın.

Döngünün içinde

Döngü düğümünün slug’ı değişken adınız olur. Geçerli öğeye ve yineleme bilgisine erişin:

{{ customer.output.currentItem }}           // The full current item
{{ customer.output.currentItem.name }}      // Access item properties
{{ customer.output.currentItem.email }}
{{ customer.output.currentIndex }}          // Current iteration (0-based)
{{ customer.output.total }}                 // Total items in array

Örnek kullanım senaryoları

Müşteri listesini işle

Loop over {{ trigger.output.customers }}
  Loop node slug: customer

  → Agent: Analyze {{ customer.output.currentItem.feedback }}
  → Condition: Check {{ customer.output.currentItem.score }}
    → High: Send thank you email
    → Low: Create follow-up task

Kayıtları toplu güncelle

Loop over {{ api_response.output.records }}
  Loop node slug: record

  → Code: Transform {{ record.output.currentItem.data }}
  → HTTP Request: Update record {{ record.output.currentItem.id }}

Bireysel raporlar üret

Loop over {{ trigger.output.team_members }}
  Loop node slug: member

  → HTTP Request: Fetch {{ member.output.currentItem.id }} data
  → Agent: Generate report for {{ member.output.currentItem.name }}
  → Action: Email report to {{ member.output.currentItem.email }}

Paralel görüntü işleme (Eşzamanlılık)

Loop over {{ trigger.output.images }}
  Loop node slug: image
  Parallel Execution: On

  → Agent: Analyze {{ image.output.currentItem.url }}
  → Code: Extract metadata

Tüm görüntüler eşzamanlı analiz edilir; sıralı işlemeden çok daha hızlı tamamlanır.

Sonuçları birleştir (Çıktıları topla)

Loop over {{ trigger.output.documents }}
  Loop node slug: doc
  Collect Outputs: On

  → Agent: Summarize {{ doc.output.currentItem.content }}
  → Code: Extract key points

→ Agent: Create master summary from {{ loop_end.output.iterations }}
→ Action: Send combined report

Son Ajan, kapsamlı bir rapor oluşturmak için tüm özetleri bir kerede alır.

En iyi uygulamalar

Sonsuz döngüleri ve kontrolden çıkan maliyetleri önleyin. Makul bir maksimum ayarlayın.

100 bireysel ajan çağrısı yerine öğeleri 10’luk gruplara toplayın.

Dizinin öğe içerip içermediğini kontrol etmek için döngüden önce bir koşul ekleyin.

Yapay zeka ajanlı döngüler pahalı olabilir. Hesaplayın: öğe başına maliyet × öğe sayısı.

Maliyet uyarısı

Döngüler, birçok öğeyi yapay zeka ajanlarıyla işlerken önemli miktarda kredi tüketebilir. 100 öğeli ve öğe başına $0.10 ajan çağrılı bir döngü = çalıştırma başına $10.

Sonraki adımlar

• Ajan düğümü — Öğeleri yapay zeka ile işleyin
• Maliyet yönetimi — Döngü maliyetlerini optimize edin