위젯 폼
마크업을 직접 작성하는 대신 폼 도구를 사용하세요: 에디터 채팅이 폼을 대화형 카드로 렌더링하고 사용자의 구조화된 답변을 반환합니다.
런타임 규칙
ask_followup_questions를 호출하세요. 이 함수가 필드를 에디터의 기본 폼 카드로 직렬화하고, 사용자의 제출은 다음 메시지로 돌아옵니다.
도구를 호출하기 전에 전체 설문지를 계획하세요. 수정된 폼을 보내기 전에 시험 폼을 보내지 말고, 최종 폼 하나만 보내세요. 도구는 최대 12개의 필드를 지원합니다. 사용자가 더 많은 질문을 요청하면 관련 프롬프트를 첫 번째 호출 전에 결합된 필드로 병합하세요.
ask_followup_questions를 호출한 후에는 턴을 멈추고 제출된 답변이 채팅에 나타날 때까지 기다리세요. 사용자의 선택이 대화에 나타날 때까지 선택을 적용하거나, 자산을 생성하거나, 추천에 따라 계획을 계속하지 마세요.
지원 필드 매핑
fields 배열을 구성하세요. 모든 표시 문자열을 사용자의 대화 언어로 작성하세요.
- 기본
<form-single>->{ type: "single", variant: "default" } - 기본
<form-multi>->{ type: "multi", variant: "default" } - 기본
<form-text>/<form-textarea>->{ type: "text" } - 기본
<form-visual>->{ type: "single", variant: "visual" } - 음성 오디션 카드 ->
{ type: "single", variant: "voice" } - 기본 시작 시나리오 카드 ->
{ type: "single", variant: "scenario" }
폼 카피 톤
폼 레벨 텍스트(title, prompt, fields[].label, submitLabel, messagePrefix)는 OpenChatCut이 마치 경직된 설문조사처럼 행동하지 않고, 사용자가 원하는 것을 설명하도록 초대하는 유능한 영상 제작 파트너처럼 작성해야 합니다.
지향점:
- 따뜻하고, 개방적이며, 행동 중심적. 카피는 "가장 가까운 영상 니즈를 선택하거나 아이디어를 알려주세요. 함께 해결해 나갈 수 있습니다."를 암시해야 합니다.
- 짧고 스캔하기 쉬움.
prompt에는 하나의 자연스러운 문장을 사용하고, 질문 레이블은 간결하게 유지하세요. - 정직한 능력 범위 설정. OpenChatCut은 많은 영상 워크플로우를 도울 수 있지만, 지원되지 않는 기능을 주장하거나 입력이 알려지기 전에 결과를 보장하지 마세요.
- 사용자의 언어 및 현지 제품 용어. "OpenChatCut", "B-roll", "Motion Graphics", "아이디어", "방향", "계획", "스토리", "샷 리스트", "청중", "분위기" 또는 "영상 니즈"와 같은 용어를 설정된 형태로 유지하고, 내부 제작 문서 언어는 피하세요.
- 사용자 대상 창의적 표현. 초기 기획 또는 창의성 입력 폼의 경우 "비디오 유형 선택", "이 프로젝트의 비디오 유형을 선택하세요" 또는 "어떤 유형의 비디오를 만들고 싶으신가요?"와 같은 경직된 레이블을 피하세요. 호스트가 더 따뜻한 카피를 위한 여지가 없는 경우는 제외합니다.
시나리오 입력 폼의 경우 다음과 같은 카피를 선호합니다:
{
"title": "무엇을 만들고 싶으신가요?",
"prompt": "가장 가까운 비디오 시나리오를 선택하거나, '기타'를 선택하고 아이디어를 설명해주세요.",
"submitLabel": "만들기 시작",
"messagePrefix": "이 비디오 방향으로 시작하고 싶습니다:",
"fields": [
{
"id": "scenario",
"label": "어떤 시나리오가 귀하의 비디오에 가장 적합한가요?",
"type": "single",
"variant": "scenario",
"otherPlaceholder": "예: 여행 영상을 분위기 있는 브이로그로 바꾸기 / 신제품 출시 영상 만들기"
}
]
}
폼에 파일 업로드 질문을 포함하지 마세요. 작업에 실제로 소스 미디어가 필요하고 프로젝트/채팅에 이미 없는 경우, 별도로 사용자에게 편집기에서 파일을 업로드하도록 요청하세요(드래그 & 드롭 또는 업로드 버튼, 또는 채팅 작성기에 붙여넣기). 파일 업로드는 모든 설문지의 기본 전제 조건이 아닙니다. 다음 편집 단계가 누락된 미디어에 의존할 때만 요청하세요.
선택 필드의 경우:
id는 다음 도구 호출에 필요한 내부 값으로 사용하세요.label은 사용자가 보는 값으로 사용하세요.- 일반 단일 선택 및 다중 선택 카드(
variant: "default")의 경우 옵션을 레이블만으로 유지하세요. 선택 항목을 레이블만으로 구분할 수 없는 경우에만 옵션별description을 추가하세요. description은 주로 음성 카드에 사용하세요. 비주얼 스타일 카드는 일반적으로preview+label만 사용해야 합니다.- 목록 외 답변이 허용되는 경우,
id: "__other__"와 폼의 다른 부분과 동일한 언어의label을 가진 명시적 옵션을 추가하세요. 위젯은 이 옵션을 선택하면 텍스트 입력으로 전환합니다. 텍스트 입력에 플레이스홀더가 필요한 경우otherPlaceholder를 사용하세요.
비주얼 카드의 경우:
preview에 실제 이미지 URL 또는 데이터 이미지 URL을 사용하세요.- 디자인 스타일 카탈로그 선택의 경우 먼저
action: "list"로manage_design_style을 호출한 다음, 반환된 각 프리셋을{ id: preset.presetId, label: preset.name }으로 매핑하세요(이 빌드에는 썸네일 없음). - 사용자가 이미 선택하지 않는 한 카탈로그 프리셋 ID를 하드코딩하지 마세요.
음성 카드의 경우:
audioUrl에 샘플 파일을 사용하세요.- 문서화된 샘플 경로(예:
/voice-samples/doubao-liuchang.mp3) 또는 공개 HTTPS URL을 선호하세요. localhost 샘플 URL을 전달하지 마세요. MCP 호스트 iframe은 편집기 로컬 미디어를 안정적으로 확인하지 못합니다. - 사용자에게 표시되는 설명은 제공자 중립적으로 유지하세요. 기본 OpenChatCut 오디션 UI와 동일한 방식으로 음성을 설명하세요: 성별 / 연령대 / 톤 / 사용 사례(예:
여성 / 젊은 / 친근한, 일반또는남성 / 중년 / 낮은 톤의 지식 해설). 옵션 설명에 ElevenLabs 또는 Doubao와 같은 제공자 이름을 표시하지 마세요. - 옵션
id를submit_voice에 필요한 제공자 음성 ID와 동일하게 유지하세요.
기본 시작 시나리오 카드의 경우:
- 사용자가 시작할 OpenChatCut 비디오 워크플로우(예: 토킹헤드 편집, MG 애니메이션, 롱 비디오 숏츠 변환, 제품/앱 프로모션, AI 단편 영화, 설명 영상)를 선택해야 할 때 사용하세요.
- 이를 일반적인 비디오 니즈/시나리오로 제시하고, 유일한 가능한 비디오 워크플로우로 제시하지 마세요. 폼은 또한 사용자가 다른 비디오 니즈를 설명할 수 있도록 해야 합니다.
- 정확히 하나의
variant: "scenario"단일 선택 필드를 사용하세요. - 아래의 표준 ID와 사용자 언어로 현지화된 레이블을 사용하여 옵션을 제공하세요. 오프 리스트 레이블을 사용자 지정해야 하는 경우에만
id: "__other__"를 포함하세요. 그렇지 않으면 백엔드가 현지화된 '기타' 옵션을 추가합니다. - 영어, 중국어, 스페인어 시나리오 레이블/설명/시작 프롬프트는 내장되어 있습니다. 다른 사용자 언어의 경우 각 시나리오의 영어
label,description및 시작 프롬프트를 사용자의 언어로 충실히 번역하여 옵션 객체에 전달하세요. OpenChatCut 제품 용어와 워크플로우 의미를 유지하고, 새로운 요구 사항을 추가하지 마세요. 번역된 시작 프롬프트에submitPrompt를 사용하세요. 이 재정의는variant: "scenario"에만 적용됩니다. 일반 옵션 카드, 음성 카드 및 비주얼 스타일 카드는 이미 전달한 값에서 표시 텍스트를 가져옵니다. - 사용자 정의
preview또는audioUrl을 제공하지 마세요. 백엔드가 기본 첫 화면 미리보기 이미지를 채웁니다. - 표준 ID:
talking-head,motion-graphics,long-video-to-shorts,app-promo,ai-cinematic-short-film,explainer, 그리고 자유 형식 비디오 니즈를 위한__other__. - 예시 옵션:
{ "id": "talking-head", "label": "토킹헤드 편집" },{ "id": "motion-graphics", "label": "모션 그래픽" },{ "id": "long-video-to-shorts", "label": "롱 비디오를 숏츠로" },{ "id": "app-promo", "label": "제품 / 앱 프로모션" },{ "id": "ai-cinematic-short-film", "label": "AI 단편 영화" },{ "id": "explainer", "label": "설명 영상" },{ "id": "__other__", "label": "기타" }.
현재 한계
ask_followup_questions는 구조화된 답변 전용입니다. 기본 사용자 정의 HTML, 타임라인 매개변수 브릿지, 에디터 항목 선택 또는 파일 업로드 필드를 지원하지 않습니다. 이미 에이전트 런타임이 보유하거나 이 카드 외부의 채팅에 직접 첨부된 파일의 경우 미디어 가져오기 워크플로우는 여전히 유효합니다: import_media를 호출하고 헬퍼/직접 업로드 경로를 실행하세요. 사용자가 프로젝트에 직접 배치하려는 파일의 경우 OpenChatCut 편집기 업로드 UI를 사용하도록 요청하세요.
예시
{
"title": "당신의 비디오 아이디어",
"prompt": "OpenChatCut이 좋은 시작 방향을 선택할 수 있도록 마음에 있는 것을 선택하거나 입력하세요.",
"submitLabel": "아이디어 보내기",
"messagePrefix": "이 비디오 방향으로 계속합니다:",
"fields": [
{
"id": "goal",
"label": "이 비디오의 주요 목표는 무엇인가요?",
"type": "single",
"options": [
{ "id": "product_intro", "label": "제품 소개" },
{ "id": "social_ad", "label": "소셜 광고" },
{ "id": "__other__", "label": "기타" }
]
},
{
"id": "elements",
"label": "무엇을 포함해야 하나요? (해당되는 모든 것을 선택하세요)",
"type": "multi",
"options": [
{ "id": "broll", "label": "B-roll" },
{ "id": "logo", "label": "브랜드 로고" },
{ "id": "__other__", "label": "기타" }
]
}
]
}