トラブルシューティング

主催は「あなたに見られる症状」。最寄りの修理店をすぐに見つけて、「修理方法」に従ってください。修正できない場合は、「よくある質問」にアクセスするか、作業指示を送信してください。

執行関連

実行は保留中のまま実行中のままになります。

最初に確認してください:

1. 「実行履歴」の上部に「並列上限に到達」の案内が出ていないか確認してください。並列数は Free が 1 / Pro が 5 / Team が 15 です —— 同時実行数が上限に達していませんか。
2. このワークフローのmanual_approvalステップが先頭で止まっているかどうかを確認してください。
3. さらに 30 秒間待ちます (場合によっては一瞬)。作業指示は 2 分以上経過すると保留になります。

実行失敗: credential_not_found

修正方法:

1. error_message に表示される認証情報の名前を確認してください。
2. 認証情報センターを開く - この名前の認証情報は本当に存在しますか?大文字、アンダースコア/ダッシュは一貫している必要があります。
3. 「チーム名前空間」で資格情報を作成しましたが、現在は閲覧者の役割をしていますか?閲覧者は資格情報を参照できません。
4. リストに何かがありますが、解析されていません - ログアウトして再度ログインし、アクセス許可を更新します。

実行失敗: rate_limit_exceeded

理由:ユーザーまたはプラットフォームの LLM プロバイダーの電流制限がトリガーされます。

修正方法:

1. 失敗したステップに再試行戦略を追加します。

- id: call_llm
  type: single
  agent: writer
  retry:
    max_attempts: 3
    backoff: exponential
    initial_delay_ms: 2000
    retry_on: [rate_limit, http_5xx]

2. rate_limit を頻繁に行う場合は、プロバイダー アカウント層を BYOK アップグレードすることが根本的な解決策です。
3. 多くのタスクをバッチで実行する場合は、sub_workflow + max_Parallel を使用して同時実行性を制御します。

実行失敗: タイムアウト

理由:単一のステップがタイムアウト値を超えるか、実行全体がワークフロー レベルのタイムアウトを超えます。

修正方法:

• code step：step に timeout フィールドを明示的に追加します（単位は秒、デフォルトは 30）。
• LLM ステップ: モデルの生成が長すぎる可能性があります。 max_tokens を減らすか、より高速なモデルを使用してください。
• ワークフロー全体が遅いため、先頭にタイムアウト フィールドを追加します (秒単位、デフォルトは 3600)。

エージェントの出力が空または不当である

最初に確認してください:

1. 実行の詳細 → このステップをクリック → 「エージェント ツール_呼び出し履歴」を参照して、間違ったツールに誘導されたかどうかを確認します。
2. 入力変数が空かどうかを確認します。上流のステップが条件によってスキップされていますか?
3. 温度を調整します: 推論/分類タスクの場合は 0 ～ 0.3。創造性の場合は 0.6 ～ 0.9。
4. タスクの説明と、より具体的な数ショットの例。
5. より強力なモデル (claude-opus-4-7 / gpt-5) に変更してみてください。

コードステップで権限が拒否されたかネットワークエラーが報告される

コードステップは分離サンドボックスで実行されますが、次のような制限があります。

• ファイル システムは読み取り専用です - /tmp のみが書き込み可能です。
• ネットワークは出力のみ可能ですが、入力はできません (ポートを監視できません)。
• CPU/メモリ/ランタイムには上限があります。

修正方法:アクセス許可が拒否されたということは、通常、/tmp - /tmp/something 以外のパスに書き込もうとしていることを意味します。ネットワーク エラーのほとんどは、サンドボックスがターゲット ホストをブロックしていることが原因です (プラットフォームには出力ホワイトリストがあります)。作業指示を送信してホワイトリストを追加できます。

保存と編集関連

保存時に「YAML は DAG と矛盾しています」というプロンプトが表示される

これは、YAML を手動で変更した後、ラウンドトリップ ルールが満たされていないことを意味します。よくある理由:

• 使用されたキャメルケースのフィールド名 (snake_case である必要があります)
• 削除されたプリセットまたはエージェントを参照します
• depend_on が存在しないステップ ID を指しています

[確認] ボタンをクリックすると、正確な行番号が表示されます。エラーの場所に応じて修正してください。

エディターを開けない / ぐるぐる回り続ける

1. リフレッシュしてください。通常は一時的なものです。
2. ステータス バーに「xxx は編集中です」と表示されていることに注目してください。他の誰かが編集ロックを保持しています。 5分間操作がない場合、または相手に連絡すると自動的に解除されます。
3. 管理者はチーム設定で「強制ロック解除」できます。
4. ブラウザのキャッシュをクリアするか、テストするブラウザを変更します。

