Executando, testando e publicando

​

Executando em Criar

​

Executando apenas uma etapa

​

Várias execuções ao mesmo tempo

​

Depurando uma execução

1. Abra a execução que falhou em Depurar e leia a Entrada da etapa (o que ela de fato recebeu) e o Erro.
2. Se uma referência trouxe um valor vazio, confira o chip @ em Criar: a etapa pode estar lendo texto quando precisava do arquivo, ou o valor está em outro atributo.
3. Corrija a etapa e use Executar Etapa N nela para validar, depois Reexecutar o Workflow inteiro.
4. Para testar a correção com as mesmas entradas, abra a execução antiga em Depurar e escolha Ações da execução › Editar no Craft: o Craft abre na versão mais recente, com as entradas dessa execução já preenchidas, pronto para Executar. Executar novamente, no mesmo menu, repete as entradas na mesma versão da execução original, então use-o para reproduzir um problema, não para conferir uma correção.

​

Casos de Teste

​

Publicando

​

Configurações do Workflow que vale conferir antes de publicar

• Execução → Execução paralela: roda etapas independentes ao mesmo tempo; etapas com dependências de dados continuam rodando em ordem. Ative quando o Workflow tem etapas que não dependem umas das outras e velocidade importa.
• Credenciais (administradores): quais credenciais o Workflow pode usar, e valores com escopo do Workflow. Veja Credenciais.
• Tags personalizadas: gravadas em toda execução, úteis para filtrar o Usage. Veja Tags.

​

Publicando um App

​

Chamando o Workflow pela API

curl -X POST https://api.tela.com/v2/chat/completions \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $TELA_API_KEY" \
    -d '{
        "canvas_id": "9d2e4f6a-1b3c-4d5e-8f70-1a2b3c4d5e6f",
        "variables": {
            "contract": { "file_url": "https://example.com/contracts/acme.pdf" },
            "requester": "maria@example.com"
        },
        "async": true
    }'

import { createTelaClient } from '@meistrari/tela-sdk-js'

const tela = createTelaClient({ apiKey: process.env.TELA_API_KEY })

const run = await tela.completions.create({
    canvasId: process.env.TELA_WORKFLOW_ID,
    variables: {
        contract: tela.createFile('https://example.com/contracts/acme.pdf'),
        requester: 'maria@example.com',
    },
    webhookUrl: 'https://example.com/webhooks/tela',
})

import os
from tela import create_tela_client

client = create_tela_client(api_key=os.getenv("TELA_API_KEY"))

run = client.completions.create(
    canvas_id=os.getenv("TELA_WORKFLOW_ID"),
    variables={
        "contract": client.create_file("https://example.com/contracts/acme.pdf"),
        "requester": "maria@example.com",
    },
    webhook_url="https://example.com/webhooks/tela",
)

​

Executando em uma agenda

• A agenda executa a versão que estiver em Production na hora da execução, então publicar uma nova versão em Production muda o que o próximo disparo roda.
• Pausar interrompe novos disparos; Retomar continua a partir do próximo horário previsto, sem repetir os perdidos.
• Uma agenda recorrente que continua falhando é pausada automaticamente e quem a criou é avisado.

​

Checklist antes de ir para produção

• Todas as etapas com nome, nenhuma Configuração pendente.
• Todo valor revisável é um atributo de um Formato de Saída.
• Os caminhos terminam do jeito que quem consome espera (mesmos atributos, ou um Conectar em uma etapa final).
• Casos de Teste revisados na versão que você está prestes a publicar.
• Credenciais criadas no Workspace e permitidas para este Workflow.
• Publicado em staging e chamado pela API uma vez, depois publicado em Production.