프롬프트 템플릿

인스펙터에 Prompt template 편집기가 표시되는 모든 단계(예: Generate Text와 사용자 정의 노드로 만든 단계)는 같은 구문을 지원합니다. @name을 쓰면 엔진이 단계가 실행 중인 콘텐츠 버전에 맞는 값으로 대체합니다. 터미널 단계의 일반 Export filename 필드도 같은 마커 문법을 사용하지만, 파일명에 적용되는 규칙은 아래 설명과 같습니다.

규칙

@name은 **라벨(label)**로 바뀝니다. 읽는 사람이 보기에 자연스러운 표시 이름입니다.

You are translating the document below into @Language.

Document:
@text

두 가지 종류의 이름을 사용할 수 있으며, 편집기에서 색상으로 구분됩니다:

• 입력 슬롯(Input slots) (녹색): @text, @image처럼 이전 단계에서 연결된 항목입니다. 이 콘텐츠 버전에서 이전 단계가 만든 출력으로 렌더링됩니다.
• 버전 그룹(Version groups) (청색): @Language, @Platform, @Length 등. 스페이스에서 선언된 버전 그룹당 하나씩 존재합니다. 해당 값의 표시 이름(中文, TikTok)으로 바뀝니다.

버전 그룹을 추가하면 정확한 그룹 이름이 마커가 됩니다. Platform은 @Platform, Content Length는 @{Content Length}, 内容平台는 @{内容平台}를 만듭니다. 프롬프트 이름은 대소문자를 구분하며, 각 마커가 하나의 그룹만 가리키도록 중복된 그룹 이름은 허용되지 않습니다.

알 수 없는 이름에는 빨간 점선 밑줄과 함께 "혹시 이 이름인가요?" 같은 제안이 표시됩니다. 해석하지 못한 이름은 최종 프롬프트에 그대로 남습니다. IceFold가 몰래 지워 버리는 일은 없습니다.

경계 형태: @{name}

바로 뒤에 오는 글자가 이름의 일부로 읽힐 수 있다면 이름을 중괄호로 감싸세요. 두 형태 모두 똑같이 바뀌며, 중괄호는 경계를 분명히 하는 용도일 뿐입니다.

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

이스케이프: @@

@를 글자 그대로 출력하려면(예: 본문 속 Hello @user) 두 번 겹쳐 쓰세요.

Hello @@user   →   Hello @user

같은 원리로 @@@@는 @@가 됩니다. 또한 영문자나 숫자 바로 뒤에 오는 @는 원래 무시되므로, [email protected]은 이스케이프하지 않아도 그대로 남습니다.

편집기 기능

프롬프트 템플릿 필드는 단순한 입력창이 아닙니다. 입력하는 동안 다음 기능을 쓸 수 있습니다.

• 변수 도구 모음: 편집기 위에 이 단계에서 사용할 수 있는 모든 변수를 출처별로 묶어 표시합니다. 클릭하면 삽입됩니다. 연결되지 않은 입력 슬롯은 흐리게 표시됩니다.
• 자동 완성: @를 입력하면 열립니다. @{를 입력하면 중괄호 형식의 제안으로 전환됩니다.
• 변수 도움말: 변수 위에 마우스를 올리면 현재 미리 보는 콘텐츠 버전에서 변수의 종류와 해석 결과를 확인할 수 있습니다.
• 미리보기 패널: 편집기 아래에 실제 서버의 치환 결과가 표시됩니다. 드롭다운에서 콘텐츠 버전을 선택하여 LLM이 받을 정확한 프롬프트를 확인하세요.

문법 요약

형태	출력 결과
@name	이 콘텐츠 버전의 name에 대한 라벨
@{name}	위와 같음 (경계를 명시)
@@	@ 그대로
[email protected]	그대로 — 영문자·숫자 뒤의 @는 본문으로 취급
@unknown	@unknown 그대로, 편집기에서 빨간색으로 표시

Export filename에서는 버전 그룹 마커만 대체되며 값 ID를 사용합니다. 즉, @Language는 사람이 읽는 라벨(中文)이 아니라 zh가 됩니다. 따라서 내보낸 파일명을 일관되게 유지할 수 있습니다. Prompt template 필드에서는 @Language가 라벨을 사용합니다.