Iniciar

O bloco Start é o trigger padrão para workflows construídos no ZippyVendas. Ele coleta entradas estruturadas e distribui para o resto do seu grafo para testes de editor, deployments de API e experiências de chat.

O bloco Start se senta no slot inicial quando você cria um workflow. Mantenha-o lá quando você quer que o mesmo ponto de entrada sirva rodadas de editor, requisições de deploy-para-API e sessões de chat. Troque-o com triggers Webhook ou Schedule quando você só precisa de execução acionada por eventos.

Campos expostos pelo Start

O bloco Start emite diferentes dados dependendo da superfície de execução:

Campos de Input Format — Cada campo que você adiciona se torna disponível como <start.fieldName>. Por exemplo, um campo customerId aparece como <start.customerId> em blocos e templates subsequentes.
Campos só de Chat — Quando o workflow roda a partir do painel lateral de chat ou uma experiência de chat deployada, ZippyVendas também fornece <start.input> (mensagem de usuário mais recente), <start.conversationId> (id de sessão ativa) e <start.files> (anexos de chat).

Mantenha campos de Input Format limitados aos nomes que você espera referenciar depois—esses valores são os únicos campos estruturados compartilhados entre execuções de editor, API e chat.

Configure o Input Format

Use o sub-bloco Input Format para definir o schema que se aplica através de modos de execução:

Adicione um campo para cada valor que você quer coletar.
Escolha um tipo (string, number, boolean, object, array ou files). Campos de arquivo aceitam uploads de callers de chat e API.
Forneça valores padrão quando você quer que o modal de execução manual popule dados de teste automaticamente. Estes padrões são ignorados para execuções deployadas.
Reordene campos para controlar como eles aparecem na forma de editor.

Referencie valores estruturados downstream com expressões como <start.customerId> dependendo do bloco que você conecta.

Como ele se comporta por ponto de entrada

Quando você clica Run no editor, o bloco Start renderiza o Input Format como uma forma. Valores padrão facilitam reteste sem redigitar dados. Submeter a forma dispara o workflow imediatamente e os valores se tornam disponíveis em <start.fieldName> (por exemplo <start.sampleField>).

Campos de arquivo na forma fazem upload diretamente para o correspondente <start.fieldName>; use esses valores para alimentar ferramentas downstream ou passos de armazenamento.

Deploy para API transforma o Input Format em um contrato JSON para clientes. Cada campo se torna parte do corpo da requisição, e ZippyVendas força tipos primitivos na ingestão. Campos de arquivo esperam objetos que referenciam arquivos uploadados; use o endpoint de upload de arquivo de execução antes de invocar o workflow.

Callers de API podem incluir propriedades opcionais adicionais. Elas são preservadas dentro de saídas <start.fieldName> então você pode experimentar sem fazer redeploy imediatamente.

Em deployments de chat o bloco Start se liga à conversa ativa. A mensagem mais recente preenche <start.input>, o identificador de sessão está disponível em <start.conversationId> e anexos de usuário aparecem em <start.files>, junto com quaisquer campos de Input Format limitados como <start.fieldName>.

Se você lançar chat com contexto estruturado adicional (por exemplo de um embed), ele se mescla no correspondente <start.fieldName> saídas, mantendo blocos downstream consistentes com execuções de API e manuais.

Referenciando dados de Start downstream

Conecte <start.fieldName> diretamente em agentes, ferramentas ou funções que esperam payloads estruturados.
Use sintaxe de templating como <start.sampleField> ou <start.files[0].url> (chat only) em campos de prompt.
Mantenha <start.conversationId> à mão quando você precisa agrupar saídas, atualizar histórico de conversa ou chamar de volta para a API de chat.

Melhores Práticas

Trate o bloco Start como o único ponto de entrada quando você quer suportar ambos API e callers de chat.
Prefira campos nomeados de Input Format sobre parsing JSON bruto em nós downstream; type coercion acontece automaticamente.
Adicione validação ou roteamento imediatamente após Start se certos campos são requeri dos para seu workflow suceder.