> 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/es/acciones/workflow-concepts/workflow-steps/logic-steps/code.md).

# Ejecutar código

Añade lógica personalizada con Javascript o Python

## ¿Cómo funciona el paso de código?

El paso de código en AirOps Studio actualmente admite **JavaScript** como en el **Python**, lo que te proporciona la flexibilidad necesaria para realizar solicitudes avanzadas.

{% hint style="warning" %}
El código en un paso de código se encapsula dentro de una función, y debes usar una **return** sentencia para obtener resultados del paso.
{% endhint %}

<figure><img src="https://3036434873-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>Un ejemplo de paso Ejecutar código.</p></figcaption></figure>

## JavaScript

### Cómo hacer referencia a una entrada

A diferencia de Liquid, las variables de JavaScript **omiten** `{{` o `}}` . Por ejemplo:

* `{{linkedin_url}}` sería `linkedin_url`

### Cómo hacer referencia a una salida

La sintaxis de JavaScript es similar a Liquid, pero omite los corchetes:

* `{{step_1.output}}` sería `step_1.output`
* `{{step_1.output.name}}` sería `step_1.output.name`

### Usa una sentencia return

Debes incluir una `return` sentencia en un paso de código para determinar la salida del paso

### Ejemplo de JavaScript

Veamos un ejemplo que hace referencia tanto a una entrada de texto como a una salida de LLM. Usaremos un flujo de trabajo básico que solicita una entrada de cadena y devuelve una coincidencia de palabras que riman con ella.

Nuestro paso de código simplemente se encargará de combinar el prompt de entrada con la salida del LLM, de modo que tengamos un único resultado que incluya la pregunta y la respuesta:

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

## Python

### Cómo hacer referencia a una entrada

De manera similar a JavaScript, Python solo requiere la referencia directa al nombre de la variable. Así que el mismo ejemplo anterior sigue siendo válido:

* `{{linkedin_url}}` sería `linkedin_url`

### Cómo hacer referencia a una salida

La sintaxis de Python debe incluir corchetes alrededor del nombre de la variable:

* `{{step_1.output}}` sería `step_1["output"]`
* `{{step_1.output.key}}` sería `step_1["output"]["key"]`

### Usa una sentencia return

Debes incluir una `return` sentencia en un paso de código para determinar la salida del paso.

### Paquetes de Python compatibles

A partir del 13/2/2024:

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

### Añadir paquetes de Python adicionales

Aunque siempre estamos buscando añadir más paquetes compatibles de forma nativa, nuestro paso de código ofrece una solución alternativa para trabajar con paquetes adicionales.

Al escribir tu paso de código, añade el siguiente código a tu bloque:

```python
import os
import sys
import subprocess

# instalar paquete personalizado con pip en /tmp/ y añadir al path
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" %}
Nota: cualquier biblioteca externa llamada con este método se instalará cada vez que se ejecute el paso de código, lo que podría añadir varios segundos notables al tiempo de ejecución.
{% endhint %}

### Ejemplo de Python

Veamos el mismo ejemplo anterior, pero en Python:

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

## Asistentes de IA

Tanto Python como JavaScript admiten el uso de nuestro asistente de IA para generar código. Esto puede ser útil si te cuesta encontrar la sintaxis exacta en cualquiera de los dos lenguajes para lograr tu objetivo.

Al igual que con un prompt para un LLM, recomendamos ser lo más claro y exhaustivo posible en tu descripción.

{% @arcade/embed %}

Una vez que nuestros asistentes de IA hayan generado el código, puedes conservar o rechazar el texto generado. Si decides que quieres añadir o eliminar el código más adelante, puedes usar el mismo botón "Generar con IA" para modificar tu prompt y código.

## Cómo continuar si falla el paso de código

De forma predeterminada, el paso de código terminará el flujo de trabajo si falla. Sin embargo, para continuar el flujo de trabajo si el paso falla, simplemente haz clic `Continuar` en la parte inferior del paso.

<figure><img src="https://3036434873-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>Selecciona Continuar para mantener el flujo de trabajo en ejecución cuando el paso falle.</p></figcaption></figure>

El paso devolverá las siguientes claves:

* `salida` : esto será `nulo`
* `error` :
  * `mensaje`: el mensaje devuelto por el paso
  * `código` : el código de error que representa el error

<figure><img src="https://3036434873-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>Un paso fallido devuelve un objeto de error con un mensaje y un código.</p></figcaption></figure>

## Cómo reintentar si falla el paso de código

Para reintentar un paso si falla,

1. Selecciona `Continuar` en lugar de `Terminar el flujo de trabajo` si el paso falla
2. Añade una condición en la que se compruebe si el `error` del paso existe, por ejemplo: `step_1.error`
3. Añade el paso que quieras reintentar si hubo un error

<figure><img src="https://3036434873-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>Comprueba si el paso falló y luego inténtalo de nuevo.</p></figcaption></figure>

## Límites

Hay dos límites principales que debes tener en cuenta con respecto a nuestro paso de código:

1. Tienen un tiempo máximo de ejecución de 15 minutos
2. El tamaño máximo de la carga útil es de 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/es/acciones/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.
