> 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/logic-steps/code.md).

# Code ausführen

Benutzerdefinierte Logik mit Javascript oder Python hinzufügen

## Wie funktioniert der Code-Schritt?

Der Code-Schritt in AirOps Studio unterstützt derzeit **JavaScript** und **Python**, was Ihnen die nötige Flexibilität bietet, um erweiterte Anfragen auszuführen.

{% hint style="warning" %}
Der Code in einem Code-Schritt ist in eine Funktion eingebettet, und Sie müssen eine **return** Anweisung verwenden, um Ergebnisse aus dem Schritt auszugeben.
{% endhint %}

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-cb4f78b7c15134bcf0b3a6b60208f287818b3b25%2Fcode-step-01-example.png?alt=media" alt="Run Code step Build pass schedule summary with Python code in the editor, after a Call API step"><figcaption><p>Ein Beispiel für einen Run-Code-Schritt.</p></figcaption></figure>

## JavaScript

### Wie man eine Eingabe referenziert

Im Gegensatz zu Liquid enthalten JavaScript-Variablen **keine** `{{` oder `}}` . Zum Beispiel:

* `{{linkedin_url}}` wäre `linkedin_url`

### Wie man eine Ausgabe referenziert

Die JavaScript-Syntax ähnelt Liquid, verwendet aber keine Klammern:

* `{{step_1.output}}` wäre `step_1.output`
* `{{step_1.output.name}}` wäre `step_1.output.name`

### Verwenden Sie eine Return-Anweisung

Sie müssen eine `return` Anweisung in einem Code-Schritt einfügen, um die Ausgabe des Schritts festzulegen

### JavaScript-Beispiel

Gehen wir ein Beispiel durch, das sowohl auf eine Texteingabe als auch auf eine LLM-Ausgabe verweist. Wir verwenden einen einfachen Workflow, der eine String-Eingabe anfordert und eine Übereinstimmung von Wörtern zurückgibt, die sich darauf reimen.

Unser Code-Schritt ist lediglich dafür verantwortlich, die Eingabeaufforderung mit der LLM-Ausgabe zu kombinieren, sodass wir nur ein einzelnes Ergebnis haben, das Frage und Antwort enthält:

{% @arcade/embed url="<https://app.arcade.software/share/ucsCBgcBlpyFyrPMzrZi>" flowId="ucsCBgcBlpyFyrPMzrZi" %}

## Python

### Wie man eine Eingabe referenziert

Ähnlich wie JavaScript erfordert Python nur die direkte Referenz auf den Variablennamen. Das obige Beispiel gilt also ebenso:

* `{{linkedin_url}}` wäre `linkedin_url`

### Wie man eine Ausgabe referenziert

Die Python-Syntax muss Klammern um den Variablennamen enthalten:

* `{{step_1.output}}` wäre `step_1["output"]`
* `{{step_1.output.key}}` wäre `step_1["output"]["key"]`

### Verwenden Sie eine Return-Anweisung

Sie müssen eine `return` Anweisung in einem Code-Schritt, um die Ausgabe des Schritts festzulegen.

### Unterstützte Python-Pakete

Stand: 13.02.2024:

```
pandas==1.3.4
requests
beautifulsoup4
lxml
pyjwt
urllib3==1.26.6
scipy
numpy
pycryptodome
bing-image-urls
markdown
PyPDF2
```

### Weitere Python-Pakete hinzufügen

Auch wenn wir unsere nativ unterstützten Pakete ständig erweitern, bietet unser Code-Schritt einen Workaround, um mit zusätzlichen Paketen zu arbeiten.

Fügen Sie beim Schreiben Ihres Code-Schritts den folgenden Code an Ihren Block an:

```python
import os
import sys
import subprocess

# benutzerdefiniertes Paket per pip in /tmp/ installieren und zum Pfad hinzufügen
subprocess.call('pip install flask -t /tmp/ --no-cache-dir'.split(), stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
sys.path.insert(1, '/tmp/')
import flask

return 'import ok'
```

