Skip to main content
サポート

トラブルシューティング

QoderWake の一般的な障害症状のトラブルシューティングガイド。コンソール、ログイン、Waker、自動タスク、WakerFlow、ナレッジベース、コネクター、ネットワーク診断、アップデート、ログ、フィードバックを網羅。

本章は障害の症状別に整理されています。目次から該当する見出しに移動するか、ページ内で「コンソール」「ログイン」「自動タスク」「WakerFlow」「ナレッジベース」「コネクター」「アップデート」「Q&A Specialist」などのキーワードで検索できます。 「ローカルサービス → ログインとネットワーク → デバイスと Waker → タスク設定 → 外部機能」の順序でトラブルシューティングします。一度に 1 つだけ変更し、すぐに再テストしてください。解決しない場合は、ログ、エラーメッセージ、問題が発生した時刻を収集してください。

コンソールが開かない

qoderwake status
qoderwake start --open
qoderwake portal --no-open
qoderwake restart
順にサービスの状態確認、サービスの起動、実際のアクセス URL の取得を行います。それでも開かない場合は再起動します。ブックマークの固定ポートだけに頼らないでください。 qoderwake status でサービスが実行中と表示され、qoderwake portal --no-open が出力する URL が開け、Web Console ページが読み込み完了すれば正常です。 ログインが無効なために restart が実行を拒否し、ローカルモードだけが必要な場合： 
qoderwake restart --force
このフラグはローカルモードで起動します。リモート機能が必要な場合は、先に再ログインしてください。

ログインまたはリモート機能が利用できない

  1. qoderwake whoami を実行してアカウントを確認します。未ログインまたはアカウントが正しくない場合は qoderwake login を実行します。
  2. ログイン後、再度アカウントを確認し、ネットワーク診断を実行します。
  3. リモートデバイスがまだ表示されない場合は、同じアカウントを使用していることを確認し、デバイスページを更新します。
qoderwake whoami で期待するアカウントが表示され、ネットワーク診断で Gateway 認証が通過し、ターゲットのリモートページが正常に読み込まれれば正常です。

Waker が応答しない、またはタスクが長時間終了しない

  1. タスクボードでステータスを確認します。「操作が必要」の場合は元のタスクに対処します。
  2. キュー中または長時間実行中の場合は、デバイスがオンラインでサービスが実行中かつスリープしていないことを確認します。
  3. 元のタスクを開いてエラーを確認し、最小テストメッセージを送信します。それでも失敗する場合は、ディレクトリ、モデル、コネクター、権限を確認します。
最小テストメッセージの送信後、タスクがキューから実行中に移行し、最終的に返答または明確なエラーを返せば正常です。

自動タスクが実行されない

  1. タスクが有効であることを確認し、時間、タイムゾーン、イベント/API リクエスト、有効期間、実行回数を検証します。
  2. ローカルディレクトリを使用している場合、トリガー時にデバイスが起動中でサービスが実行中かつスリープしていないことを確認します。
  3. 実行履歴を確認し、「未トリガー」と「実行されたが失敗」を区別します。修正後、まず手動で実行し、次に実際のトリガーを待ちます。
実行履歴に新しいレコードが表示され、開始時刻とトリガー方法が期待通りで、その実行の完全な結果を開くことができれば正常です。

WakerFlow がスタック、失敗、または結果が不完全

  1. 「実行記録」を開き、現在の Phase、Worker、ユーザー入力待ちかどうかを確認します。
  2. 入力待ちの場合は実行詳細で回答します。Worker が失敗した場合はエラー、Result、および未加工イベントを確認します。
  3. 実行パラメーター、Waker、ナレッジベース、コネクター、権限を検証します。ビジネスログでフェーズを特定しますが、結果は Worker Result と最終返却値で判断します。
  4. 修正後、右上の「実行」をクリックして再実行します。
新しい実行ですべての必須 Worker が正常に完了し、実行記録が完了を表示し、最終返却値にフローで規定された完全なフィールドが含まれていれば正常です。

