AI 도우미를 사용하여 조율

Braidrun의 AI 도우미는 플러그인 도구 모음이 아닙니다. YAML, DAG 및 현재 페이지의 실행 상태를 직접 이해하고 워크플로를 변경하고, 실행을 트리거하고, 기술을 설치하고, 언어를 전환할 수 있습니다. 시작하고 매일 사용하는 방법은 다음과 같습니다.

어디서 열까

• 오른쪽 하단에 있는 플로팅 버튼(모든 기본 페이지에서 사용 가능)
• 단축키Alt + G

서랍 내부에는 마크다운/코드 강조(12개 언어) 및 슬래시 명령을 지원하는 스트리밍 대화 패널이 있습니다.

무엇을 할 수 있나요?

• 워크플로우 생성/수정/검증/실행
• 일정 생성, 활성화 및 비활성화
• 스킬 새로 고침 또는 설치
• 인터페이스 언어 전환
• "이 시스템은 무엇을 지원합니까/특정 구성을 작성하는 방법/특정 API를 사용하는 방법"과 같은 체계적인 질문에 답변합니다.

슬래시 명령

/execute               # run the current workflow (alias: /run)
/validate              # validate YAML without running
/export                # download workflow YAML
/new                   # start a fresh workflow
/undo                  # roll back the last assistant change (up to 10)
/help                  # list all slash commands

입력창에서 "/"로 시작하면 트리거됩니다. slash 명령은 자유 텍스트보다 우선순위가 높고, 플랫폼 인터페이스를 직접 호출하며 모델을 거치지 않으므로 AI 어시스턴트의 일일 쿼터를 소모하지 않습니다. 편집기 / 워크플로 목록 등 페이지에서는 입력창 위에 해당 단축 버튼도 나타납니다.

Diff 미리보기 및 실행 취소 스택

워크플로/일정/자격증명 등 리소스에 대한 모든 변경 사항은 먼저 Diff 미리보기를 제공합니다.

• 새 단계/필드는 녹색으로 강조 표시됩니다.
• 수정된 필드는 노란색으로 표시됩니다.
• 삭제된 단계/필드는 빨간색으로 강조 표시됩니다.

확인 후 언제든지 /undo를 사용하여 최대 10개의 수정 사항을 유지하면서 롤백할 수 있습니다. 한 번의 클릭으로 세션 자체를 Markdown으로 내보낼 수도 있습니다.

편집기와의 연동

• 편집기에서 어시스턴트에게 워크플로를 구성 / 수정하게 하면, 캔버스가 작업 순서대로 각 변경을 단계별로 표시합니다: 노드 추가, 연결선이 하나씩 나타나 워크플로가 자라나는 것을 볼 수 있습니다. 변경 사항은 여전히 저장을 눌러야 DB에 반영됩니다.
• 편집기의 진단 문제 패널에서는 단일 또는 전체 문제를 「AI에게 수정 맡기기」할 수 있고, 단계 속성 패널에도 현재 단계의 컨텍스트를 담아 어시스턴트를 바로 여는 진입점이 있어 YAML을 직접 복사·붙여넣을 필요가 없습니다.
• 어시스턴트가 수정한 각 단계도 편집기 자체의 실행 취소 / 다시 실행 이력에 들어가며, Ctrl / Cmd + Z로 단계별로 되돌릴 수 있습니다.

편집기 각 영역의 전체 설명은 비주얼 편집기.

준비: AI 도우미 구성

처음 이용하기 전에 꼭 가보세요 계정 설정 → AI 어시스턴트 모델 공급자(예: OpenRouter, OpenAI, Anthropic, DeepSeek)를 열고 선택하거나 Claude Code / Codex 영역에서 구독 모델을 구성하세요. 진짜 비밀은 여기에 있다 자격증명 관리 → 내 자격증명 유지 관리, 실행 시 현재 계정에 따라 자동으로 해결됩니다. 관리자는 일반 사용자를 위해 AI 도우미를 미리 구성할 필요가 없습니다.

클로드 코드 / Codex 모델