{% hint style="info" %}
Hinweis: Alle externen Bibliotheken, die mit dieser Methode aufgerufen werden, werden bei jedem Ausführen des Code-Schritts installiert, was möglicherweise spürbare zusätzliche Sekunden an Ausführungszeit verursacht.
{% endhint %}

### Python-Beispiel

Gehen wir dasselbe Beispiel von oben durch, aber in Python:

{% @arcade/embed url="<https://app.arcade.software/share/gM15e94F8pxxwY3ExGy3>" flowId="gM15e94F8pxxwY3ExGy3" %}

## KI-Helfer

Sowohl Python als auch JavaScript unterstützen die Verwendung unseres KI-Helfers zur Codegenerierung. Das kann hilfreich sein, wenn Sie Schwierigkeiten haben, die genaue Syntax in einer der beiden Sprachen zu finden, um Ihr Ziel zu erreichen.

Ähnlich wie bei einer Eingabeaufforderung für ein LLM empfehlen wir, in Ihrer Beschreibung so klar und gründlich wie möglich zu sein.

{% @arcade/embed %}

Sobald unsere KI-Helfer den Code generiert haben, können Sie den generierten Text behalten oder ablehnen. Wenn Sie später den Code hinzufügen oder entfernen möchten, können Sie dieselbe Schaltfläche „Mit KI generieren“ verwenden, um Ihre Eingabeaufforderung und den Code anzupassen.

## So fahren Sie fort, wenn der Code-Schritt fehlschlägt

Standardmäßig beendet der Code-Schritt den Workflow, wenn er fehlschlägt. Um den Workflow jedoch fortzusetzen, wenn der Schritt fehlschlägt, klicken Sie einfach auf `Weiter` unten im Schritt.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-c22e0f91e9ed6f30b38662ce911f8280e9c9bdf4%2Fstep-errors-03-continue-strip.png?alt=media" alt="Web Page Scrape step with When the step fails set to Continue"><figcaption><p>Wählen Sie Weiter, um den Workflow bei einem fehlgeschlagenen Schritt weiterlaufen zu lassen.</p></figcaption></figure>

Der Schritt gibt die folgenden Schlüssel zurück:

* `Ausgabe` : dies wird `null`
* `Fehler` :
  * `Meldung`: die vom Schritt zurückgegebene Meldung
  * `Code` : der den Fehler repräsentierende Fehlercode

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-42ed8e1d814a64451a4759ec04fab8fc35e89eff%2Fstep-errors-01-error-variable.png?alt=media" alt="Variables Menu previewing the Export pass schedule step, whose output is null and whose error has a message and the code STEP_ERROR"><figcaption><p>Ein fehlgeschlagener Schritt gibt ein Fehlerobjekt mit einer Nachricht und einem Code zurück.</p></figcaption></figure>

## So versuchen Sie es erneut, wenn der Code-Schritt fehlschlägt

Um einen Schritt bei einem Fehler erneut auszuführen,

1. Wählen Sie `Weiter` anstatt `Workflow beenden` wenn der Schritt fehlschlägt
2. Fügen Sie eine Bedingung hinzu, die prüft, ob der `Fehler` aus dem Schritt vorhanden ist, z. B. `step_1.error`
3. Fügen Sie den Schritt hinzu, den Sie im Fehlerfall erneut ausführen möchten

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-0cf37b9938c96511e3d7292034d8f5dc8c74d168%2Fstep-errors-02-retry-condition.png?alt=media" alt="Condition step Retry if export failed that checks step_1.error, with the retry Run Code step on the True branch"><figcaption><p>Prüfen Sie, ob der Schritt fehlgeschlagen ist, und versuchen Sie es dann erneut.</p></figcaption></figure>

## Grenzen

Es gibt zwei wichtige Grenzen, die Sie in Bezug auf unseren Code-Schritt beachten sollten:

1. Sie haben eine maximale Laufzeit von 15 Minuten
2. Die maximale Payload-Größe beträgt 6 MB


---

# 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/logic-steps/code.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.
