Skip to main content
サポート

トラブルシューティング

サービス、タスク、コネクタ、ナレッジベース、@Waker のよくある問題を診断します。

症状に一致するセクションを見つけるか、Console、Login、Autonomous Work、WakerFlow、Knowledge Base、Connector、Update、または @Waker で検索してください。 次の順序でトラブルシューティングを行います: ローカル サービス → ログインとネットワーク → デバイスと Waker → タスク設定 → 外部機能。一度に 1 つずつ変更し、その都度すぐに再テストしてください。問題が解決しない場合は、タイムスタンプとタイムゾーン、エラーテキスト、関連する ID、ログを記録してください。

コンソールを開けない

qoderwake status
qoderwake start --open
qoderwake portal --no-open
qoderwake restart
サービスのステータスを確認し、サービスを開始し、実際のアクセアドレスを取得する顺序で実行してください。それでも開けない場合は再起動します。ブックマークに残った固定ポートだけを安易に使わないでください。 完了条件: QoderWake status でサービスが実行中であることが表示され、QoderWake portal --no-open が出力するアドレスを開け、Web Console のページが完全に読み込まれていること。 restart が無効なログインを理由に実行を拒否し、ローカルモードのみでよいことが確認できている場合は、次のようにします。 
qoderwake restart --force
このパラメータはローカルモードで起動します。リモート機能が必要になったときは、再度ログインし直してください。

ログインまたはリモート機能が使えない

  1. QoderWake whoami を実行してアカウントを確認します。未ログインまたはアカウントが誤っている場合は QoderWake login を実行します。
  2. ログイン後、アカウントを再確認し、ネットワーク診断を実行します。
  3. リモートデバイスが依然として表示されない場合は、そのデバイスが同じアカウントを使用していることを確認し、デバイスページを更新します。
完了条件: QoderWake whoami が期待通りのアカウント番号を表示し、ネットワーク診断で Gateway 認証が合格し、対象のリモートページが正常に読み込まれていること。

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

  1. タスクダッシュボードでステータスを確認します。「操作が必要」の場合は元のタスクに移動して処理します。
  2. キューイングや実行が長時間続く場合は、デバイスがオンラインであること、サービスが実行中でスリープしていないことを確認します。
  3. 元のタスクを開いてエラーを確認し、最小限のテストメッセージを送信します。それでも失敗する場合は、ディレクトリ、モデル、コネクタ、権限を確認します。
完了条件: 最小限のテストメッセージを作成した後、タスクがキューから実行に入り、最終的に返信を返すか、エラーが明確に示されること。

Autonomous Work が実行されない

  1. タスクが有効になっていることを確認し、時刻、タイムゾーン、イベント / API リクエスト、有効期間、実行回数をチェックします。
  2. ローカルディレクトリを使用する場合は、トリガーの時点でデバイスの電源が入っていること、サービスが実行中であることを確認し、スリープしていないことを確かめます。
  3. 実行履歴を確認し、Not Triggered（未トリガー）と Triggered but Failed（トリガー済みだが失敗）を区別します。問題を修正した後、次の実際のトリガーを待つ前にタスクを手動で実行します。
完了条件: 期待通りの開始時刻とトリガー方法で新しい実行履歴レコードが表示され、その完全な結果を開けること。

WakerFlow が詰まる、失敗する、または結果が不完全

  1. Run History を開き、現在のフェーズ、Waker ノード、およびフローがユーザー入力を待っているかどうかを特定します。
  2. 入力が必要な場合は、実行詳細で応答します。Waker ノードが失敗した場合は、そのエラー、ノード結果、生イベントを調べます。
  3. 実行パラメータ、Wakers、ナレッジベース、コネクタ、権限を検証します。フェーズの特定にはビジネスログを使いますが、結果の判定には Waker ノードの結果と最終的な戻り値を使用します。
  4. 修復後、右上の "Run" から再実行します。
