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

Conceitos-chave

Skills vs Tools

O que conta como uma execução?

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

Cenário 1: Skill principal

Você inicia uma Skill chamada “Suporte ao Cliente”. Durante a conversa:
  • A Skill troca 20 mensagens com o usuário
  • Chama uma Tool “Verificar Saldo”
  • Transfere para outra Skill “Pesquisa de Satisfação”
Resultado: uma execução
2

Cenário 2: Tool independente

Você executa diretamente uma Tool via API (sem passar por uma Skill):
  • A Tool realiza seu cálculo e finaliza
Resultado: uma execução
Tools não podem chamar outras Skills ou Tools. Elas são unidades atômicas.

O que está incluído no custo?

✅ Incluído em uma execução

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

💰 Cobrado separadamente

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

Exemplos práticos

Um usuário inicia uma conversa → sua Skill “Suporte” o atende → chama 3 Tools diferentes (validar usuário, consultar histórico, criar ticket) → transfere para a Skill “Escalação” → encerra a conversa.Total: 1 execução
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 fluxo)
Seu sistema externo chama a Tool “Calcular Desconto” 50 vezes durante o dia.Total: 50 execuções

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 fluxo entre Skills ou chame Tools. Você pode acessá-lo a partir de qualquer nó usando:
  {{$context.executionId}}

Resumo

No Brain Studio, você paga por resolver problemas completos, não por cada etapa do processo. Isso permite criar fluxos complexos e conversas longas sem se preocupar com o aumento dos custos.
A arquitetura de execução incentiva a modularidade: você pode orquestrar fluxos complexos (Skill → Tool → Skill) sem inflar os custos, permitindo que você se concentre em criar a melhor experiência possível.

Artigos relacionados