タスクボードにタスクが表示されない、またはステータスが更新されない

  1. すべてのフィルター（タイプ、グループ、Waker、ステータス）をクリアし、リスト/スイムレーンビューを切り替えます。
  2. グループタスクの場合は親タスクを展開し、元の入口に戻ってタスクが実際に作成されたことを確認します。
  3. ボードに再度入ります。ソースの読み込みが失敗する場合は、ネットワーク診断を実行して権限を確認します。
フィルターをクリアした後にターゲットタスクが見つかり、ステータスが元のタスク詳細と一致し、ソースページに正常にジャンプできれば正常です。

ナレッジベースの資料を使用できない

  1. アカウントで Notebook を開けること、資料が存在し、処理が完了して内容を表示できることを確認します。
  2. ナレッジベースのホームと Waker 詳細の両方で関連付けを確認します。
  3. 新しい会話を開始し、答えが明確な質問で、対象 Notebook を根拠に回答するよう指定してテストします。
  4. まだ不正確な場合は、古いまたは競合するバージョンを削除して再テストします。
確認： Waker が資料内の既知の事実を正確に回答し、現在のバージョンと一致します。 ログアウトしている場合はアカウント認証をやり直します。共有 Notebook を編集できない場合は共同編集者の権限を確認します。

コネクターが利用できない

  1. Waker 詳細 →「コネクター」に移動し、設定、認可、接続状態、ツールリストを確認します。
  2. Waker の「権限」で関連ツールが許可されていることを確認します。
  3. そのコネクターだけを呼び出す最小テストタスクを作成します。
コネクターが利用可能と表示され、システムがツールを検出・一覧表示でき、最小テストタスクが正常に呼び出して結果を返せば正常です。 コネクターは Waker 詳細の「コネクター」セクションで一元管理されます。トークンやキーを会話、ナレッジベース、ログに貼り付けないでください。

DWS: chat_permission_grant の重複定義

