ドキュメント参照FAQ

FAQ

招待コード、請求、BYOK、データプライバシー、インポート/エクスポートに関するよくある質問。

高頻度の質問はトピックごとにグループ化されています。見つからない場合は、まずキーワードを検索し、それでも解決しない場合は、「トラブルシューティング」ページにアクセスして一般的な症状を確認してください。

アカウントと登録

登録には招待コードが必要ですか？

必要ありません。現在は登録を開放しており、/register でメールアドレスを使って直接登録するか、下記のいずれかのサードパーティログインを使用できます。

国内のメールアドレスで登録できますか？

はい。 QQ / 163 / Alibaba / Tencent の企業メールボックスはテスト済みです。場合によっては、アクティベーションメールがスパムフォルダーに入ってしまうことがありますので、注意深く確認してください。

1つのメールアドレスで複数のアカウントを登録できますか?

いいえ。1 つのメール = 1 つのアカウントです。 2 セットの「開発/運用」アカウントが必要な場合は、+ エイリアス (+dev@gmail.com) を使用します。

Google / GitHub / Feishu / DingTalk を使用してログインできますか?

できます。Braidrun は全 14 種類のサードパーティログインに対応しています: Google · GitHub · GitLab · Microsoft · Apple · Slack · LinkedIn · WeChat · Alipay · Feishu · Lark · DingTalk · Gitee、および OpenID Connect 標準に準拠した任意の企業向け SSO（例: Keycloak / Authentik / Okta / Auth0）。ログインページには、現在の環境で有効になっている選択肢のみが表示されます。

サブスクリプションと請求

Free プロとの最大の違いは何ですか？

無料版には 3 つの基本的なステップタイプ (単一/コード/分類子) のみがあり、スケジュール/Webhook/ブレークポイントデバッガー/自動継続はありません。「体験」に最適です。実際の運用シナリオでは Pro 以降が必要です。

月払いと年払いを自由に切り替えられますか？

はい。「アカウント設定」→「請求」で請求サイクルを切り替えると、次の請求サイクルが有効になります。月払いから年払いに切り替えると、すぐに割引が適用されます。年払いから月払いに変更した場合は、年払いが発生します。

請求書は会社宛に発行してもらえますか？

はい。中国は一般 VAT 請求書/特別な請求書をサポートしています。請求書ページでヘッダーと税番号を入力すると、各控除が自動的に生成されます。企業は資金と契約を一般に送金できます。

割り当てを超過した場合はどうなりますか?

既存のワークフローと実行は引き続き実行されますが、新しいワークフローと実行は拒否されます (アップグレードを求めるポップアップウィンドウが表示されます)。早期処理のために 80% / 95% 警告を使用することをお勧めします。

BYOK/LLM コスト

BYOKである必要がありますか?

Free/Pro には、少量の組み込み共有プールキークォータと十分なトラフィックがあります。本当に量を増やしたい場合は、BYOK をお勧めします。クォータはより十分であり、コストは低くなります (特に、DeepSeek を大規模に呼び出す場合)。

Braidrunの料金はいくらですか?

BYOK に基づく価格の値上げはありません。プロバイダー側で実際に支払うのが本当の費用です。 Braidrun の収益はサブスクリプション料金から来ており、トークンからの手数料は取っていません。

ワークフローの実行コストを確認できますか?

できる。実行の詳細ページの上部には、トークン + コスト (プロバイダーの公開価格に従って換算) が表示されます。データダッシュボードは日/週/月ごとに集計されます。

プロバイダーが突然料金を値上げしたらどうなりますか?

プロバイダーの価格リストの変更はプラットフォームによって取得され、コストの見積もりが更新されます。実際の請求は常にプロバイダー側で決済されます。

データプライバシー

私のデータはモデルのトレーニングに使用されますか?

いいえ、Braidrun 自体はモデルをトレーニングしません。 BYOK の場合、データの宛先は選択したプロバイダーによって決まります。OpenAI / Anthropic のデフォルトポリシーは「トレーニングには使用されません」であり、コンソールでさらにオプトアウトできます。

認証情報が侵害される可能性はありますか?

