> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myrmagent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# インタラクティブフォーム（structured_clarify）

> structured_clarify ツールで会話内に選択肢・複数選択・自由記述のフォームを描画します。

# インタラクティブフォーム（`structured_clarify`）

Myrm は**会話内に構造化フォームを描画**できます。エージェントが `structured_clarify` ツール（`ask_question_tool` スキーマ）を呼ぶと 1 つ以上の質問が送られ、WebUI は会話内で選択肢ボタン・チェックボックス・自由記述の入力欄を描画します。ユーザーが送信すると、**同じ run** が回答によって目を覚まして実行を再開します。

## 有効 / 無効の切り替え

`structured_clarify` はデフォルト profile で**既定で有効です**。調整したい場合:

1. 会話内で **Agent 設定** を開く
2. 必要に応じて **構造化 clarify**（`structured_clarify`）を切り替え

無効にすると Turn1 は `ask_question_tool` スキーマを**渡さなくなり**、使わない機能の token コストはゼロです。

## 何を作れるか

| フィールド | 用途 |
| - | - |
| `title` | フォーム全体の任意タイトル |
| `questions[]` | 1 回の送信で複数の質問を、1 つのフォーム内に描画 |
| `questions[].options[]` | 選択肢ボタン（`id` + `label` + 任意の `description`） |
| `questions[].allow_multiple` | 単選ではなく複数選択（チェックボックス）で描画 |
| `questions[].options`（空） | 自由記述の入力欄を描画 — 選択肢を渡さなければ自由回答 |
| `requires_confirmation` | 不可逆・破壊的・高リスク操作の前にユーザーの明示的な確認を要求 |
| `context` | 質問の上に表示する背景説明 |

## 閉ループの動作

1. エージェントが `structured_clarify` を呼び、run は応答を待ってサスペンドします
2. WebUI は会話内にフォームを描画し、**チャットストリームをブロックしません**
3. ユーザーが送信すると回答は保存され、**同じ run が回答を伴って自動的に続行**します
4. バックエンドは **900 秒**のタイムアウトガードを登録: ユーザーが応答しない場合も `no_answer` で自動的に続行し、フォームが会話を永久に堵塞させることはありません

Harness の **`ClarificationGuardMiddleware`** は 1 ターンにつき `ask_question_tool` の呼び出しを最大 1 回に制限し、並列ツールを遮断するため、フォームとツールの計画が矛盾しません。

## いつ使うか

`structured_clarify` は**質問と明示的確認**のために使います — デプロイチェックリスト、破壊的操作の確認、方針の分岐選択。ダッシュボード・チャート・長寿命のパネルには **Mermaid アーティファクト**や成果物ファイルを使ってください。フォームは「訊く」ためのもので、「データを表示する」ためのものではありません。

## 大容量ファイルのインライン保護

HTML / SVG / Mermaid のアーティファクトは既定で会話ストリーム内に自動展開・描画されます。アーティファクトが **1 MB**（`LARGE_FILE_THRESHOLD`）を超えると、インライン描画は優雅に縮退します。

1. コンテンツの fetch も行わず `srcDoc` 描画も実行しません（OOM / ブラウザのフリーズを回避）
2. 簡略なフォールバックカードを表示し、ファイルサイズと **「全画面表示」** ボタンを出します
3. クリックすると `ArtifactPortal` が隔離 URL モード（`iframe src`）でコンテンツを読み込みます — ファイル有多大でも性能上のリスクはありません

これにより、ユーザーがインラインプレビューで固まる / 白紙になることで、大きな生成物（データダッシュボード、複雑な SVG インフォグラフィック）を「タスク失敗」と誤解することがなくなります。

| 製品 | 大容量ファイル保護 |
| - | - |
| **Myrm** | 1 MB 閾値 + フォールバック CTA + URL モードの安全な描画 + プリロードのスキップ |
| Hermes | デスクトップのみ（512 KB）。WebUI には保護なし |
| LobsterAI / OpenClaw | 保護なし。そのまま `srcDoc` 描画 |

参照: [Agent 設定 — ツールのロード（英語）](/core-concepts/agent-configuration)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.