Blocks personalizados

Os blocks personalizados permitem empacotar um workflow com deploy como um block reutilizável para toda a sua organização. Depois de publicado, o block aparece na barra de blocks do editor de workflow ao lado dos blocks nativos, como Agent e Function. Qualquer pessoa da sua organização pode colocá-lo em um workflow, preencher as entradas e usar as saídas — sem precisar de acesso ao workflow por trás dele.

Um block personalizado sempre executa a versão mais recente com deploy do workflow de origem, então melhorar o block é tão simples quanto refazer o deploy daquele workflow.

Usos comuns

Blocks personalizados transformam um workflow que um time mantém em infraestrutura que toda a organização pode reutilizar com segurança. As credenciais e a complexidade ficam com quem criou o block; todos os outros recebem um block limpo e sempre atualizado. Alguns padrões:

• Gateway de API interna. Encapsule um endpoint interno ou de parceiro autenticado — "Create Ticket", "Charge Account", "Provision User" — atrás de um block que recebe apenas as entradas de negócio. Seus colegas o chamam sem a base URL, a chave de API ou os headers de autenticação, e quando o endpoint muda você atualiza um workflow em vez do de cada consumidor.
• Busca em conhecimento aprovado. Empacote um pipeline de recuperação validado — chunking, filtros, reranking — como "Search Company Docs", com uma única entrada de consulta, para que os times reutilizem a recuperação aprovada em vez de reconstruí-la cada um por conta.
• Etapa de LLM governada. Compartilhe uma combinação de prompt, modelo e guardrails como "Summarize (house style)". Você controla o modelo e o prompt em toda a organização; mudá-los é um novo deploy, não uma caça pelos workflows de todo mundo.
• Enriquecimento de dados. Exponha "Enrich Company" ou "Lookup Customer by Email", que escondem as chaves do provedor e devolvem campos limpos.
• Barreira de conformidade. Ofereça "Redact PII" ou "Policy Check" como uma etapa padronizada que os times colocam nos fluxos deles, com as regras mantidas em um só lugar.

Antes de começar

• Faça o deploy do workflow primeiro. Só workflows com deploy podem ser publicados como block. Se o workflow ainda não tem deploy, faça o deploy e volte aqui.
• Seja admin do workspace. Publicar e gerenciar blocks personalizados exige acesso de admin do workspace.

Publicando um block

1. Abra as configurações de Custom blocks

Vá em Settings → Enterprise → Custom blocks e clique em Create block.

2. Escolha o workflow de origem

O block executa o deploy mais recente do workflow de origem. Você publica um block por workflow, e o workflow de origem não pode ser trocado depois — para apontar para outro workflow, exclua o block e publique um novo.

3. Dê nome e descrição ao block

4. Configure as entradas

Toda entrada do block Start do workflow de origem é exposta como um campo no block personalizado. Você não escolhe quais entradas incluir — todas são levadas, junto com o nome, o tipo e a descrição de cada uma.

Para cada entrada, você pode adicionar um placeholder opcional (máximo de 200 caracteres) — o texto de dica que aparece no campo vazio para indicar aos consumidores o que preencher.

Como as entradas são lidas ao vivo do workflow com deploy, renomear ou adicionar uma entrada no Start e refazer o deploy atualiza os campos do block automaticamente.

5. Escolha as saídas

Escolha quais saídas do workflow os consumidores podem usar e dê um nome a cada uma. As saídas são agrupadas pelo block de origem, então você pode expor exatamente os valores que importam e esconder tudo o que é interno.

• É obrigatório expor pelo menos uma saída.
• Cada saída exposta precisa de um nome único (máximo de 60 caracteres) — é esse o nome que os consumidores referenciam nos workflows deles.

6. Salve

Clique em Save changes. O block é publicado na hora e fica disponível para todos na sua organização, na barra de blocks do editor de workflow.

Usando um block personalizado

No editor de workflow, abra a barra de blocks. Os blocks personalizados publicados aparecem em uma seção Custom blocks. Arraste um deles para o workflow como qualquer outro block, preencha as entradas (usando os placeholders como guia) e referencie as saídas nos blocks seguintes.

Os consumidores não precisam de nenhum acesso ao workflow de origem. O block roda por conta própria, usando apenas as entradas informadas, e devolve apenas as saídas que você expôs. As etapas internas, os modelos e os valores intermediários do workflow de origem nunca ficam visíveis.

Gerenciando blocks

Abra um block em Settings → Enterprise → Custom blocks para editá-lo ou excluí-lo.

• Editar muda apenas a apresentação e a interface do block — nome, descrição, ícone, placeholders das entradas e saídas expostas. O workflow de origem não pode ser reapontado.
• Mudar o que o block faz é feito editando e refazendo o deploy do workflow de origem. O block adota o novo deploy automaticamente; não há nada para republicar.
• Excluir um block é permanente. Os workflows que já o usam ficam sem aquele block, então substitua-o antes de excluir se ele estiver em uso.

Bom saber

• Sempre atualizado. Um block personalizado executa o deploy mais recente do workflow de origem. Não há versões para fixar ou gerenciar.
• Controle de acesso. Blocks personalizados aparecem no Access Control ao lado dos blocks nativos, então você pode permiti-los ou restringi-los por grupo de permissões.
• Blocks desativados. Um block desativado não pode ser adicionado a novos workflows, mas os usos existentes continuam funcionando.
• Blocks removidos. Excluir um block (ou excluir o workflow de origem dele) o remove dos workflows que o usavam.
• Sem deploy. Se o deploy do workflow de origem for desfeito, o block mostra um erro claro ao ser executado. Refaça o deploy do workflow para resolver.