資格情報は AES-256-GCM で暗号化され、資格情報センターに保存されます。ランタイム復号化は、単一ステップのコンテキストでのみ有効です。ログは書き込まれず、YAML エクスポートも実行されず、他のステップは表示されません。 DB ダンプで取得できるのは暗号文です。

私のワークフロー YAML はプライベートですか?

はい。個人のワークフローはあなただけに表示されます。チームワークフローは、役割ごとにチームメンバーにのみ表示されます。 Braidrun の従業員には、運用環境でユーザーのワークフローを表示するためのバックドアはありません。企業の民営化展開では、この層もクライアントのイントラネットによって管理されます。

データはどこに存在しますか?

SaaS バージョンは、香港 / シンガポール / AWS 東京リージョンで利用可能です。 Enterprise は完全に顧客側でプライベートに展開されます。詳細については、「データ処理契約 (DPA)」文書を参照してください。

テンプレートとインポートとエクスポート

テンプレートは自分のワークフローとどのような関係がありますか?

自分のワークスペースにクローンを 1 つ作成します。あなたの変更はテンプレートに戻ることはなく、テンプレートの更新もあなたのコピーを自動的に変更しません。ただし、クローン時に「どのテンプレートのどのバージョン由来か」が記録されます。テンプレートに新バージョンが公開された後、まず変数の差分をプレビューしてからワンクリックでアップグレードできます。アップグレード前にバージョンスナップショットが自動保存され、あなた自身が選んだモデル設定は保持されます。手順は以下を参照してくださいテンプレートからインスタンス化するの「テンプレートのアップグレード」セクションを参照してください。

Dify / Langflow / n8n からインポートできますか?

Dify ワークフローは、ワンクリックインポートをサポートしています (YAML 形式に自動的に変換されます)。 Langflow と n8n は現在ネイティブインポートをサポートしていませんが、AI アシスタントが JSON エクスポートを読み取り、Braidrun YAML に「変換」できます。

ワークフローを別の形式にエクスポートできますか?

YAML エクスポートは最も権威があります。これは Braidrun のネイティブ形式であり、CLI (braidrun-agent) で直接実行することもできます。一方向の伝達関数はありません。

実行とスケジューリング

執行が失敗した場合、お金は返金されますか？

Braidrun は視聴ごとに料金を請求しないため、返金の必要はありません。障害発生時に発生する LLM トークンの消費は、プロバイダーアカウント (BYOK) に記録されます。障害の原因がプラットフォームの問題であると思われる場合は、作業指示を送信できます。プロバイダーにクレジットを求めるお手伝いをいたします。

cron トリガーがトリガーされない場合のトラブルシューティング方法は?

まず、スケジュールの詳細ページで「次のトリガー時間」を確認します。「最新のトリガー履歴」をもう一度確認して、スロットリングされているかどうかを確認します。詳細な手順については、を参照してください。トラブルシューティング。

複数のインスタンスをデプロイする場合、cron は 2 回トリガーされますか?

しません。分散ロックはプラットフォーム内で使用され、同じスケジュールが同じ分に 1 台のマシンでのみトリガーされるようにします。自動再開中には、2 つのノードが同時に同じ実行を再開することを防ぐための専用ロックもあります。

サービスの再起動/OOM 後、ワークフローはどうなりますか?

デフォルトでは、実行中のすべての実行は中断としてマークされるため、[ステップから再開] を手動でクリックする必要があります。これは、テレグラム/広告価格の変更/電子メールの送信などの副作用のあるステップが誤って繰り返しトリガーされるのを防ぐためのデフォルトの動作です。

ワークフローが「純粋なデータパイプライン」 (読み取り専用 API、純粋な計算、ローカルアーティファクトの書き込み) の場合は、自動回復をオプトインできます。recovery.autoResumeOnRestart: true をワークフロー YAML に追加し、idempotent: true を各再実行可能なステップに追加します。詳細については、/docs/run/recovery を参照してください。

コラボレーションと移行

個人アカウントをチームにアップグレードするにはどうすればよいですか?

まずチームパッケージにアップグレード→チームの作成→「既存のワークフローをチームに移動」します。過去の実行記録も一緒に移行されます。

チームは誰が何を変更したかを確認できますか?

