어휘

플랫폼의 모든 고유명사, 약어, 일반 용어는 영어와 중국어로 제공됩니다. 첫 글자를 기준으로 정렬합니다. 다른 문서를 읽을 때 의심스러운 점이 있으면 다시 돌아와서 확인하세요.

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 표현식(분 시 일 월 요일)을 받습니다. 각 스케줄 항목에는 독립적인 시간대 설정이 있으며, 다중 인스턴스 배포에서는 분산 락으로 같은 시각에 한 번만 트리거됨을 보장합니다.

D

DAG

Directed Acyclic Graph。플랫폼의 시각적 모델링 보기. 각 노드는 단계이며 가장자리는 실행 순서/데이터 종속성을 나타냅니다. YAML 바이트 수준을 사용한 양방향 동기화.

DTO

Data Transfer Object。JSON API의 페이로드 형식은 camelCase를 사용합니다. 해당 YAML은 snake_case를 사용합니다. 플랫폼이 실행 중일 때 자동 양방향 변환.

Dry-run

실행 중 옵션입니다. 데이터 흐름 살펴보기, 변수 채우기 및 부작용이 없는 단계 실행(LLM/실제로 메시지 보내기)은 건너뜁니다. DAG 연결을 확인하는 데 사용됩니다.

E

실행하다 / Execution

워크플로의 특정 실행 인스턴스입니다. 상태 머신: PENDING → RUNNING → (COMPLETED / FAILED / CANCELED / INTERRUPTED / TIMED_OUT).

extract

단계 필드. JSONPath를 사용하여 단계의 원래 출력에서 여러 필드를 선택하고 정확한 다운스트림 참조를 위해 .data 하위 노드에 저장합니다.

F-G

FeatureGate

구독 요금제(Free/Pro/Team/Enterprise)별로 기능 가용성 및 리소스 할당량을 제어하는 서비스입니다. 워크플로 수, 작성할 수 있는 일정 수, 디버거 사용 가능 여부를 결정합니다.

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개 이상의 설치 가능한 모듈이 있습니다.

데이터 마이그레이션

플랫폼이 업그레이드되면 데이터 구조 마이그레이션 프로세스가 자동으로 실행됩니다. 분산 잠금은 인스턴스 전체에 사용되어 하나의 노드만 실행되도록 합니다.

P

Preset

에이전트 템플릿. "모델 + 기본 도구 세트 + 시스템 프롬프트 + max_iterations + 전략"을 명명된 템플릿에 패키지합니다. 플랫폼에는 유니버설/코더/연구원/작가/기획자/리뷰어 등이 내장되어 있습니다.

Provider

LLM 서비스 제공업체. OpenAI / Anthropic / DeepSeek / Kimi / 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 / 간격 / 일회성의 세 가지 범주를 지원합니다. 각 일정은 입력 매개변수 + 시간대를 사용하여 미리 설정할 수 있습니다.

Skill

Agent가 호출할 수 있는 도구입니다. 내장된 래그/웹/파일/셸 또는 MCP 서버에서 등록된 사용자 정의 도구.

SSE

Server-Sent Events。Execution의 실시간 이벤트 스트리밍 프로토콜인 브라우저의 EventSource는 직접 구독합니다. 각 이벤트는 구조화된 JSON의 한 줄입니다.

Step

워크플로의 가장 작은 실행 단위입니다. 각 단계에서는 1개의 기본 모드(single/group_chat/agent_based/code/classifier/state_machine/sub_workflow/manual_approval)만 선택할 수 있으며 조건/재시도/추출/집계/멱등성/on_success/on_failure 등의 개선 사항을 중첩할 수 있습니다.

state_machine

단계 유형. 여러 상태 + 상태 전환 조건이 내장되어 있어 소규모 프로세스가 포함된 여러 반복 또는 워크플로에 적합합니다.

sub_workflow

단계 유형. 다른 워크플로(또는 내장 모듈)를 블랙박스로 호출합니다. 계약 확인, 루프 감지 및 변수 격리가 포함됩니다.

T-U

Team

사용자의 모음입니다. 공유 자격 증명 네임스페이스 및 공유 일정 할당량. 팀 관리자는 구성원과 자격 증명을 관리할 수 있습니다.

Tool

LLM 추론 중에 에이전트가 호출할 수 있는 함수입니다. 내장 + MCP 확장.

TPM

Tokens Per Minute。LLM 제공자의 현재 제한 표시기입니다. 업스트림 폭파를 방지하기 위해 플랫폼 내부에는 자체 제한 TPM이 있습니다.

V-W

Variable Reference

{{...}} 문법. 4개의 소스를 참조할 수 있습니다: var:* / steps.id.* / classifier.* / credential.*.

Webhook

외부 시스템이 POST로 워크플로 실행을 트리거하는 endpoint입니다. API Key 인증을 주로 사용하고 HMAC 서명을 호환 방식으로 사용합니다. 요청 본문의 최상위 필드는 기본적으로 자동으로 workflow 변수로 매핑되며, variableMapping으로 명시적으로 지정할 수도 있습니다.

Workflow

DAG에서 구성한 단계 모음입니다. /cron/webhook/API에 의해 수동으로 트리거될 수 있습니다. YAML을 사용하여 스토리지를 유지하세요.

Y

YAML

플랫폼의 워크플로 지속성 형식입니다. 필드는 snake_case로 이동합니다(DTO의 camelCase로 자동 매핑됨). CLI(braidrun-agent)에서 직접 실행할 수 있으며, 동일한 YAML을 웹 UI에서도 편집할 수 있습니다.