> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/de/aktionen/workflow-concepts/workflow-steps/flow/iteration.md).

# Iteration

Führen Sie einen Schritt mehrmals über eine Liste von Objekten aus

## Wie funktioniert der Iterationsschritt?

Der Iterationsschritt führt denselben Schritt bzw. dieselben Schritte für jeden Eintrag innerhalb einer Liste aus. Die einzige Voraussetzung für die Verwendung eines Iterationsschritts ist, dass Ihre Eingabewerte bereits in ein Listenobjekt formatiert wurden.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-f5cd41deb71c58a0a24a9b8fb83816aafcbcc13b%2FCleanShot%202025-05-22%20at%2008.22.37%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

## Was ist eine Liste?

Eine Liste ist ein spezifischer Datentyp mit durch Kommas getrennten Elementen, der mit `[` beginnt und mit `]` . Zum Beispiel:

**Eine Liste von Zahlen:**

```
[1,2,3,4,5]
```

**Eine Liste von Zeichenfolgen:**

```
["Vertrieb", "Marketing", "Finanzen"]
```

**Eine Liste von JSON-Objekten:**

```
[
  {
    "link": "https://openai.com/",
    "title": "OpenAI",
    "source": "OpenAI"
  },
  {
    "link": "https://www.youtube.com/@OpenAI",
    "title": "OpenAI",
    "source": "YouTube"
  },
  {
    "link": "https://en.wikipedia.org/wiki/OpenAI",
    "title": "OpenAI",
    "source": "Wikipedia"
  }
]
```

## Wie erstelle ich eine Liste?

Listen können auf verschiedene Arten erzeugt werden, unter anderem über einen LLM-Schritt, einen Code-Schritt, die Google-Suche oder einen API-Schritt. Letztlich kommt es darauf an, was für Ihren Anwendungsfall am besten funktioniert, und wir haben unten einige Beispiele zur Hilfe bereitgestellt.

### Eine Liste über einen LLM-Schritt erstellen

Da Sie mit unseren LLM-Schritten die Eingabeaufforderung so lange anpassen können, bis Sie das gewünschte Ergebnis erreicht haben, genügt es, das Listenformat in Ihrer Eingabeaufforderung anzugeben.

Gehen wir ein Beispiel-Workflow durch, der als Eingabe einen Ländernamen verwendet und die fünf größten Städte in diesem Land zurückgibt. Wir passen den bestehenden Workflow so an, dass diese fünf größten Städte in einem Listenformat zurückgegeben werden:

### Eine Liste über einen Code-Schritt erstellen

Da unser [Code-Schritt](/docs/de/aktionen/workflow-concepts/workflow-steps/logic-steps/code.md) sowohl JavaScript als auch Python unterstützt, können Sie Ihre Return-Anweisung fest codieren, um dem gewünschten Listenformat zu entsprechen, z. B.

```javascript
return(["San Francisco", "New York City", "Miami"]);
```

### Eine Liste über einen Google-Search-Schritt erzeugen

Unser Google-Search-Schritt ermöglicht es Ihnen, die spezifische Formatierung Ihrer Suchergebnisse auszuwählen:

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-960126f632ad0e9b8d74fb78ce90516cc1f41631%2FCleanShot%202025-05-22%20at%2008.24.27%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

Die resultierende Ausgabe des Google-Search-Schritts wird folgendermaßen formatiert sein:

```javascript
// Ausgabe des Google-Search-Schritts nur mit Links
[
  "https://www.mckinsey.com/featured-insights/mckinsey-explainers/what-is-prompt-engineering",
  "https://www.zdnet.com/article/six-skills-you-need-to-become-an-ai-prompt-engineer/",
  "https://www.techtarget.com/searchenterpriseai/definition/AI-prompt-engineer",
  "https://en.wikipedia.org/wiki/Prompt_engineering",
  "https://www.datacamp.com/blog/what-is-prompt-engineering-the-future-of-ai-communication",
  "https://www.iit.edu/blog/unlock-career-opportunities-ai-how-become-ai-prompt-engineer",
  "https://aws.amazon.com/what-is/prompt-engineering/",
  "https://hbr.org/2023/06/ai-prompt-engineering-isnt-the-future",
  "https://time.com/6272103/ai-prompt-engineer-job/",
  "https://www.promptingguide.ai/"
]
```

## Was ist das Element und der Elementindex?

Ein Element ist das tatsächliche Objekt bzw. der tatsächliche Wert (z. B. Zeichenfolge, Zahl oder Objekt) in Ihrer Liste.

Der Elementindex ist die Position des Elements innerhalb der Liste, beginnend mit dem ersten Element bei Index 0.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-4408acba06b3cfdc596cb2ce5d449db605384407%2Fiteration_step_3.png?alt=media" alt=""><figcaption></figcaption></figure>

## Wie verweise ich auf das Element?

Sie können auf das Element verweisen, indem Sie die Schaltfläche anklicken `step_x.element` innerhalb Ihres Iterationsschritts:

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-d2913c27c7511d6820930e2a6b233c1c3b824c24%2FCleanShot%202025-05-22%20at%2008.28.05%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

Im obigen Beispiel wird der LLM-Schritt 3 Mal ausgeführt, und der `{{step_1.element}]` wird ersetzt durch `Vertrieb` , `Marketing` und `Finanzen` wie folgt:

* `Gib mir 3 Personas in der Vertriebsabteilung`
* `Gib mir 3 Personas in der Marketingabteilung`
* `Gib mir 3 Personas in der Finanzabteilung`

## Ist der Elementindex erforderlich?

Der Elementindex ist optional, kann aber verwendet werden, um leistungsstarke Logik umzusetzen.

Zum Beispiel verwenden wir beim SEO-Blog-Autor den `element_index` um uns beim Schreiben unserer Einleitungen zu helfen. Da unser Ziel ist, dass der Autor *nur den ersten Abschnitt schreibt* des Blogs, ist der Elementindex nützlich, um den Schritt nur auf diesen Absatz anzuwenden.

Also fügen wir einen [**Bedingung** **Schritt**](/docs/de/aktionen/workflow-concepts/workflow-steps/flow/conditional.md) mit:

* `step_x.element_index == 0`

damit wir einen separaten LLM-Schritt mit der Einleitung nur für den ersten Abschnitt des Blogs verwenden können.

## Wie sieht die Ausgabe aus?

Der Iterationsschritt gibt ebenfalls eine Liste aus.

Die Ausgabe jeder Iteration wird der Liste in derselben Reihenfolge wie in der Eingabe hinzugefügt.

## Wie wandle ich die Liste in Text um?

Sie können das Array mit einem einfachen **Text** Schritt wieder in Text umwandeln, der Liquid verwendet:

```liquid
// Ersetze step_x.output

{% for chunk in step_x.output %}
{{chunk}}
{% endfor %}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/de/aktionen/workflow-concepts/workflow-steps/flow/iteration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.