用語集

プラットフォーム上のすべての固有名詞、略語、一般用語は英語と中国語で記載されています。最初の文字で並べ替えます。他のドキュメントを読んで疑問がある場合は、戻って確認してください。

A

agent_based

ステップタイプです。オーケストレーター エージェントはタスクの説明を読み取り、どのワーカー エージェントにサブタスクを割り当てるかを動的に決定します。タスクに複数の分岐があり、各分岐で LLM の判断が必要なシナリオに適しています。

Agent

LLM セッションとその利用可能なツールをカプセル化するエンティティ。 Braidrun のエージェントはプリセットによって宣言され、必要に応じてオーバーライドされます。それ自体はステップではありません。ある種のステップ (シングル/グループチャット/分類子など) はエージェントを参照します。

API Key

LLM プロバイダーによって発行された認証キー。これはプラットフォームに資格情報として保存され、常に暗号化され、ログに表示されることはありません。

Artifact（成果物）

ステップの実行中に生成されたファイル (Markdown、Excel、画像、JSON など)。これをプラットフォームの製品ディレクトリに保存し、実行の詳細ページからダウンロードできます。

監査ログ / Audit Log

プラットフォーム内のすべての「ユーザーアクション + システムイベント」の構造化されたログ。管理者はバックグラウンドでチェックでき、デフォルトでは無期限に保持されます。

B

ブレークポイント / Breakpoint

デバッガーで設定できる一時停止位置は全 9 種類です: ステップ前、ステップ後、ステップエラー、ステートマシンの状態、グループチャットのラウンド、イテレーション項目、agent_based のディスパッチ、サブワークフロー入口、サブワークフロー出口。ブレークポイントには条件式を付加でき、ヒットすると execution が一時停止し、変数を検査 + 編集できます。

BYOK

Bring Your Own Key。ユーザーは自分の LLM プロバイダーの API キーを持参します。トークンのコストはユーザー自身のアカウントに請求され、プラットフォームの割り当ては考慮されません。

C

classifier

ステップタイプです。 LLM は入力にカテゴリ ラベルを割り当て、出力を渡すことができます。 {{classifier.category}} 後続のステップでルーティング条件として使用されます。

code

ステップタイプです。 Python/Bash/TypeScript スクリプトは分離されたサンドボックスで実行され、決定論的な LLM シナリオに推奨されます。

Condition

ステップレベルのブール式。 false の場合、ステップは SKIPPED としてマークされ、実行はスキップされます。下流でも使用可能 {{steps.x.status}} スキップされたかどうかを確認します。

Credential（資格情報）

AES-256-GCM は、保存された外部キーを暗号化します。ユーザー/チーム/システムの 3 レベルの名前空間によって解決されます。ログや YAML エクスポートには決して表示されません。

cron

スケジュールトリガーの一種です。標準的な 5 セグメントの cron 式（分 時 日 月 曜日）を受け付けます。各スケジュール項目は独立したタイムゾーン設定を持ちます。マルチインスタンス展開では、分散ロックにより同一時刻に 1 回だけトリガーされることが保証されます。

D

DAG

Directed Acyclic Graph。プラットフォームのビジュアルモデリングビュー。各ノードはステップであり、エッジは実行順序とデータの依存関係を表します。 YAML バイトレベルでの双方向同期。

DTO

Data Transfer Object。JSON API のペイロード形式はキャメルケースを使用します。対応する YAML は、snake_case を使用します。プラットフォームの実行中に自動双方向変換。

Dry-run

実行時のオプションです。データ フローの実行、変数の入力、および副作用のないステップ (LLM/実際にメッセージを送信する) の実行はスキップされます。 DAG 接続を検証するために使用されます。

E

実行する / Execution

ワークフローの特定の実行インスタンス。ステート マシン: PENDING → RUNNING → (COMPLETED / FAILED / CANCELED / INTERRUPTED / TIMED_OUT)。

extract

ステップフィールド。 JSONPath を使用して、ステップの元の出力からいくつかのフィールドを選択し、正確なダウンストリーム参照のために .data サブノードに保存します。

F-G

FeatureGate

サブスクリプション プラン (無料/プロ/チーム/エンタープライズ) ごとに機能の可用性とリソース割り当てを制御するサービス。ワークフローの数、構築できるスケジュールの数、およびデバッガーを使用できるかどうかを決定します。

group_chat

ステップタイプです。複数のエージェントが順番に話し、互いのコンテキストを参照します。ブレーンストーミングや批判的なレビューに適しています。

H-I

HMAC

Webhook 触发的兼容认证方式。外部调用方用共享密钥对 raw body 算 HMAC-SHA256，以 sha256=<hex> 格式放进 X-Webhook-Signature 头。新接入建议直接用带 WEBHOOK_TRIGGER 范围的 API Key。

idempotent