AI 어시스턴트가 Claude Code 또는 Codex를 호출하도록 하려면 계정 설정 → AI 어시스턴트 → Claude Code / Codex에서 인증 방식을 선택하세요.

• 클로드 코드: Anthropic API Key 또는 Claude 구독 토큰(provider=claude_code_oauth)을 사용할 수 있습니다.
• Codex: OpenAI API 키를 사용하거나 Codex를 사용하여 auth.json(provider=codex_subscription)을 구독할 수 있습니다.
• 구독 모드는 AI 보조 구성에 토큰/auth.json을 쓰지 않습니다. 개인 자격 증명이나 팀 자격 증명에서만 읽습니다.

문서 지식 베이스

AI 도우미가 시스템 문서 질문(예: "manual_approval의 기본 시간 제한은 무엇입니까?")에 대답하도록 하려면 다음으로 이동하세요. 설정 → 플랫폼 지속성 스토리지 → AI Assistant 문서 기술 자료 활성화되어 있는지 확인하세요. 기본 제공 가이드, 프로젝트 마스터 문서 및 선택한 참조 문서는 기본적으로 색인화되며 시작 시 자동 빌드가 기본적으로 활성화됩니다. 상태를 확인하고 동일한 페이지에서 "기술 자료 재구축"을 수동으로 클릭할 수 있습니다.

"사고 과정" 추론 스트리밍

선택한 모델이 추론을 지원하는 경우(Claude Sonnet 4.5/4.6/4.7, DeepSeek-R1, GPT-o1/o3 시리즈, Gemini Thinking 등), AI 보조 서랍에는 먼저 접힌 "AI 보조자의 사고 과정" 카드가 표시됩니다. 모델은 먼저 여기에 추론 요약을 전달한 다음 최종 답을 생성합니다.

• Reasoning_delta 이벤트는 클라이언트에 의해 축소되며 화면을 새로 고치지 않습니다(매 프레임마다 다시 렌더링하지 않음).
• 완전한 추론은 Reasoning_complete일 때 사고 하위 범주로만 렌더링됩니다.
• 확장/축소하려면 사고 카드를 클릭하세요. 시야를 차지하지 않도록 기본적으로 축소되어 있습니다.
• 생각 내용은 검토를 용이하게 하기 위해 /undo와 함께 실행 취소 스택에 기록됩니다.

추론을 지원하지 않는 모델은 추가 카드를 표시하지 않으며 이전과 같이 작동합니다.

장기 기억

AI 도우미는 기본적으로 세션별로 독립적입니다. 기본 설정("중국어 답변 + 짧은 마크다운을 좋아합니다", "내 ASA 워크플로는 항상 아침 일찍 실행됩니다")을 "기억"하려면 AI Assistant 구성에서 장기 메모리를 켤 수 있습니다.

• 활성화한 후에는 사용자 메시지와 보조자 응답이 벡터화되어 교차 세션 ltm:<user_id>:* 네임스페이스에 저장됩니다.
• 다음 대화 라운드가 시작되면 Top-K 관련 메모리가 컨텍스트 주입으로 자동 검색됩니다.
• AI 어시스턴트 사이드바 오른쪽 상단에 '장기 기억 지우기' 버튼이 있습니다. POST /api/global-agent/memory/clear는 한 번의 클릭으로 현재 사용자의 모든 네임스페이스를 지웁니다. 장치 변경/팀 전환 시 사용하기에 적합합니다.

팁

• AI가 YAML을 생성하도록 하려면: snake_case YAML을 출력하도록 명시적으로 요청하세요.
• 분기 흐름: 분류기 + 조건의 구조 생성을 우선시합니다.
• 큰 변화: 자연어를 사용하여 의도를 설명하고 이를 다단계 Diff로 나눕니다.
• 결합하다 디버거 : After the AI modification is completed, enable debug and dry-run the workflow before going online.
• 추론을 지원하는 모델을 선택할 때 '사고 과정'을 직접 볼 수 있으며 디버깅 프롬프트 디자인이 매우 유용합니다.