エラーメッセージが以下と完全に一致する場合： 
Error: internal panic: chat_permission_grant flag redefined: params
DWS 使用ガイドに従って、ユーザーディレクトリの DWS ツールキャッシュをクリアします： 
rm -rf ~/.dws/cache/default_default/tools/*
エラーメッセージが完全に一致する場合のみ実行してください。コマンド内のディレクトリを変更せず、すべてのコネクター問題の汎用修正として扱わないでください。
実行前に DWS テストタスクを停止してください。クリア後、コネクターページを更新し、再検出して読み取り専用の検証を完了します。

ネットワーク診断が失敗

「設定」→「ネットワーク診断」に移動し、完全な診断を実行してから失敗項目別に対処します：
失敗項目最初に確認すること
Gateway 認証ログインが有効か、アカウントが正しいか、システム時刻が正確か
マシン登録ローカルサービスが実行中か、デバイスが登録を完了しているか、アカウントが一致しているか
Work 回帰リンクデバイスがオンラインか、企業ネットワークやファイアウォールがロングコネクションや回帰リクエストをブロックしていないか
システム時刻、DNS、企業ネットワーク、ファイアウォール、セキュリティソフトウェアも確認します。必要に応じてネットワークを切り替えて再テストし、失敗の概要を記録します。 修正後に再度診断を実行し、Gateway 認証、マシン登録、Work 回帰リンクがすべて合格と表示され、以前失敗していたリモート操作も成功すれば復旧です。

アップデートがダウンロード済みだがバージョンが変わらない

  1. 「設定」→「アプリの更新」に移動し、アップデートがインストール済みであることを確認します。
  2. サービスを再起動します： 
    qoderwake restart
  3. qoderwake status を実行し、次に「アプリの更新」でバージョンを確認します。
再起動後、実行バージョンがインストール済みバージョンと一致し、ページに「再起動が必要」と表示されなくなれば正常です。 qoderwake update だけを実行して再起動しない場合、現在のサービスはまだ古いバージョンを使用している可能性があります。

ログの確認とフィードバックの送信

ログの場所: デフォルトのメインログの場所： 
${QODERWAKE_HOME:-$HOME/.qoderwake}/logs/qoderwake.log
問題に基づいて検索方法を選択します： 
# 最新の warn 以上のログエントリ 200 件
qoderwake log --level warn --limit 200

# キーワードで検索
qoderwake log --keyword "キーワード" --limit 200

# traceId または sessionId で検索
qoderwake log <traceId>
新しいログを継続的に監視するには qoderwake log -f を使用します。位置引数 traceId、--trace-id、--keyword は一度に 1 つだけ使用できます。簡略表示には --clean を追加します。 証拠の収集: 発生時刻とタイムゾーン、バージョンと OS、タスク名または ID、再現手順、エラーメッセージ、および traceId/sessionId を記録します。認証情報は送信しないでください。 フィードバックの送信: 
qoderwake feedback --email "your-email" --message "problem description"
特定の Waker に関連する場合は --waker-id <wakerId> を追加します。 コマンドが feedback id を返せば送信成功です。この ID を保存し、フォローアップ時にフィードバックレコードを特定するために使用できます。 フィードバックの送信には有効なログインが必要です。問題説明のパラメーターは --message です。

Q&A Specialist の問題

ボットをグループに追加したがペアリング申請が表示されない

  1. Q&A Specialist ホームのクイック設定で、対象ボットが接続済みで有効なことを確認します。
  2. ボットが対象グループに参加していることを確認し、グループ内でもう一度 @メンションしてメッセージを送信します。
  3. ペアリング申請に戻り、グループとボットを確認して承認します。
  4. 申請が表示されない場合は、IM > 会話管理 > ペアリングを追加を開きます。DWS を更新して手動検索するか、10 分間有効なペアリングコードを生成して対象グループに送信します。
確認：対象グループが「ペアリング済み」と表示され、テストメッセージが Q&A Specialist に届き、Q&A 記録に表示されます。

専門家へのプライベート支援依頼が 403 IP 許可リストエラーで失敗する

エラーには次の内容が含まれる場合があります。 
HTTP 403 - IpNotInWhiteList
解決手順：
  1. エラーを報告した DingTalk アプリケーションを特定し、QoderWake サーバーの実際の送信元 IP アドレスを取得します。
  2. DingTalk Open Platform で対象アプリケーションのセキュリティ設定に、その送信元 IP を追加します。
  3. 反映後に再テストします。ローカルマシンのプライベートアドレスは使用しないでください。
確認： 再度支援を依頼しても IpNotInWhiteList が表示されず、対象の専門家がメッセージを受信します。

回答が業務範囲を超える、または別の方針が混在する

  1. Q&A Specialist に関連付けたナレッジベースを確認し、現在の業務と無関係または競合する資料を削除します。
  2. 製品や業務方針ごとに独立したナレッジベースを使用し、資料処理が完了していることを確認します。
  3. 適用範囲内、範囲外、資料不足の質問でそれぞれ再テストします。
確認：信頼できる資料がある質問は現在の方針を根拠に回答し、範囲外または資料不足の質問は不明であることを説明するか、専門家支援に進みます。

回答に問題があるが、ページに直接エラーが表示されない

  1. Q&A 記録でグループ、ユーザー、時刻から質問を検索し、ナレッジ検索、専門家支援、返信のどの段階で停止したかを確認します。
  2. 必要に応じて Q&A ワークフローの実行記録を開き、ビジネスログ、最終戻り値、元のイベントを確認します。
  3. 停止位置に応じて、ボット、グループペアリング、ナレッジベース、専門家設定、Q&A ワークフローを修正し、テストグループで再検証します。
確認：既知の質問は正しく回答され、未知の質問は不明であることを説明するか支援を依頼し、Q&A 記録で処理段階を特定できます。 その他の一般的な症状：
症状解決方法確認
画像に関する質問が正しく理解されない質問と背景をテキストで補足し、対象領域またはフィールドを示す。複雑なグラフでは元データも提供する回答が指定領域を対象にしている
DingTalk ドキュメントのリンクをナレッジベースに取り込むと 404 になる制限されたドキュメントを対応ファイルへエクスポートし、Notebook にアップロードして再検証する処理が完了し、Waker がファイルから回答できる
はじめに
Waker を使う
機能
ベストプラクティス
設定
サポート