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

# Executar Código

Adicione lógica personalizada com Javascript ou Python

## Como funciona o Passo de Código?

O Passo de Código no AirOps Studio atualmente suporta **JavaScript** quanto no **Python**, o que lhe proporciona a flexibilidade necessária para realizar pedidos avançados.

{% hint style="warning" %}
O código num Passo de Código é encapsulado dentro de uma função, e deve usar uma **return** instrução para apresentar os resultados do passo.
{% endhint %}

<figure><img src="https://31915162-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>Um exemplo de um passo Executar Código.</p></figcaption></figure>

## JavaScript

### Como Referenciar uma Entrada

Ao contrário do Liquid, as variáveis JavaScript **excluem** `{{` ou `}}` . Por exemplo:

* `{{linkedin_url}}` seria `linkedin_url`

### Como Referenciar uma Saída

A sintaxe de JavaScript é semelhante à do Liquid, mas exclui as chavetas:

* `{{step_1.output}}` seria `step_1.output`
* `{{step_1.output.name}}` seria `step_1.output.name`

### Use uma instrução return

Deve incluir uma `return` instrução num Passo de Código para determinar a saída do passo

### Exemplo de JavaScript

Vamos percorrer um exemplo que faz referência tanto a uma entrada de texto como a uma saída de LLM. Vamos usar um Workflow básico que solicita uma string de entrada e devolve uma correspondência de palavras que rimam com ela.

O nosso Passo de Código será simplesmente responsável por combinar o prompt de entrada com a saída do LLM, para que tenhamos apenas um único resultado que inclui a pergunta e a resposta:

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

## Python

### Como Referenciar uma Entrada

Semelhante ao JavaScript, o Python requer apenas a referência direta ao nome da variável. Por isso, o mesmo exemplo acima aplica-se:

* `{{linkedin_url}}` seria `linkedin_url`

### Como Referenciar uma Saída

A sintaxe de Python deve incluir colchetes em torno do nome da variável:

* `{{step_1.output}}` seria `step_1["output"]`
* `{{step_1.output.key}}` seria `step_1["output"]["key"]`

### Use uma instrução return

Deve incluir uma `return` instrução num Passo de Código para determinar a saída do passo.

### Pacotes Python Suportados

A partir de 13/02/2024:

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

### Adicionar Pacotes Python Adicionais

Embora estejamos sempre a procurar adicionar mais pacotes suportados nativamente, o nosso Passo de Código oferece uma solução alternativa para trabalhar com pacotes adicionais.

Ao escrever o seu Passo de Código, adicione o seguinte código ao seu bloco:

```python
import os
import sys
import subprocess

# pip install pacote personalizado em /tmp/ e adicionar ao 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: quaisquer bibliotecas externas chamadas com este método serão instaladas sempre que o Passo de Código for executado, o que pode acrescentar vários segundos notáveis ao tempo de execução.
{% endhint %}

### Exemplo de Python

Vamos percorrer o mesmo exemplo acima, mas em Python:

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

## Assistentes de IA

Tanto Python como JavaScript suportam o uso do nosso Assistente de IA para gerar código. Isto pode ser útil se estiver com dificuldades para encontrar a sintaxe exata em qualquer uma das linguagens para alcançar o seu objetivo.

Semelhante ao prompt para um LLM, recomendamos ser o mais claro e detalhado possível na sua descrição.

{% @arcade/embed %}

Assim que os nossos Assistentes de IA gerarem o código, pode manter ou rejeitar o texto gerado. Se decidir que quer adicionar ou remover o código mais tarde, pode usar o mesmo botão "Generate with AI" para modificar o seu prompt e código.

## Como continuar se o Passo de Código falhar

Por defeito, o passo de código terminará o workflow se falhar. No entanto, para continuar o workflow se o passo falhar, basta clicar `Continuar` na parte inferior do passo.

<figure><img src="https://31915162-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>Selecione Continuar para manter o Workflow em execução quando o passo falhar.</p></figcaption></figure>

O passo devolverá as seguintes chaves:

* `saída` : será `nulo`
* `erro` :
  * `mensagem`: a mensagem devolvida pelo passo
  * `código` : o código de erro que representa o erro

<figure><img src="https://31915162-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>Um passo falhado devolve um objeto de erro com uma mensagem e um código.</p></figcaption></figure>

## Como tentar novamente se o Passo de Código falhar

Para tentar novamente um passo se ele falhar,

1. Selecione `Continuar` em vez de `Terminar Workflow` se o passo falhar
2. Adicione uma condição em que a condição verifique se o `erro` do passo existe, por exemplo `step_1.error`
3. Adicione o passo que pretende tentar novamente se houver um erro

<figure><img src="https://31915162-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>Verifique se o passo falhou e tente novamente.</p></figcaption></figure>

## Limites

Há dois limites principais a ter em conta relativamente ao nosso Passo de Código:

1. Têm um tempo máximo de execução de 15 minutos
2. O tamanho máximo do payload é 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/pt/acoes/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.
