> 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/testing-and-iteration.md).

# Teste e Iteração

Melhores práticas para testar e iterar no seu workflow

Testes e iteração são etapas fundamentais para criar um Workflow pronto para produção. Nesta seção, descreveremos as melhores práticas para testar e iterar no seu workflow.

## Modo de Teste Gratuito

A AirOps oferece **50.000 tarefas de teste gratuitas por mês** para testes no Studio. Você pode usar tarefas de teste para testes de Workflow e execuções iniciadas pelo editor do Playbook.

{% hint style="info" %}
As tarefas de teste estão disponíveis para todos os workspaces e são separadas da sua alocação de tarefas de produção. Testes de Workflow e execuções do editor do Playbook usam primeiro as tarefas de teste e, depois, usam tarefas de produção após o saldo de tarefas de teste se esgotar.
{% endhint %}

## Como Testar o Seu Workflow

Há duas maneiras de testar o seu workflow: uma etapa de cada vez ou todas as etapas de uma só vez.

Quando você testa uma etapa de cada vez, o valor de cada etapa será atualizado. **Quando você testa todas as etapas de uma vez, os valores de cada etapa só serão atualizados se a execução for bem-sucedida. No entanto, os valores não serão atualizados se você encontrar um erro.** Como resultado, a melhor prática é sempre testar uma etapa de cada vez até que o seu workflow esteja pronto para produção

### Testar Uma Etapa

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-49feaab0d98a7f42225e969b7f6dbd6fd8238f55%2Ftesting-01-test-step.png?alt=media" alt="Hover toolbar above the Search intent analysis step with the Test button"><figcaption><p>Teste uma única etapa na sua barra de ferramentas.</p></figcaption></figure>

* **Comece na etapa Inicial:** para começar a testar um workflow, você deve adicionar valores à etapa inicial
* **Clique na seta da primeira etapa:** isso executará apenas a primeira etapa
* **Use os logs para entender a saída da etapa a fim de referenciá-la em etapas futuras:** os logs são essenciais para entender a estrutura de dados da saída da etapa - use essa saída para ajudá-lo a referenciar esta etapa nas etapas subsequentes
* **Projete a(s) próxima(s) etapa(s):** continue projetando o seu workflow referenciando as etapas anteriores usando o botão rosa de ajuda de variável
* **Continue testando cada etapa subsequente:** depois de projetar uma etapa, clique no botão de reproduzir para testar a etapa. Continue esse processo até ter um workflow pronto para produção

### Testar Etapas em Condicionais

Você pode depurar etapas individuais dentro de ramificações condicionais (tanto os caminhos verdadeiro quanto falso). Isso facilita testar e iterar em workflows complexos com lógica de ramificação:

1. Navegue até a etapa condicional no seu workflow
2. Expanda a ramificação verdadeira ou falsa que você deseja testar
3. Clique no botão de reproduzir em qualquer etapa individual dentro da ramificação
4. A etapa será executada usando os valores de teste atuais, permitindo que você verifique a lógica em cada caminho

### Teste o seu Workflow completo

Há **duas opções para testar o seu workflow de ponta a ponta:**

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Opção 1:</strong> Clique em "Test Worfklow" na etapa Inputs</td><td><a href="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-b344a4178c2323ad80c4416d9533e65077c8b79e%2Ftesting-02-test-workflow.png?alt=media">testing-02-test-workflow.png</a></td></tr><tr><td><strong>Opção 2:</strong> Clique em "Test Workflow" no canto superior direito do Studio</td><td><a href="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-13a50703feb083ee872a66ef96601881bac66d3f%2Ffirst-workflow-06-test-publish.png?alt=media">first-workflow-06-test-publish.png</a></td></tr></tbody></table>

{% hint style="info" %}
Use o recurso **Test Workflow** quando o seu Workflow estiver pronto
{% endhint %}

* **Clique em Test Workflow:** clique **Test Workflow** no canto superior direito
* **Insira os seus valores de teste:** adicione os valores de teste que você deseja executar
* **Executar:** clique **Executar** para testar todo o workflow

## Melhores Práticas para Tratamento de Erros

Ao criar um workflow para produção, há casos extremos que você deve testar e tratar no seu workflow antes de executar em escala. Além disso, lembre-se de que você sempre pode pedir a [ajuda do Copilot para Corrigir Erros](https://docs.airops.com/docs/pt/acoes/workflow-concepts/chat-with-copilot/fix-errors-with-copilot.md) que encontrar durante os testes.

### 1. Limite da Janela de Contexto

Todo modelo de LLM tem uma janela máxima de contexto, o que significa que existe um número máximo de tokens (ou caracteres) que você pode ter no seu prompt antes que ele apresente erro.

{% hint style="info" %}
1 token geralmente corresponde a \~4 caracteres e \~3/4 de uma palavra.
{% endhint %}

1. Para garantir que o seu prompt permaneça dentro do limite da janela de contexto, você pode estimar o número de tokens que usará copiando e colando o seu prompt no contador de tokens da OpenAI a seguir: <https://platform.openai.com/tokenizer>
2. Para lidar com casos extremos em que o seu prompt excede o limite de tokens, você pode usar a seguinte sintaxe Liquid para dividir as suas entradas ou saídas de etapa em um trecho menor: `{{step_1.output | slice: 0, 10000}}`onde 10000 é substituído pelo número de caracteres que você quer dividir em partes.

### 2. Erros de Formatação do Prompt

Muitos workflows de produção de modelos de linguagem grandes dependem de uma formatação de saída consistente do modelo. Para garantir consistência no seu workflow, considere os seguintes métodos para lidar com saídas inesperadas do prompt:

1. **Técnicas de Prompt:**
   * Para evitar que o modelo introduza a sua resposta com uma frase como "*Claro, aqui está um...*", você pode adicionar um comando tanto no **Sistema** quanto no **Usuário** como "*Apresente a sua resposta no formato a seguir e não inclua nenhum comentário adicional:*"
   * Se a sua saída for HTML ou JSON, para evitar que o modelo comece com ` ```html ` ou ` ```json `, você pode dizer ao modelo *"Comece com #..."* ou *"Comece com {, e termine com } e não inclua ` ```json ` na sua resposta"*
2. **Análise de Código:**
   * Se você ainda estiver com dificuldades para obter uma saída consistente, ou se quiser lidar com casos extremos em que ela possa se desviar da saída esperada, você pode usar código para extrair qualquer texto que preceda o seu primeiro caractere.


---

# 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/testing-and-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.
