> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Execuções de Workflow

> Entenda como funcionam as execuções no Brain Studio e seu impacto no faturamento

Uma **execução de workflow** é a principal unidade de medida no Brain Studio. Ela representa o ciclo completo desde quando um workflow é acionado até que ele conclui seu trabalho, independentemente de quantas mensagens são trocadas ou de quantas etapas internas são executadas.

## Conceitos-chave

### Workflows vs Tools

<CardGroup cols={2}>
  <Card title="Workflow" icon="comments" href="/pt/guias/primeiros-passos/seu-primeiro-workflow">
    Projetado para conversar com usuários. Contém nós de mensagem (texto, imagens, botões) e nós de lógica (código, API, condicionais).
  </Card>

  <Card title="Tool" icon="wrench" href="/pt/guias/ferramentas/sua-primeira-tool">
    Projetada para executar operações técnicas. Contém apenas nós de lógica. Não conversa, apenas processa.
  </Card>
</CardGroup>

## O que conta como uma execução?

A regra é simples: **um início de workflow = uma execução**, independentemente de quantos processos internos sejam executados.

<Steps>
  <Step title="Cenário 1: Workflow principal">
    Você inicia um Workflow chamado "Suporte ao Cliente". Durante a conversa:

    * O Workflow troca 20 mensagens com o usuário
    * Chama uma Tool "Verificar Saldo"
    * Transfere para outro Workflow "Pesquisa de Satisfação"

    **Resultado**: uma execução
  </Step>

  <Step title="Cenário 2: Tool independente">
    Você executa diretamente uma Tool via API (sem passar por um Workflow):

    * A Tool realiza seu cálculo e finaliza

    **Resultado**: uma execução

    <Note>
      Tools não podem chamar outros Workflows ou Tools. Elas são unidades atômicas.
    </Note>
  </Step>
</Steps>

## O que está incluído no custo?

### ✅ Incluído em uma execução

* O início do workflow (Workflow ou Tool)
* Todas as transferências internas (Workflow → Workflow)
* O uso de tools internas (Workflow → Tool)
* **Mensagens ilimitadas** dentro da mesma sessão

### 💰 Cobrado separadamente

* **[Tokens do modelo de IA](/pt/guias/agentes-ia/tokens)**: O processamento de linguagem natural é cobrado de acordo com o uso do modelo (GPT-4, Claude, etc.)
* **[KYC](/pt/guias/integracoes/identidade/index-kyc)**: As verificações de identidade têm um custo independente por validação realizada.
* **[Assinatura eletrônica](/pt/guias/integracoes/firma/firma)**: Cada processo de assinatura é cobrado individualmente.
* **[Tools transacionais](/pt/guias/integracoes/pagamentos/introducao)**: Tools que realizam operações transacionais (pagamentos, cobranças, etc.) têm sua própria tarifa por transação executada.

## Exemplos práticos

<AccordionGroup>
  <Accordion title="Workflow de suporte ao cliente">
    Um usuário inicia uma conversa → seu Workflow "Suporte" o atende → chama 3 Tools diferentes (validar usuário, consultar histórico, criar ticket) → transfere para o Workflow "Escalação" → encerra a conversa.

    **Total**: 1 execução
  </Accordion>

  <Accordion title="Múltiplas conversas do mesmo usuário">
    Um usuário entra em contato 3 vezes no mesmo dia:

    * 9h00 - Pergunta sobre o saldo
    * 14h00 - Solicita um relatório
    * 18h00 - Pede para atualizar os dados

    **Total**: 3 execuções (cada conversa inicia um novo workflow)
  </Accordion>

  <Accordion title="Chamada direta de Tool via API">
    Seu sistema externo chama a Tool "Calcular Desconto" 50 vezes durante o dia.

    **Total**: 50 execuções
  </Accordion>
</AccordionGroup>

## Obtendo um ID de execução

Quando você inicia uma execução, recebe um identificador único (`executionId`) que o Brain Studio gera automaticamente. Esse ID permanece constante durante toda a execução, mesmo que você transfira o workflow entre Workflows ou chame Tools.

Você pode acessá-lo a partir de qualquer nó usando:

```
  {{$context.executionId}}
```

## Resumo

<Tip>
  No Brain Studio, você paga por resolver problemas completos, não por cada etapa do processo. Isso permite criar workflows complexos e conversas longas sem se preocupar com o aumento dos custos.
</Tip>

A arquitetura de execução incentiva a modularidade: você pode orquestrar workflows complexos (Workflow → Tool → Workflow) sem inflar os custos, permitindo que você se concentre em criar a melhor experiência possível.

## Artigos relacionados

<CardGroup cols={2}>
  <Card title="Como funciona o faturamento" icon="file-invoice" href="/pt/guias/faturamento/introducao">
    Conceitos-chave sobre o faturamento no nível da organização no Jelou.
  </Card>

  <Card title="Preços" icon="tag" href="/pt/guias/faturamento/precios">
    Detalhes de preços para conversas, campanhas e assentos do Connect.
  </Card>

  <Card title="Sua Primeira Tool" icon="wrench" href="/pt/guias/ferramentas/sua-primeira-tool">
    Crie sua primeira Tool do zero e publique-a para reutilizá-la em seus workflows.
  </Card>

  <Card title="Workflows com IA" icon="robot" href="/pt/guias/primeiros-passos/workflows-com-ia">
    Configure um Agente de IA que coleta dados dos seus usuários.
  </Card>

  <Card title="Variáveis de Contexto" icon="code" href="/pt/guias/variaveis/context">
    Acesse o executionId e outras variáveis disponíveis durante a execução.
  </Card>
</CardGroup>