ステップフィールド。 「同じ入力→同じ出力、副作用なし」を約束します。自動再開がオンになっている場合、完了したべき等ステップのやり直しをスキップできます。

M

manual_approval

ステップ タイプ (任意のステップの拡張としても使用可能)。実行フローは管理者の承認/拒否を待ってここで停止します。構成可能な通知チャネルと承認者リスト。

MCP

Model Context Protocol。ツール間の標準プロトコル。 Braidrun は、MCP クライアントが外部 MCP サーバーを使用するためのツールとして使用でき、MCP サーバー モードでその機能を外部に公開することもできます。

モジュール / Module

WorkflowModuleContract を実装した workflow です。sub_workflow step を通じて、他の workflow からブラックボックスとして呼び出せます。マーケットプレイスには 120 以上のインストール可能なモジュールがあります。

データ移行

データ構造の移行プロセスは、プラットフォームがアップグレードされると自動的に実行されます。分散ロックはインスタンス間で使用され、1 つのノードのみが実行されるようにします。

P

Preset

エージェントのテンプレート。 「モデル + デフォルト ツールセット + システム プロンプト + max_iterations + ストラテジー」を名前付きテンプレートにパッケージ化します。プラットフォームにはユニバーサル/コーダー/リサーチャー/ライター/プランナー/レビューアーなどが組み込まれています。

Provider

LLM サービスプロバイダー。 OpenAI / Anthropic / DeepSeek / Kim / OpenRouter など。プロバイダーは複数の API キー (認証情報) にバインドできます。

R

RAG

Retrieval-Augmented Generation。組み込みナレッジ ベースでベクトル検索を実行するエージェント ツールセットの一種。プラットフォームは、検索結果をエージェントのコンテキストに自動的に挿入します。

Recovery Policy

自動継続の戦略オプション: ABORT (継続しない) / RESUME_FROM_LAST_INCOMPLETE (中断されたステップから継続) / RESUME_FROM_START (最初から再開)。

Round-trip（双方向同期）

YAML → DAG → YAML はバイトレベルの等価性をそのまま維持します。コメント、順序、書式は失われません。

S

single

ステップタイプです。単一のエージェント + タスクの説明。最も軽量な LLM 呼び出しプリミティブ。

Sandbox（サンドボックス）

コードステップの実行環境。運用環境でワンタイム分離サンドボックスを使用し、最小権限/読み取り専用ルート/送信ネットワークを使用します。

Schedule

特定のワークフローを定期的にトリガーするアイテム。 cron / インターバル / ワンタイムの 3 つのカテゴリをサポートします。各スケジュールは、入力パラメータとタイムゾーンを使用して事前に設定できます。

Skill

エージェントが呼び出すことができるツール。組み込みの rag/web/file/shell、または MCP サーバーから登録されたユーザー定義ツール。

SSE

Server-Sent Events。Execution's real-time event streaming protocol, the browser's EventSource subscribes directly.各イベントは構造化された JSON 行です。

Step

ワークフローの最小実行単位。各ステップではメイン モードを 1 つだけ選択できます (シングル / グループ チャット / エージェント ベース / コード / 分類子 / 状態マシン / サブワークフロー / マニュアル承認)。条件 / 再試行 / 抽出 / 集約 / べき等 / on_success / on_failure などの拡張機能を重ね合わせることができます。

state_machine

ステップタイプです。複数の状態 + 状態遷移条件が組み込まれているため、複数の反復や小規模なプロセスを含むワークフローに適しています。

sub_workflow

ステップタイプです。別のワークフロー (または組み込みモジュール) をブラック ボックスとして呼び出します。コントラクト検証、ループ検出、変数分離機能を備えています。

T-U

Team

ユーザーの集合体。共有資格情報ネームスペースと共有スケジュール クォータ。チーム管理者はメンバーと認証情報を管理できます。

Tool

LLM 推論中にエージェントが呼び出すことができる関数。組み込み + MCP 拡張機能。

TPM

Tokens Per Minute。LLM プロバイダーの電流制限インジケーター。上流の爆発を避けるために、プラットフォーム内に自己制限 TPM があります。

V-W

Variable Reference

{{...}} 文法。 var:* /steps.id.* / classifier.* / credentials.* の 4 つのソースを参照できます。

Webhook

外部システムからの POST でワークフロー実行をトリガーする endpoint です。API Key 認証を主とし、HMAC 署名を互換方式とします。リクエストボディのトップレベルフィールドは、デフォルトで自動的に workflow 変数にマッピングされ、variableMapping で明示的に指定することもできます。

Workflow

DAG によって整理されたステップのコレクション。 /cron/webhook/API によって手動でトリガーできます。 YAML を使用してストレージを永続化します。

Y

YAML

プラットフォームのワークフロー永続形式。フィールドは、snake_case になります (DTO の CamelCase で自動的にマップされます)。 CLI (braidrun-agent) で直接実行でき、同じ YAML を Web UI で編集することもできます。