完了条件: 新しい実行で必要なすべての Waker ノードが成功し、実行レコードが完了を示し、最終的な戻り値にフロー契約が要求するすべてのフィールドが含まれていること。

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

  1. Type、Group、Waker、Status のフィルターをクリアし、リスト表示とスイムレーン表示を切り替えます。
  2. グループタスクの親タスクを展開し、元のタスクに戻って、タスクが実際に作成されていることを確認します。
  3. ダッシュボードに再進入します。ソースの読み取りに失敗する場合は、ネットワーク診断を実行し、権限を確認します。
完了条件: フィルターをクリアした後に対象のタスクを見つけられ、ステータスが元のタスクの詳細と一致し、ソースページへ正常にジャンプできること。

ナレッジベースの情報を使用できない

  1. ナレッジベースを開き、ソースが存在し、処理が完了し、抽出された内容が読める状態であることを確認します。
  2. Cards を開き、ソースがコンパイルされていることを確認します。必要に応じて手動でコンパイルを実行します。
  3. ナレッジベースの一覧と Waker の詳細ページの両方でバインディングを確認します。
  4. 新しいチャットを開始し、ソースに明確な答えがある質問をします。
  5. 答えが依然として不正確な場合は、古くなったものや矛盾する資料を削除し、再コンパイルして再テストします。
完了条件: Waker が情報内の既知の事実を正確に答えられ、その回答が情報の現在のバージョンと一致していること。 共有ナレッジベースを編集できない場合は、メンバーの身份と、表示 / 編集 / 管理の権限を確認してください。

コネクタが使用できない

  1. Waker の詳細 → "Connectors" に移動し、設定、認可、接続ステータス、ツールリストを確認します。
  2. Waker の "Permissions" に移動し、関連するツールが使用を許可されていることを確認します。
  3. コネクタのみを呼び出す最小限のテストタスクを新規作成します。
完了条件: コネクタが利用可能で、そのツールを発見でき、最小限のテストタスクがそれを正常に呼び出して結果を返していること。 コネクタは Waker の詳細にある "Connectors" で管理します。トークンやキーをチャット、ナレッジベース、ログに貼り付けないでください。

ネットワーク診断が失敗する

"Settings" → "Network Diagnosis" に移動し、完全な診断を実行して、失敗した項目を処理します。
失敗した項目優先的に確認する内容
Gateway 認証ログインが有効か、アカウントが正しいか、システム時刻が正確か
マシン登録ローカルサービスが実行中か、現在のデバイスが登録済みか、アカウントが一致しているか
Work の折り返し（backhaul）デバイスがオンラインか、社内ネットワークやファイアウォールが長時間接続や折り返しリクエストをブロックしていないか
あわせて、システム時刻、DNS、社内ネットワーク、ファイアウォール、セキュリティソフトウェアを確認します。必要に応じてネットワークを切り替えて再テストし、失敗の概要を記録してください。 完了条件: 修復後に再診断した結果、Gateway 認証、マシン登録、Work の折り返し（callback）がすべて合格と表示され、その後で元のリモート操作も成功すること。

更新はダウンロードされたがバージョンが変わらない

  1. "Settings" → "Update Apps" に移動し、更新がインストール済みであることを確認します。
  2. サービスを再起動します。
qoderwake restart
  1. QoderWake status を実行し、その後 "Update Application" に移動してバージョンを確認します。
完了条件: 再起動後、実行中のバージョンがインストール済みのバージョンと一致し、ページに "restart required"（再起動が必要）が表示されなくなっていること。 QoderWake update だけを再起動なしで実行した場合、現在のサービスは依然として古いバージョンを使用している可能性があります。

ログを表示してフィードバックを送信する

1. ログの特定 デフォルトのメインログの場所: 
${QODERWAKE_HOME:-$HOME/.qoderwake}/logs/qoderwake.log
まず、問題に応じて検索方法を選びます。 
# warn レベル以上の最新 200 件のログエントリ
qoderwake log --level warn --limit 200

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

