デバッグガイド

デバッグガイド¶

ドラマの動作確認やトラブルシューティングに役立つ情報をまとめています。

デバッグビューア¶

会話画面の右上にある「デバッグ」ボタンをクリックすると、デバッグビューアが開きます。

デバッグビューアは以下の2つのセクションで構成されています：

• タイムライン（上部）: コンポーネントの実行状況をガントチャート形式で表示
• ツリー表示（下部）: ドラマのコンポーネント構造を表示

タイムラインの操作方法¶

イベントナビゲーション¶

• ◀ ▶ ボタン: イベント（event.trigger）間を移動
• 新規会話**または🗑️ボタン**でリセット

タイムラインマーカー凡例¶

タイムライン上の各マーカーは、コンポーネントの処理状態を示します。

プロセス境界マーカー¶

受信イベントマーカー（青系）¶

入力値の受信に関するイベントです。

送信イベントマーカー（緑系）¶

出力値の送信に関するイベントです。

WebSocket送信マーカー¶

外部サービス呼び出しマーカー（黄系）¶

LLMやTTSなどの外部サービス呼び出しに関するイベントです。

その他のマーカー¶

ガントバーの範囲¶

ガントバー（横棒）は、コンポーネントが実際に処理を行っている期間を示します。

一般的なコンポーネント¶

• 開始: for ループ内で最初に updated() が反応したとき
• 終了: for ループが終了したとき（全ての is_last=true を処理）

LLM系コンポーネント（PublicLLM、GeppettoLLM、SystemLLM）¶

• 開始: プロンプト生成が完了したとき
• external_send マーカー（黄▶）: LLM API にリクエスト送信
• external_chunk マーカー（黄●）: チャンク受信ごと（ストリーミング時）
• 終了: 応答が確定したとき（is_last=true）

TTS3（音声合成）¶

• 開始: TTS入力準備完了時
• external_send マーカー（黄▶）: TTSサーバーへテキスト送信時（#1, #2...）
• external_chunk マーカー（黄●）: 音声チャンク受信時（#1, #2...）
• 終了: 全ての音声チャンクを送信完了

コンポーネント別のイベント¶

EntryChain¶

PublicLLMChain / GeppettoLLMChain / SystemLLMChain¶

DialogAddChain¶

StateSetChain¶

EventResponseChain¶

TTS3Chain¶

LambdaFuncChain¶

GateChain¶

SelfTriggerChain¶

ClassifierChain¶

RAGChain¶

Stateの確認¶

会話画面の「State」タブで、現在の状態を確認できます。

処理フローの要所にデバッグ用の StateSet を細かく配置することで、どこまで処理が進んだかを確認できます。

ログの確認¶

サイドメニューの「ログ確認」から確認できます。

drama_name で絞り込んで、どこまで処理が行われたかを確認しましょう。

トラブルシューティング¶

タイムラインにコンポーネントが表示されない¶

• ドラマが正しくロードされているか確認してください
• ブラウザをリロードしてみてください

ガントバーが表示されない¶

• そのコンポーネントが実際に処理を行ったか確認してください
• for ループが一度も実行されなかった場合、ガントバーは表示されません

マーカーが多すぎて見づらい¶

• ログレベルフィルタを使用して、DEBUGレベルのイベントを非表示にできます
• ピンチ操作でタイムラインを拡大して確認してください