대화형 양식(structured_clarify)
Myrm은 채팅 내에서 구조화된 양식을 렌더링합니다. 에이전트가 structured_clarify 도구(ask_question_tool 스키마)를 호출하면 WebUI가 대화에 옵션 버튼, 체크박스, 자유 텍스트 입력란을 렌더링하고, 사용자가 제출하면 동일한 run이 그 답변으로 다시 이어서 실행됩니다.
켜기 또는 끄기
structured_clarify는 기본 프로필에서 기본 ON입니다. 변경하려면:
- 채팅에서 Agent 설정을 엽니다.
- 필요에 따라 구조화 명확화(
structured_clarify)를 켜거나 끕니다.
ask_question_tool 스키마가 전송되지 않으므로 사용하지 않는 기능에 토큰을 지불하지 않습니다.
만들 수 있는 것
왕복 동작 방식
- 에이전트가
structured_clarify를 호출하면 run이 대기 상태가 됩니다. - WebUI가 채팅에 양식을 렌더링하며, 채팅 스트림을 차단하지 않습니다.
- 사용자가 제출하면 답변이 저장되고 동일한 run이 해당 답변으로 자동 재개됩니다.
- 백엔드에 900초 타임아웃 가드가 등록되어, 사용자가 끝내 답하지 않으면
no_answer로 자동 재개됩니다. 잊힌 양식이 세션을 영구히 막지 않습니다.
ClarificationGuardMiddleware**가 턴당 최대 하나의 ask_question_tool 호출만 허용하고 병렬 도구를 차단하여 양식과 도구 계획의 일관성을 유지합니다.
사용 시점
structured_clarify는 명확화 질문과 명시적 승인에 사용합니다 — 배포 체크리스트, 파괴적 작업 확인, 분기 선택 등입니다. 대시보드, 차트, 장기 실행 패널에는 Mermaid 아티팩트나 아티팩트 파일을 사용하십시오. 양식은 ‘묻기’ 위한 것이지 ‘데이터 표시’를 위한 것이 아닙니다.
대용량 파일 인라인 보호
HTML/SVG/Mermaid 아티팩트는 기본적으로 채팅 스트림에서 자동 확장 렌더링됩니다. 아티팩트가 1 MB(LARGE_FILE_THRESHOLD)를 초과하면 인라인 렌더러가 우아하게 저하됩니다.
- 콘텐츠 fetch도
srcDoc렌더링도 발생하지 않습니다(OOM / 브라우저 지연 방지). - 파일 크기와 “전체 화면 보기” 버튼을 보여주는 간결한 폴백 카드가 표시됩니다.
- 클릭하면
ArtifactPortal이 격리 URL 모드(iframe src)로 내용을 로드합니다 — 파일 크기와 무관하게 성능 위험이 없습니다.
참고: Agent 구성 — 도구 로딩.