IceFold Documentação
Guias

Modelos de prompt

Qualquer Etapa cujo inspetor exiba o editor avançado Prompt template — incluindo Generate Text e Etapas criadas com Nós Personalizados — aceita a mesma sintaxe. Escreva @name, e o mecanismo substituirá o valor correto para a versão de conteúdo em execução. O campo simples Nome do arquivo de uma Etapa terminal aceita os mesmos marcadores, com o comportamento específico para nomes de arquivo descrito abaixo.

A regra

@name é resolvido como o rótulo, ou seja, o texto legível esperado por uma pessoa.

You are translating the document below into @Language.

Document:
@text

Dois tipos de nomes estão disponíveis, distinguidos no editor por cor:

  • Campos de entrada (verde) — @text, @image e qualquer item conectado a uma Etapa anterior. O valor é a saída dessa Etapa para a versão de conteúdo atual.
  • Grupos de versões (ciano) — @Language, @Platform, @Length, … um por grupo de versões declarado em seu Espaço. Renderiza como o rótulo legível do valor (中文, TikTok).

Ao adicionar um grupo de versões, o nome exato dele vira o marcador: Platform cria @Platform, Content Length cria @{Content Length} e 内容平台 cria @{内容平台}. Os nomes diferenciam maiúsculas e minúsculas nos prompts; nomes duplicados são rejeitados para que cada marcador identifique apenas um grupo.

Nomes desconhecidos recebem um sublinhado vermelho tracejado e uma sugestão "você quis dizer…?". Os nomes que não puderem ser resolvidos permanecerão inalterados no prompt final — o IceFold nunca remove silenciosamente o que não consegue resolver.

Forma delimitada: @{name}

Quando o texto adjacente seria lido como parte do identificador, envolva o nome em chaves. As duas formas substituem identicamente — as chaves são puramente uma ferramenta de desambiguação.

report_@{Target Language}.v1.txt   →   report_中文.v1.txt

Escape: @@

Para renderizar um @ literal — por exemplo, Hello @user em um texto — duplique-o:

Hello @@user   →   Hello @user

A duplicação se estende naturalmente: @@@@ renderiza @@. Um @ precedido por uma letra ou um dígito já é ignorado, portanto [email protected] permanece literal sem escape.

Recursos do editor

O campo Prompt template é mais do que uma área de texto. Enquanto você digita:

  • Barra de variáveis acima do editor lista cada variável disponível para esta Etapa, agrupada por origem. Clique para inserir. Campos de entrada não conectados aparecem esmaecidos.
  • Autocompletar abre quando você digita @. Digite @{ para mudar o menu para sugestões de forma delimitada.
  • Passe o mouse sobre qualquer variável para ver seu tipo e o valor resolvido na versão de conteúdo em visualização.
  • Painel de pré-visualização abaixo do editor reproduz a substituição real do servidor: escolha uma versão de conteúdo no menu e veja exatamente qual prompt o LLM receberá.

Resumo da gramática

Forma Renderiza
@name o rótulo de name nesta versão de conteúdo
@{name} o mesmo valor, com limites explícitos
@@ @ literal
[email protected] literal — @ após um caractere de palavra é texto
@unknown @unknown literal, marcado em vermelho no editor

Em Nome do arquivo, somente marcadores de grupos de versões são substituídos, e eles usam o ID do valor: @Language vira zh, não o rótulo legível 中文. Isso mantém os nomes exportados estáveis. Em campos Prompt template, @Language usa o rótulo.