AI 어시스턴트 개요
무엇을 할 수 있는지, 어디서 여는지, 모델을 어떻게 설정하는지, 그리고 할당량을 쓰지 않는 슬래시 명령과 페이지 단축 동작.
AI 어시스턴트는 YAML만 찍어 내는 생성기가 아닙니다. 열려 있는 워크플로, 선택한 스텝, 지금 보고 있는 실행 등 현재 페이지의 맥락을 읽기 때문에 흐름을 만드는 일뿐 아니라 오류 조사, 작업 실행, 설정 변경까지 도와줍니다.
어디서 열까
- 오른쪽 아래 플로팅 버튼 — 모든 주요 페이지에 있습니다;
- 단축키
Alt + G; - 편집기의 진단 패널과 스텝 속성 패널에 있는 'AI에게 맡기기' 입구 — 여기로 들어가면 현재 맥락이 자동으로 따라갑니다.
할 수 있는 여섯 가지 일
| 카테고리 | 예시 |
|---|---|
| 워크플로 구성 | 처음부터 흐름 만들기, 기존 흐름의 한 스텝 고치기, 템플릿으로 초안 잡기, 검증 후 저장하기. |
| 실패한 실행 진단 | "이번 실행은 왜 실패했나", "고쳐서 다시 돌려 줘". |
| 템플릿과 모듈 추천 | 업무 목표를 설명하면 무리하게 새로 만들기보다 기존 템플릿과 공식 모듈에서 먼저 찾아 줍니다. |
| 스케줄과 앱 내 동작 | 정기 작업 만들기, 스케줄 켜고 끄기, 현재 워크플로 실행 또는 검증, 실행 취소, 스킬 새로 고침, 인터페이스 언어 전환. |
| 이동과 설정 | "스케줄 관리로 데려가 줘", "이 설정은 어디서 바꾸나". 순수 이동 요청은 모델을 거치지 않아 비용 없이 바로 이동합니다. |
| 플랫폼 질문 답변 | 특정 필드를 어떻게 쓰는지, 어떤 기능을 지원하는지, 특정 API를 어떻게 호출하는지. |
처음 한 번 설정하기
처음 쓰기 전에 가야 할 곳은 계정 설정 → AI 어시스턴트 켠 뒤 모델 provider(OpenRouter, OpenAI, Anthropic, DeepSeek 등)를 고르거나, Claude Code / Codex 영역에서 구독 모델을 설정합니다. 키 자체는 자격 증명 관리 → 내 자격 증명. 실행 시 현재 계정 기준으로 자동 해석되므로, 관리자가 일반 사용자를 위해 미리 설정할 필요가 없습니다.
세 가지 런타임 신원
어시스턴트 본체는 내장 엔진 Koog일 수도, Claude Code나 Codex 명령줄일 수도 있습니다 — 「계정 설정 → AI 어시스턴트」의 첫 항목인 어시스턴트 신원 유형에서 바꿉니다. 외부 신원에는 해당 구독 자격 증명이 필요하고, 대화 중에 워크플로를 고칠 수 있는지는 배포 설정에 달려 있습니다. 주로 흐름 만들기를 돕게 하려면 Koog에 머무는 편이 가장 간단합니다.
여기서 말하는 AI 어시스턴트는 당신 계정의 어시스턴트 설정을 쓰는, '당신과 플랫폼의 대화'입니다. 워크플로 YAML 최상위의 globalAgent 필드는 그 워크플로가 실행될 때 쓰는 자체 에이전트 설정이고, 둘은 서로 영향을 주지 않습니다.
슬래시 명령과 빠른 동작
입력창에서 '/'로 시작하는 명령은 모델을 거치지 않고 플랫폼 API를 직접 호출하므로 즉시 응답하며 어시스턴트 할당량도 쓰지 않습니다:
/new 新建工作流
/execute 执行当前工作流（别名 /run）
/validate 校验当前工作流
/export 导出当前工作流 YAML
/undo 撤销 AI 对工作流的上一次修改
/help 列出可用命令입력창 위에는 현재 페이지에 맞는 단축 버튼도 나옵니다. 편집기에서는 실행 / 검증 / 내보내기 / 되돌리기, 실행 상세에서는 진단 / 재시도, 워크플로 목록에서는 새로 만들기 / 템플릿에서 만들기, 실행 목록에서는 최근 실패 보기입니다.
이어서 보기
- 어시스턴트의 신원과 모델 전환하기 — 신원을 어떻게 고르고, 모델은 어디서 바꾸며, 오류는 어떻게 푸는지.
- 어시스턴트로 워크플로 만들기 — diff 미리보기, 되돌리기 스택, 캔버스 연동, 템플릿과 모듈 검색.
- 실패한 실행 진단 — 실패한 실행을 넘겨 원인 파악, 설명, 수정까지 맡기기.
- 세션, 기억, 백그라운드 실행 — 여러 세션 관리, 장기 기억, 창을 닫아도 계속되는 작업.