시작 메뉴 작업
시작 메뉴 작업은 MBAgent의 단축키 진입점으로, 자주 사용하는 작업을 버튼화하여 저장하고, 다음번에는 클릭만 하면 다시 기술하지 않고도 실행할 수 있습니다.
1. 시작 메뉴 작업이란 무엇인가?
시작 메뉴 작업 = 저장된 프롬프트 템플릿 + 옵션 실행 환경 설정.
| 시나리오 | 시작 메뉴 작업에 적합한지 |
|---|---|
| "영문 개발 이메일 작성" | ✅ 고빈도 사용 → 작업에 저장 |
| "223223 매장의 오늘 주문 확인" | ✅ 고정 환경 → 작업에 저장 |
| "D:\Downloads 아래 파일 정리" | ✅ 반복 조작 → 작업에 저장 |
| "시를 1수 지어줘" | ❌ 원샷 작업 |
2. 시작 메뉴 열기
MBAgent 메인 화면의 좌측 또는 상단에 "시작 메뉴" 진입점이 있습니다. 클릭하면 표시:
시작 메뉴는 검색 바 + 카테고리별 작업 목록(계정과 브라우저, 데이터 수집, 문서 처리, 자동화 스크립트 등) 구조를 포함합니다.
3. 시작 메뉴 작업 실행
1단계: 작업 찾기
- 시작 메뉴 목록에서 탐색
- 또는 검색 상자에 키워드 입력 (예: "주문", "보고서")
2단계: 작업 클릭
작업 버튼을 클릭하면 MBAgent가 자동으로:
- 작업 설명 읽기
- 입력란에 기입 (편집 가능)
- 실행 환경 (후니아오 환경, 모델 등) 설정
- 전송 대기
3단계: 확인 후 전송
- 입력란 내용 확인 (필요 시 수정)
- "전송" 버튼 클릭
- AI가 작업 실행 시작
TIP
빠른 실행: 작업 버튼을 더블 클릭하면 2단계를 건너뛰고 (입력란에 표시하지 않고) 직접 실행을 시작합니다.
4. 내장 작업 분류
MBAgent에는 여러 공식 작업이 함께 제공되며, 업무 시나리오별로 분류됩니다:
1. 계정과 브라우저
- 전 계정 순찰: 각 계정의 로그인 상태, Cookie, 지문 확인
- 지정 환경 실행: 환경 ID로 후니아오 환경 실행
- 환경 패키지 내보내기: 후니아오 환경을 백업용 패키징
2. 데이터 수집
- 오늘 주문 집계: 전 매장의 오늘 주문 수집
- 상품 가격 수집: 지정 웹사이트에서 상품 가격 추출
- 고객 정보 정리: 다중 데이터 소스에서 고객 정보 통합
3. 문서 처리
- Excel을 Markdown으로 변환: Excel 표를 markdown 형식으로 변환
- PDF에서 텍스트 추출: PDF에서 텍스트 내용 추출
- 일괄 이름 변경: 규칙으로 파일 일괄 이름 변경
4. 자동화 스크립트
- 모닝 체크 스크립트 실행: 매일 아침 자동 실행 체크 스크립트
- 일일 보고서 생성: 데이터에 기반한 자동 일일 보고서 생성
- 일괄 게시: 콘텐츠를 여러 플랫폼에 게시
5. 시스템 유지보수
- 후니아오 브라우저 버전 확인: 후니아오 최신 여부 탐지
- 임시 파일 정리: 워크스페이스 임시 파일 정리
- 중요 데이터 백업: AI 메모리 뱅크 및 KMS 자동 백업
5. 커스텀 작업 생성
1단계: "+" 버튼 클릭
시작 메뉴 상단의 "+" 버튼을 클릭하면 "새 작업" 창이 팝업됩니다.
2단계: 작업 정보 입력
| 항목 | 설명 | 예시 |
|---|---|---|
| 작업 이름 | 간결 명확 | "오늘 주문 집계" |
| 작업 분류 | 기존 분류 선택 또는 신규 생성 | 데이터 수집 / 보고서 생성 |
| 작업 설명 | AI가 받는 프롬프트 | "오늘 전 매장의 주문 수량을 집계하고 금액 내림차순으로 정렬하여 reports/orders-YYYYMMDD.xlsx에 기록" |
| 아이콘 | emoji 또는 codicon 선택 | 📊 |
| 실행 환경 | 옵션 | 후니아오 환경 ID / 병렬 수 / 타임아웃 |
3단계: 변수 사용 (옵션)
작업 설명에 플레이스홀더를 사용할 수 있으며, 실행 전에 사용자에게 기입을 요구:
{{고객명}}의 {{주문일}} 주문을 표로 정리해주세요실행 시:
[입력] 고객명 = 후니아오 플래그십 스토어
[입력] 주문일 = 2026-09-244단계: 저장
"저장" 버튼을 클릭하면 작업이 시작 메뉴에 표시됩니다.
6. 작업 편집 / 삭제 / 복사
편집
- 작업 우측 클릭 → "편집"
- 이름·설명·변수 등 수정
- 저장
삭제
- 작업 우측 클릭 → "삭제"
- 확인 (복원 불가)
복사
- 작업 우측 클릭 → "복사"
- 새 작업이 자동 생성 (이름에 "사본"이 붙음)
다른 분류로 이동
- 작업 우측 클릭 → "이동 대상..."
- 대상 분류 선택
7. 커스텀 분류
신규 분류 생성
- 시작 메뉴의 "+" 버튼 → "신규 분류" 클릭
- 분류명 입력 (예: "내 워크플로")
- 아이콘 선택
- 저장
분류 이름 변경
- 분류 제목 우측 클릭 → "이름 변경"
분류 삭제
- 분류 제목 우측 클릭 → "분류 삭제"
- 분류 내 작업은 "미분류"로 이동
8. 시작 메뉴 동기화 메커니즘
공식 작업 업데이트
후니아오 공식이 공식 시작 메뉴 XML을 유지하며, 새 버전 공개 시 모든 MBAgent 클라이언트로 푸시:
mbAgent 로컬 official.xml
→ POST /api/mbagent/start_menu_manifest
→ version + 디렉터리 트리 + 각 작업 content_hash 반환
→ 로컬에서 SHA-256에 기반하여 변화 없는 prompt 재사용
→ POST /api/mbagent/start_menu_contents
→ 각 prompt의 SHA-256 검증
→ 완전한 official.xml 재구축
→ 로컬 캐시를 원자적으로 교체핵심 설계:
- ✅ 클라이언트는 변화된 부분만 다운로드, 패키지 전체가 아님
- ✅ SHA-256 검증으로 prompt가 변조되지 않았음을 확인
- ✅ 실패 시 오래된 로컬 XML을 유지하여 경험을 파괴하지 않음
커스텀 작업 동기화
커스텀 작업은 로컬에만 존재하며, 클라우드로 자동 동기화되지 않습니다.
다중 디바이스에서 공유해야 하는 경우:
- 작업 목록을 수동 내보내기 (JSON)
- 다른 머신에서 가져오기
9. 단축키
| 단축키 | 기능 |
|---|---|
Ctrl + Shift + M | 시작 메뉴 열기 |
↑ / ↓ | 작업 목록 내에서 상하 이동 |
Enter | 현재 선택된 작업 실행 |
Esc | 시작 메뉴 닫기 |
10. 모범 사례
작업 명명 기법
✅ 좋은 명명:
- "오늘 주문 집계"
- "Amazon 매장 순찰"
- "Excel을 Markdown으로 변환"
❌ 나쁜 명명:
- "작업 1"
- "신규 작업"
- "test"
작업 설명 작성법
✅ 좋은 설명:
오늘 전 매장의 주문 수(주문 ID·금액·고객·상태 포함)을 집계하고,
금액 내림차순으로 정렬하여 reports/orders-{오늘 날짜}.xlsx에 기록.
1000을 초과하는 주문은 비고란에 "대금"으로 주석.❌ 나쁜 설명:
주문 집계언제 작업을 생성하는지
- ✅ 매주 / 매일 반복하는 일
- ✅ 팀 여러 사람이 공유하는 일
- ✅ 복잡하고 매개변수를 잊기 쉬운 일
❌ 원샷 작업은 저장할 필요 없음
작업 버전 관리
작업 설명에 버전 번호를 붙일 것을 권장:
[버전 1.2 - 2026-09-24]
오늘 전 매장의 주문을 집계...향후 유지보수를 쉽게 합니다.
11. 자주 묻는 질문
Q1: 내장 작업이 보이지 않는다 / 어지럽다
해결: **"설정 → 시작 메뉴"**에서 "공식 메뉴 복원" 클릭.
Q2: 커스텀 작업을 동료와 공유할 수 있나?
가능:
- 작업 우측 클릭 → "내보내기" → JSON 저장
- 동료에게 전송
- 동료가 우측 클릭 → "가져오기" → JSON 선택
Q3: 작업 실행 시 오류 발생
- 오류 정보 확인
- 작업 설명이 명확한지 확인
- 실행 환경 설정 확인 (후니아오 환경이 온라인인지)
- 필요 시 작업 재편집
Q4: 시작 메뉴 작업 수에 상한이 있나?
이론적으로 상한 없음, 단 50개 미만 권장, 초과 시 검색 어려움.