# traceId または sessionId で検索
qoderwake log <traceId>
新しい追記を継続して確認するには QoderWake log -f を使用します。位置パラメータは traceId、--trace-id、--keyword のうち 1 回に 1 つだけ選択できます。--clean を追加すると表示を簡略化できます。 2. 問題の証拠を収集する 発生時刻とタイムゾーン、バージョンとオペレーティングシステム、タスク名または ID、再現手順、エラーテキスト、traceId/sessionId を記録します。認証情報は送信しないでください。 3. フィードバックを送信する 
qoderwake feedback --email "your-email@example.com" --message "Problem description"
Waker に関連する場合は --waker-id <wakerId> を追加します。 完了条件: コマンドが feedback id を返します。この ID を保存し、その後のやり取りでフィードバックレコードを特定するために使用してください。 フィードバックの送信には有効なログインが必要です。問題の説明のパラメータは --message です。

@Waker の問題

ボットはグループにいるのに、保留中のリクエストが表示されない

  1. @Waker → IM Connection Management を開き、ボットの接続が利用可能であることを確認します。
  2. ボットがグループにいることを確認し、通常の新しいメッセージでメンションします。
  3. @Waker → Pending Requests を開き、チャット、依頼者、接続の身份を検証します。
  4. リクエストが表示されない場合は、接続範囲を見直します。ペアリングコードが利用可能な場合は、使い捨てのコードを生成し、対象のグループでペアリングを完了します。
  5. 承認後、再びボットをメンションし、読み取り専用のタスクを実行します。
完了条件: グループが有効なセッションリストに表示され、メッセージがタスクを作成し、応答がグループに返っていること。

セッションは有効なのに、ボットが返信しない

  1. セッションがアクティブで、@Waker が有効になっていることを確認します。
  2. IM 接続がオンラインであること、ボットがグループに留まっていること、メッセージの送受信ができることを確認します。
  3. 少なくとも 1 つの Waker が有効で、デフォルトの Waker が選択されていることを確認します。
  4. Waker のデバイス、プロジェクト、モデル、コネクタ、権限を確認します。
  5. 外部ツールを必要としない最小限のタスクを送信し、Task Board 上のその状態を調べます。
完了条件: メッセージが Task Board に表示され、対応する Waker がそれを実行し、結果が IM に返っていること。

リクエストが誤った Waker にルーティングされる

  1. すべての Waker に、互いに異なる名前と責任を与えます。
  2. デフォルトの Waker は、責任が不明確なリクエストにのみ使用します。
  3. 重複する役割を、明示的な入力、出力、境界で書き直します。
  4. 同じテストチャットで、責任が明確に異なる 2 つのタスクを送信し、実際の実行者を確認します。
ルーティング設定を変更した後、同じ固定テストセットを再実行して、結果を比較できるようにしてください。

ファイルまたは最終結果が IM に届かない

  1. タスクの詳細を開き、完了していることと、成果物の実際の場所を確認します。
  2. IM チャネルがネイティブの添付ファイルやクリック可能なリンクをサポートしているかどうかを確認します。
  3. サポートしていない場合は、QoderWake のタスク成果物またはチームプロジェクトからファイルを取得し、アクセス可能な場所を返します。
  4. パスワード、トークン、顧客のプライベートデータを添付ファイルとして送信しないでください。
完了条件: グループメンバーが、元のチャットまたは明示的なリンクから最終的な成果物に、期待通りのアクセス権限で到達できること。 その他のよくある症状:
症状対処完了条件
画像の質問が誤って解釈されるテキストの質問とコンテキストを追加し、関連する領域を明示し、複雑なグラフには生データを提供する回答が指定した領域に対応している
制限されたページが空の内容または 404 としてインポートされる認可済みのアクセスでサポート対象のファイルにエクスポートし、アップロードしてコンパイルし、再テストする処理とコンパイルが完了し、Waker が内容を使用できる
はじめに
作業管理
従業員リソース
ベストプラクティス
操作設定
コマンドライン
サポート