AI アシスタントによって提供された差分は、適用後に検証できませんでした。

Ctrl / Cmd + Z でロールバック —— エディタは多段階の元に戻す操作に対応しています。その後、エラーメッセージと元の YAML をアシスタントに貼り戻せば、修正してくれます。

スケジュール/Webhook関連

cron その時点では発動しなかった

1. スケジュール詳細ページの「次のトリガー時間」は期待どおりですか?最も一般的な原因はタイムゾーンの不一致です。
2. 「過去10回のトリガー履歴」の記録はありますか？そうでない場合は、ワークフローがアーカイブされているか、削除されている可能性があります。
3. ワークフローのステータスを見てください - 一時停止していますか?一時停止スケジュールは引き続きカウントされますが、実際にはトリガーされません。
4. [今すぐトリガー 1 回] ボタンを使用してワークフロー自体を手動で検証しても問題ありません。

Webhook トリガーは 401 / 403 を返します

1. API Key 方式：Authorization: Bearer または X-API-Key ヘッダーに付けた key は正しいですか。key は期限切れになっていないか、WEBHOOK_TRIGGER スコープを持っているかを確認してください。
2. HMAC 兼容方式：你是否用 HMAC-SHA256 对 raw body 算了签名，放 X-Webhook-Signature 头？格式是 sha256=<hex>。注意：绑定了 API Key 的 webhook 不再接受 HMAC 签名。
3. URL path 内の webhook ID は正しく書かれていますか。対応する workflow が削除されていないかを確認してください。

Webhook 200 をトリガーしても実行が開始されない

200 は「リクエストが受け入れられた」ことのみを意味し、実行が拒否される場合があります。

• ワークフローが一時停止されているかどうか。
• このパッケージが同時実行/スケジュール割り当てに達しているかどうか。
• 本文が変数にマップされているときに検証が失敗しました (必須フィールドが欠落している/型が間違っています)。

Webhook トリガー ログ - スケジュールの詳細ページの [履歴] タブで、リクエストを受信した後のプラットフォームの分析の詳細を確認できます。

承認関係

Manual_approval プッシュ通知を行わない

1. 「通知設定」ページは、Slack / Feishu / Email のいずれかのチャネルにバインドされていますか?
2. 監査ログ → フィルター承認_notify_failed - 通知が送信できない理由を確認します (Webhook の URL が無効ですか? メールのバウンス?)。
3. 承認者リストが空の場合、デフォルトで「すべての管理者以上」に通知されます。あなたのアカウントはそのうちの 1 つですか?

承認しましたが、ワークフローが続行されませんでした

承認後のワークフローは 10 秒以内に続行する必要があります。 1分以上続かなかった場合:

1. 実行の詳細ページを更新します。すでに実行中ですか?
2. システムがビジー状態のため、30 秒間キューに入れられる可能性があります。など。
3. 5 分以上経ってから作業指示を出します。

チーム/権限関連

チームを切り替えた後、ワークフローが表示されない

ワークフローはチームごとに分離されており、チーム全体では表示されません。正しいチームを選択していることを確認してください (右上隅のプルダウン)。 「個人」から「チーム」に切り替える場合は、チームでワークフローを作り直すか、個人から移行する必要があります。

同僚が、特定のワークフローを変更する権限がないと言う

彼はこのチームの視聴者ですか?ビューアは読み取り専用です。彼を管理者から編集者にアップグレードするだけです。

私はオーナーではありませんが、作成したワークフローを転送したいです

「チームに移動」するには、対象チームの編集者以上である必要があります。あなた自身がターゲットチームに参加するだけです。

支払い/請求書

クレジットカードの請求に失敗しました

1. 請求ページ→「引き落としを再試行」。 3 回失敗すると、パッケージは一時的に無料にダウングレードされますが、14 日以内に金額を正常に差し引く限り、自動的に復元されます。
2. 中国のカードは Stripe によってリスク管理されている可能性があります。Alipay/WeChat Pay をご利用ください。

請求書のタイトルが間違っています

翌月の請求書発行前であれば、請求ページで宛名を変更できます。すでに発行済みの請求書は、billing@braidrun.com へメールで無効化と再発行を申請する必要があります。

すべて試しましたが、まだ機能しません

1. 右下の「ヘルプ」→作業指示を送信します。ブラウザコンテキスト+最新の実行IDを自動的に付加します。
2. エンタープライズ プラン → 専用の CSM に直接お問い合わせください。