> ## Documentation Index > Fetch the complete documentation index at: https://docs.tela.com/llms.txt > Use this file to discover all available pages before exploring further. # Como um Workflow funciona > O que é um Workflow, como a página dele é organizada e como ele vai de Rascunho a App ou API Um **Workflow** encadeia etapas em um processo automatizado que sempre roda do mesmo jeito: ler um documento, decidir algo sobre ele, produzir um resultado. Cada etapa é um **módulo** que você escolhe em um menu e configura no editor, sem código a menos que você queira. Esta seção explica cada módulo, como as etapas passam valores entre si e como você executa, depura, testa e publica o resultado. Se você nunca abriu um Workflow, comece por [Seu primeiro Workflow](https://docs.tela.com/pt/creating-your-first-workflow.md). Esta seção vai mais fundo. ## O exemplo desta seção Todas as páginas desta seção usam o mesmo processo, um Workflow de **roteamento de contratos**. Os nomes das etapas, das Entradas e dos atributos aparecem em inglês para que os trechos de código sejam os mesmos da documentação em inglês: 1. **Extract Data** (Módulo de IA) lê um contrato e devolve a contraparte, o valor total, as datas e um resumo curto. 2. **Route by value** (Condição) verifica o valor total. 3. Se o valor passa de 100.000, **Draft Escalation Note** (Módulo de IA) escreve uma nota para o jurídico. Caso contrário, **Approval Letter** (Document Templater) preenche um template `.docx` e gera a carta. Uma segunda variante divide um contrato longo em páginas e extrai cada uma com um **Mapear**, depois junta as partes com uma etapa de **Execução de Código**. ![Workflow de roteamento de contratos em Criar, com Extract Data, Normalize Values, Route by value e os dois caminhos](https://mintcdn.com/meistrari/M2w7BduKZAFA1Sbx/images/pt/workflow/overview-graph.png?fit=max\&auto=format\&n=M2w7BduKZAFA1Sbx\&q=85\&s=b4c331b4e926191cb100f15d02a3cec8) ## Workflow, Canvas ou Agente? | Sua tarefa | Use | | - | - | | Uma instrução resolve: extrair campos, classificar uma mensagem, resumir um relatório | **Canvas** | | Várias etapas que você consegue desenhar de antemão, com decisões, repetição sobre documentos ou arquivos gerados | **Workflow** | | Etapas que você não consegue definir de antemão, serviços externos, uma conversa de ida e volta | **Agente** | Um Workflow pode reaproveitar um Canvas ou um Agente existente como uma de suas etapas, então você pode começar com um Canvas e evoluir para um Workflow depois. Veja [Conceitos-chave](https://docs.tela.com/pt/key-concepts.md#canvas-workflow-ou-agente) para a comparação completa. ## Anatomia da página do Workflow A página do Workflow tem quatro experiências no topo: **Criar**, **Depurar**, **Testar** e **Usage**. ![Cabeçalho do Workflow com o seletor de experiências, o botão de versão, o link e o botão Publicar](https://mintcdn.com/meistrari/M2w7BduKZAFA1Sbx/images/pt/workflow/header.png?fit=max\&auto=format\&n=M2w7BduKZAFA1Sbx\&q=85\&s=4edfb791c9be5ef32f68da029020425e) Em **Criar**: * **Lado esquerdo: as etapas.** Um Workflow novo abre com o seletor de módulos. Cada etapa é um cartão; passe o mouse sobre o conector abaixo de um cartão e clique em **+** para adicionar a próxima. Clicar em uma etapa abre a configuração dela. Uma Condição abre os caminhos lado a lado, e um Mapear mostra as etapas que rodam dentro dele. * **Lado direito: Entradas e Executar.** A seção **Entradas** é onde você declara o que o Workflow recebe (**Criar Variável**) e onde preenche os valores antes de uma execução. Abaixo, **Executar** inicia o Workflow, e o resultado de cada etapa aparece no mesmo painel quando a execução termina, nas abas **Preview** e **Debug**. ![Experiência Criar com o seletor de módulos aberto no grafo e o painel de Entradas à direita](https://mintcdn.com/meistrari/M2w7BduKZAFA1Sbx/images/pt/workflow/overview-picker.png?fit=max\&auto=format\&n=M2w7BduKZAFA1Sbx\&q=85\&s=f043c01ae0a6be9666e4ef136b2ebba9) O cabeçalho também traz o título, o botão de versão (por exemplo `VER-3`), **Compartilhar**, **Publicar** e o menu `…` com **Mover para projeto**, **Conectar via API**, **Execução**, tags, credenciais, renomear, exportar e excluir. As outras experiências: * **Depurar** lista todas as execuções do Workflow, independentemente de quem as iniciou (Criar, um Caso de Teste, um App da Workstation, a API ou uma agenda), e permite inspecionar cada etapa de uma execução. * **Testar** guarda os seus Casos de Teste e os resultados deles, como em um Canvas. * **Usage** mostra as execuções do Workflow publicado, quando habilitado para o seu Workspace. > [!NOTE] > > **Testar** fica oculta quando o armazenamento de arquivos está desabilitado no seu Workspace, e **Usage** exige que o monitoramento esteja habilitado. Se você não as vê, fale com o time do Tela. ## Os módulos O seletor de módulos agrupa os módulos em abas: **Tudo**, **Módulos**, **Recursos**, **Templates** e **Ações**. ![Seletor de módulos com os grupos Módulos e Recursos](https://mintcdn.com/meistrari/M2w7BduKZAFA1Sbx/images/pt/workflow/module-picker.png?fit=max\&auto=format\&n=M2w7BduKZAFA1Sbx\&q=85\&s=8fe9b0520e75d2b441a4dfa50adac740) | Grupo | Módulo | O que faz | Página | | - | - | - | - | | Módulos | **Módulo de IA** | Escreve um prompt, escolhe um modelo e estrutura a saída, como um Canvas | [Módulo de IA e Classificação](https://docs.tela.com/pt/workflow/ai-module-and-classifier.md) | | Módulos | **Classificação** | Responde perguntas tipadas (escolha, pontuação, sim/não) sobre os dados, com probabilidades | [Módulo de IA e Classificação](https://docs.tela.com/pt/workflow/ai-module-and-classifier.md) | | Módulos | **Agent Existente** | Executa um Agente publicado do seu Workspace | [Reaproveitando Canvases, Agentes e templates](https://docs.tela.com/pt/workflow/reusing-canvases-agents-and-templates.md) | | Módulos | **Canvas Existente** | Executa um Canvas publicado (ou outro Workflow) | [Reaproveitando Canvases, Agentes e templates](https://docs.tela.com/pt/workflow/reusing-canvases-agents-and-templates.md) | | Módulos | **Execução de Código** | Roda JavaScript ou TypeScript sobre os dados entre as etapas | [Execução de Código](https://docs.tela.com/pt/workflow/code-execution.md) | | Módulos | **Condição** | Envia a execução por um entre vários caminhos | [Condições e caminhos](https://docs.tela.com/pt/workflow/conditions-and-branches.md) | | Recursos | **Dividir** | Quebra um PDF ou CSV em páginas, blocos ou documentos lógicos | [Dividir, Recortar e Mapear](https://docs.tela.com/pt/workflow/documents-split-crop-map.md) | | Recursos | **Recortar** | Mantém só algumas páginas de um PDF | [Dividir, Recortar e Mapear](https://docs.tela.com/pt/workflow/documents-split-crop-map.md) | | Recursos | **Document Templater** | Gera um documento a partir de um template `.docx`; aparece no grafo como **Gerar Documento** | [Reaproveitando Canvases, Agentes e templates](https://docs.tela.com/pt/workflow/reusing-canvases-agents-and-templates.md) | | Recursos | **Mapear** | Repete um grupo de etapas para cada item de uma lista | [Dividir, Recortar e Mapear](https://docs.tela.com/pt/workflow/documents-split-crop-map.md) | | Ações | **Parar** | Encerra o Workflow naquele ponto de um caminho | [Condições e caminhos](https://docs.tela.com/pt/workflow/conditions-and-branches.md) | | Ações | **Conectar** | Liga um caminho a uma etapa de outro caminho | [Condições e caminhos](https://docs.tela.com/pt/workflow/conditions-and-branches.md) | A aba **Templates** insere um template de Workflow pronto no seu grafo. > [!NOTE] > > O seletor mostra uma lista fixa de módulos. O que muda entre Workspaces é se o recurso de Workflow em si está habilitado. ## Como uma execução acontece 1. Você preenche as **Entradas** e clica em **Executar**. 2. As etapas rodam em ordem. Cada etapa recebe os valores que referencia: Entradas e saídas das etapas anteriores. Veja [Entradas e referências](https://docs.tela.com/pt/workflow/inputs-and-references.md). 3. Uma **Condição** escolhe um caminho; as etapas dos outros caminhos aparecem como **Pulado**. 4. Um **Mapear** roda as etapas internas uma vez por item, em paralelo, e devolve a lista de resultados. 5. A execução termina na última etapa do caminho que ela seguiu. A saída dessa etapa é o resultado da execução, e a saída de todas as etapas continua disponível no painel de resultado, em **Depurar** e pela API. Veja [Saídas e resultados](https://docs.tela.com/pt/workflow/outputs-and-results.md). Por padrão as etapas rodam uma depois da outra. Em `…` → **Execução**, **Execução paralela** permite que etapas independentes rodem ao mesmo tempo; etapas que dependem dos dados umas das outras continuam rodando em ordem. ## Ciclo de vida: Rascunho, Projeto, publicação, App e API ``` Rascunho (privado) → Mover para projeto → Publicar uma versão em um ambiente → App / API / agenda ``` * Um Workflow criado a partir do Dashboard começa como **Rascunho**, visível só para você. Dá para construir, executar e testar por completo como Rascunho. * **Mover para projeto** (no menu `…`, ou pedido automaticamente quando você clica em **Publicar**) deixa o Workflow visível para o seu time. Isso não pode ser desfeito. * **Publicar** cria uma versão estável e a coloca em um ambiente (**Production** por padrão). Apps, chamadas de API e agendas usam a versão publicada, então você pode continuar editando sem afetá-los. * No diálogo de publicação, **Publicar App** cria um [App da Workstation](https://docs.tela.com/pt/workstation/creating-apps.md), onde o seu time envia documentos e revisa resultados. **Conectar via API** mostra o ID e um snippet para executar o Workflow a partir dos seus sistemas. Veja [Executando, testando e publicando](https://docs.tela.com/pt/workflow/running-testing-and-publishing.md) para cada uma dessas etapas. ## Nesta seção > **[Entradas e referências](https://docs.tela.com/pt/workflow/inputs-and-references.md)** > > Declare o que o Workflow recebe e passe valores entre etapas com o menu `@` > **[Módulo de IA e Classificação](https://docs.tela.com/pt/workflow/ai-module-and-classifier.md)** > > Prompt, modelo e Formato de Saída por etapa; avaliações tipadas com a Classificação > **[Condições e caminhos](https://docs.tela.com/pt/workflow/conditions-and-branches.md)** > > Roteie a execução com condições, Senão, Parar e Conectar > **[Dividir, Recortar e Mapear](https://docs.tela.com/pt/workflow/documents-split-crop-map.md)** > > Trabalhe página por página ou documento por documento > **[Execução de Código](https://docs.tela.com/pt/workflow/code-execution.md)** > > Transforme dados com uma função pequena, com credenciais e bibliotecas > **[Reaproveitando Canvases, Agentes e templates](https://docs.tela.com/pt/workflow/reusing-canvases-agents-and-templates.md)** > > Canvas Existente, Agent Existente e Document Templater > **[Saídas e resultados](https://docs.tela.com/pt/workflow/outputs-and-results.md)** > > O que uma execução devolve e onde ler: painel de resultado, Depurar, App, API, Testar > **[Executando, testando e publicando](https://docs.tela.com/pt/workflow/running-testing-and-publishing.md)** > > Executar, executar uma etapa, Depurar, Casos de Teste, Publicar, Publicar App, API e agendas This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.