できる。ワークフロー/資格情報/スケジュール/承認におけるすべての変更はチーム監査ログに記録され、所有者/管理者の役割を持つチームメンバーが参照できます。同時に、ワークフローのバージョン履歴で各保存の作成者を確認できます。

仕事を辞めました。リソースを引き継ぐにはどうすればよいですか?

あなたがオーナーであるチームの所有権を後継者に譲渡します。
個人の名前空間の資格情報を使用すると、後任者は Team 名前空間の下に新しいコピーを作成できます。
個人のワークフローを後任者にエクスポートします。
最後に個人アカウントからログアウトします。

開発者の問題

REST APIはありますか?プログラムで駆動できるのでしょうか？

持っている。 3 つの認証方法:

API キー (CI/オートメーションに推奨) — アカウント設定の作成、形式 dyk_<id>_<secret>、スコープ (WEBHOOK_TRIGGER / WORKFLOW_EXECUTE / EXECUTION_READ など) によって許可、有効期限を設定可能
パスワードログインベアラーJWT — POST /api/auth/login アクセス (15 分) + リフレッシュ (7 日間) トークン。デバッグ中にのみ使用され、CI は API キーを使用します
Cookie（ブラウザ） — SPA は HttpOnly Cookie + CSRF を使用します。詳細については、アカウント設定ページを参照してください

ワークフロー内でプラットフォーム API をコールバックする必要がある場合 (たとえば、組み込みモジュールを介してパブリックリンクを作成する場合)、トークンを手動で管理する必要はありません。エンジンは短期の WF_API_TOKEN 環境変数を自動的に挿入します。詳細については、開発者マニュアルを参照してください。

CLIはサポートされていますか?

サポートします。 braidrun-agent CLI は YAML をローカルで実行できます。Web 側のワークフロー YAML と 100% 互換性があります。 CI 統合に適しています。

ローカルに展開できますか?

Enterprise プランは完全なプライベート展開をサポートします。オープンソースバージョンにはデプロイヤー/ツールが付属し、Vultr / AWS / Aliyun マルチクラウドプロバイダー、CLI + GUI の 2 つのモードをサポートし、プロビジョニング / スケール / ローリングデプロイ / ロールバック / スケールコントローラーのインストールを完了できます。 Pro/Team プランは現在、Braidrun SaaS でのみ利用可能です。

WebSocket認証はどのように行うのでしょうか？

POST /api/auth/ws-ticket を使用して、ハンドシェイクに ?ticket=<value> を指定して 30 秒の TTL シングルチケットを取得します。このチケットプロセスは、2026-05 の古い Sec-WebSocket-Protocol: <JWT> パスを置き換えます (古いパスはダウングレードソリューションとして保持されます)。フロントエンドの composables/useExecutionWebSocket.ts はカプセル化されています。

私の POST リクエストが常に 403 csrf_token_mismatch を報告するのはなぜですか?

2026 年 5 月 8 日以降、プラットフォームはデフォルトで HttpOnly Cookie + 二重送信 CSRF 検証を有効にします。フロントエンド SPA は次のことを行う必要があります。(1) GET /api/auth/csrf 初めてロードするときに dy_csrf Cookie を取得します。 (2) すべての POST/PUT/PATCH/DELETE リクエストは、Cookie 値を X-CSRF-Token ヘッダーにエコーします。 (3) axios には withCredentials: true が装備されています。時間を測定するには、curl を直接使用します。curl -c /tmp/jar https://host/api/auth/csrf まず Cookie を取得し、次に -b /tmp/jar と -H X-CSRF-Token: ... を使用します。

製品のフィードバック

テンプレート/ステップタイプ/インテグレーションを追加してほしい

アカウント設定→「製品フィードバック」で送信すると、毎月の優先評価に入力されます。採用された機能は、変更ログで目立つように表示されます。

バグに遭遇しました

右下の「ヘルプ」ボタンを押すとバグチケットが発行され、ブラウザ環境と最新の実行IDが自動で付与されます。通常、24 時間以内に返信させていただきます。

次のステップ

トラブルシューティング — 特定の症状 → 修正
用語集 — 他の文書を読んで新しい単語に出会ったら、戻って調べてください