> 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 dieselben Schritte für jeden Eintrag innerhalb einer Liste aus. Die einzige Voraussetzung für die Verwendung eines Iterationsschritts ist, sicherzustellen, 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-5908d89cc09763f9eaca59287abd7d1e726b3854%2Fiteration-step-01-loop.png?alt=media" alt="Ranking Page Analyzer Workflow with an Iteration step that wraps a Prompt LLM step"><figcaption><p>Der Iterationsschritt führt die darin enthaltenen Schritte einmal pro Listenelement aus.</p></figcaption></figure>

## Was ist eine Liste?

Eine Liste ist ein bestimmter 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 Zeichenketten:**

```
["sales", "marketing", "finance"]
```

**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 generiert werden, unter anderem über einen LLM-Schritt, einen Code-Schritt, Google Search oder einen API-Schritt. Letztlich kommt es darauf an, was für Ihren Anwendungsfall am besten funktioniert, und wir haben unten einige Beispiele bereitgestellt, um zu helfen.

### Erstellen einer Liste über einen LLM-Schritt

Da Sie bei unseren LLM-Schritten die Aufforderung anpassen können, bis Sie das gewünschte Ergebnis erzielt haben, reicht es aus, das Listenformat in Ihrer Eingabeaufforderung anzugeben.

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

### Erstellen einer Liste über einen Code-Schritt

Da unser [Code-Schritt](https://docs.airops.com/docs/de/aktionen/workflow-concepts/workflow-steps/logic-steps/code.md) es Ihnen ermöglicht, sowohl JavaScript als auch Python zu verwenden, 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"]);
```

### Generieren einer Liste über einen Google-Search-Schritt

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-1cca0e01cb9c8a0672dce25b2e13e8dc82512a6f%2Fiteration-step-02-links-list.png?alt=media" alt="Google Search step Find ranking pages with the result type set to Links Only (List)"><figcaption><p>Wählen Sie „Nur Links (Liste)“, um eine Liste für den Iterationsschritt zu erhalten.</p></figcaption></figure>

Die resultierende Ausgabe des Google-Search-Schritts wird wie folgt formatiert:

```javascript
// Ausgabe des Google-Search-Schritts mit Nur 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 eigentliche Objekt/der eigentliche Wert (z. B. Zeichenkette, 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-a24a17379343efce73a640eaa9cbcd59ce79cf2f%2Fiteration-step-04-element-variables.png?alt=media" alt="Variables Menu opened from the Prompt LLM step inside an Iteration, with the Iterate through each department step expanded to Output, Element, and Element_index"><figcaption><p>Verweisen Sie im Variablenmenü auf das aktuelle Element und den Elementindex der Iteration.</p></figcaption></figure>

## Wie verweise ich auf das Element?

Sie können auf das Element verweisen, indem Sie auf den Chip klicken `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-0aebdf05490a74e8c5ee74f69c0fa1907fc39d44%2Fiteration-step-03-element.png?alt=media" alt="Prompt LLM step inside an Iteration step, with a user message that references the current element from step_1.element"><figcaption><p>Verweisen Sie mit step_x.element auf das aktuelle Element.</p></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 jedoch verwendet werden, um leistungsstarke Logik auszuführen.

Zum Beispiel verwenden wir im Fall unseres SEO-Blogautors den `element_index` um uns beim Verfassen 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 in diesem Absatz anzuwenden.

Also fügen wir einen [**Bedingten** **Schritt**](https://docs.airops.com/docs/de/aktionen/workflow-concepts/workflow-steps/flow/conditional.md) mit folgendem hinzu:

* `step_x.element_index == 0`

wodurch 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 die 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
// step_x.output ersetzen

{% 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.
