Custom blocks permitem empacotar um workflow deployado como um bloco reutilizável para toda a organização. Depois de publicado, o bloco aparece na toolbar de blocos do editor de workflow junto com blocos embutidos como Agent e Function. Qualquer pessoa na organização pode soltá-lo num workflow, preencher suas entradas e usar suas saídas — sem precisar de acesso ao workflow por trás.
Um custom block sempre roda a versão deployada mais recente do seu workflow fonte, então melhorar o bloco é tão simples quanto redeployar aquele workflow.
Usos comuns
Custom blocks transformam um workflow que um time possui em infraestrutura que toda a organização pode reutilizar com segurança. Credenciais e complexidade ficam com o autor do bloco; todo o resto ganha um bloco limpo que está sempre atualizado. Alguns padrões:
- Gateway de API interno. Envolva um endpoint interno ou de parceiro autenticado — "Create Ticket", "Charge Account", "Provision User" — atrás de um bloco que recebe só as entradas de negócio. Colegas o chamam sem a base URL, API key ou headers de auth, e quando o endpoint muda você atualiza um workflow em vez de cada consumidor.
- Busca de conhecimento abençoada. Empacote um pipeline de recuperação validado — chunking, filtros, reranking — como "Search Company Docs" com uma única entrada de query, para os times reutilizarem a recuperação aprovada em vez de cada um reconstruí-la.
- Passo de LLM governado. Compartilhe uma combinação de prompt, modelo e guardrail como "Summarize (house style)". Você controla o modelo e o prompt em toda a org; mudá-los é um redeploy, não uma caçada pelos workflows de todo mundo.
- Enriquecimento de dados. Exponha "Enrich Company" ou "Lookup Customer by Email" que esconde as keys do provedor e retorna campos limpos.
- Gate de compliance. Ofereça "Redact PII" ou "Policy Check" como um passo padronizado que os times soltam nos fluxos, com as regras mantidas num só lugar.
Antes de começar
- Deploye o workflow primeiro. Só workflows deployados podem ser publicados como bloco. Se o workflow não estiver deployado, deploye-o e depois volte.
- Seja admin do workspace. Publicar e gerenciar custom blocks exige acesso de admin do workspace.
Publicando um bloco
1. Abra as settings de Custom blocks
Vá em Settings → Enterprise → Custom blocks e clique em Create block.
2. Escolha o workflow fonte
| Campo | Descrição |
|---|---|
| Workspace | O workspace que guarda o workflow que você quer publicar. Só workspaces da sua organização são listados. |
| Workflow | O workflow a publicar. Só workflows deployados aparecem. Se um workflow não estiver deployado, deploye-o primeiro e depois volte aqui. |
O bloco roda o deployment mais recente do workflow fonte. Você publica um bloco por workflow, e o workflow fonte não pode ser mudado depois — para apontar para um workflow diferente, exclua o bloco e publique um novo.
3. Nomeie e descreva o bloco
| Campo | Descrição |
|---|---|
| Icon | Opcional. Uma imagem quadrada (PNG, JPEG, SVG ou WebP) mostrada no bloco. Cai no logo da sua organização e depois num glyph padrão. |
| Name | O nome de exibição do bloco na toolbar (ex.: Invoice Parser). Máx. 60 caracteres. |
| Description | Um resumo curto do que o bloco faz. Máx. 280 caracteres. |
4. Configure as entradas
Toda entrada no bloco Start do workflow fonte é exposta como um campo no custom block. Você não escolhe quais entradas incluir — todas são carregadas, junto com o nome, tipo e descrição de cada uma.
Para cada entrada você pode adicionar um placeholder opcional (máx. 200 caracteres) — o texto de dica mostrado no campo vazio para dizer aos consumidores o que informar.
Como as entradas são lidas ao vivo do workflow deployado, renomear ou adicionar uma entrada Start e redeployar atualiza os campos do bloco automaticamente.
5. Escolha as saídas
Escolha quais saídas do workflow os consumidores podem usar e dê a cada uma um nome. As saídas são agrupadas pelo bloco de origem, então você pode expor exatamente os valores que importam e esconder tudo interno.
- Pelo menos uma saída é obrigatória.
- Cada saída exposta precisa de um name único (máx. 60 caracteres) — esse é o nome que os consumidores referenciam nos workflows.
6. Salve
Clique em Save changes. O bloco é publicado imediatamente e fica disponível para todos na organização na toolbar de blocos do editor de workflow.
Usando um custom block
No editor de workflow, abra a toolbar de blocos. Custom blocks publicados aparecem sob uma seção Custom blocks. Arraste um para o canvas como qualquer outro bloco, preencha suas entradas (usando os placeholders como guia) e referencie suas saídas em blocos downstream.
Consumidores não precisam de nenhum acesso ao workflow fonte. O bloco roda sozinho, usando só as entradas fornecidas, e retorna só as saídas que você expôs. Passos internos, modelos e valores intermediários do workflow fonte nunca ficam visíveis.
Gerenciando blocos
Abra um bloco em Settings → Enterprise → Custom blocks para editá-lo ou excluí-lo.
- Editar muda só a apresentação e a interface do bloco — nome, descrição, ícone, placeholders de entrada e saídas expostas. O workflow fonte não pode ser reapontado.
- Mudar o que o bloco faz é feito editando e redeployando o workflow fonte. O bloco pega o novo deployment automaticamente; não há nada para republicar.
- Excluir um bloco é permanente. Workflows que já o usam terão aquele bloco removido, então substitua-o antes de excluir se estiver em uso ativo.
Bom saber
- Sempre atual. Um custom block roda o deployment mais recente do workflow fonte. Não há versões para fixar ou gerenciar.
- Access control. Custom blocks aparecem em Access Control junto com blocos embutidos, então você pode allowlistá-los ou restringi-los por grupo de permissão.
- Blocos desabilitados. Um bloco desabilitado não pode ser adicionado a novos workflows, mas placements existentes continuam funcionando.
- Blocos removidos. Excluir um bloco (ou excluir seu workflow fonte) o remove dos workflows que o usavam.
- Não deployado. Se o workflow fonte for undeployado, o bloco mostra um erro claro quando roda. Redeploye o workflow para corrigir.