설정 개요
채팅 탭 페이지 우측 상단의 "설정" ⚙️ 버튼을 클릭하여 MBAgent 설정 패널을 엽니다. 본 장에서는 각 설정 항목의 용도를 체계적으로 소개합니다.
1. 기본 모델
새 세션 생성 시 기본으로 사용할 모델을 설정합니다.
기본 모델 선택
- "기본 모델" 탭 진입
- 드롭다운에서 선택:
- Provider (후니아오 공식 / OpenAI / ...)
- 구체 모델 (gpt-5-mini / claude-sonnet-4 / ...)
- 저장
TIP
권장: 기본은 저가 모델(deepseek-v4-flash / deepseek-v4-pro)을 사용하고, 복잡한 작업에서 일시적으로 상위 모델로 전환.
2. Provider 설정
MBAgent가 사용할 수 있는 모든 AI 프로바이더를 관리합니다.
활성화된 Provider 목록
현재 사용 가능한 모든 Provider를 표시:
- ✅ API Key 설정 완료
- ⚠️ 추가되었으나 Key 미설정
- ❌ 비활성화
커스텀 Provider 추가
자세한 내용은 모델 선택 및 Provider 설정의 5절을 참조하세요.
자격증명 관리 (API Key)
- 후니아오 공식 API Key: 후니아오 클라이언트에서 자동 읽기
- 커스텀 Provider Key: 수동 입력, Windows Credential Manager에 저장
- 타사 중계국 Key: 동일
- **"표시"**를 클릭하여 저장된 Key 표시 (마스크만 표시)
IMPORTANT
API Key 보안:
- MBAgent는 사용자의 Key를 어떠한 서버에도 업로드하지 않습니다
- Key는 로컬 Windows 자격증명 관리자에만 저장됩니다
- MBAgent 제거 시 자격증명은 함께 정리됩니다
3. 인터페이스 및 네비게이션
탭 바
- 터미널 탭 표시: 상단에 "터미널" 탭을 표시할지 여부
- 인터페이스 탭 표시: 상단에 "UI" 탭을 표시할지 여부
- Shell 탭 표시: 상단에 "Shell" 탭을 표시할지 여부
- 탭 바 너비: 조정 가능
좌측 사이드바
- 세션 표시 수: 기본으로 표시할 최신 세션 수. 초과 시 "전체 세션 목록" 버튼 표시
- AI 로컬 메모리 뱅크 표시: 좌측 사이드바에 메모리 뱅크 진입점 표시 여부
- 로컬 지식베이스 표시: KMS 진입점 표시 여부
- MCP 서비스 표시: MCP 상태 표시 여부
- 공식 계정 크레딧 표시: 후니아오 공식 계정 크레딧 표시 여부
테마
- 라이트 / 다크 / 시스템 연동
언어
- 简体中文 (기본)
- English
- Deutsch (후니아오 인증 드롭다운 전용 검수 언어)
4. 대화 및 출력
표시 설정
- 사고 과정 표시: AI 응답에 접을 수 있는 thinking 내용을 표시
- Token 및 비용 통계 표시: 각 라운드 응답 후 Token·소요 시간·비용 표시
자동 저장
- 세션 자동 저장: 전송할 때마다 자동으로 디스크에 저장
- 첨부 파일 저장: 첨부 파일을 자동으로 로컬 저장
기본 첨부 파일 처리
- 이미지 첨부: 자동으로 base64를 통해 모델에 전송 / 로컬 저장
- 파일 첨부: 자동으로 텍스트 컨텍스트로 파싱 / 모델에 Read 도구로 읽기
5. AI 작업 설정
작업 예산은 각 최상위 AI 작업의 리소스 상한을 제어합니다.
2가지 작업 예산
| 작업 유형 | 적용 시나리오 |
|---|---|
| 표준 작업 예산 | 일반 대화, 브라우저 조작, 도구 작업 |
| 콘텐츠 집약형 작업 예산 | 문서, 프로젝트, 공식 지식 증거 작업 (더 높은 한도) |
표준 예산 기본 항목
| 상한 항목 | 기본값 | 용도 |
|---|---|---|
| 누적 입력 Token 상한 | 1,000,000 | 총 입력량 제어 |
| 모델 반복 상한 | 50 | AI 사고 라운드 수 제어 |
| 도구 호출 상한 | 200 | 도구 호출 횟수 제어 |
| 새 라운드 시작 정지 시간 상한 (분) | 30 | 총 소요 시간 |
| 연속 무진전 상한 | 5 | 공회전 방지 |
NOTE
변경은 새로 시작하는 작업에만 유효. 실행 중인 작업은 시작 시점 스냅샷 설정을 사용합니다.
6. 공식 서비스 탐지
후니아오 공식이 제공하는 2가지 핵심 서비스의 가용성을 검증:
1. 후니아오 RAG 지식베이스
- 후니아오 공식 RAG 검색 링크로 읽기 전용 인증 쿼리 발행
- 탐지: 네트워크 연결, 계정 인증, 응답 포맷, 사용 가능 지식 결과
- 상태 표시: 정상 / 이상 / 미활성 / 탐지 중
2. 후니아오 클라이언트 ControlV2
- 선택된 후니아오 클라이언트와 실시간 ControlV2 준비 왕복 탐지
- 검증: 인스턴스 발견, 핸드셰이크, 계정 로그인, 설정 읽기, 실행 가능 능력
- 상태 표시: 정상 / 이상 / 미활성 / 탐지 중
탐지 트리거 방식
- 수동: 설정 페이지의 "탐지 시작" / "재탐지" 클릭
- 자동: MBAgent 시작 시 자동으로 1회 탐지
TIP
문제 발생 시 우선 탐지:
- "AI가 후니아오 브라우저를 조작할 수 없다" → ControlV2가 정상인지 확인
- "AI가 공식 자료를 찾을 수 없다고 한다" → RAG가 정상인지 확인
- 상태가 이상인 경우, 오류 메시지에 따라 후니아오 고객 지원에 문의
7. 실행 로그 모니터링
MBAgent 로그 스위치
- mbAgent 로그 활성화: MBAgent 진단 로그와 Token 로그를
Data\Logs디렉터리에 기록 - 기본 끄기: 디스크 점유를 피하기 위해
로그 확인
로그 파일 위치:
%LOCALAPPDATA%\mbagent\logs\내용:
- 진단 로그 (시작·오류·성능)
- Token 로그 (각 호출의 입출력 Token 수)
8. 권한 관리
MBAgent 조작은 여러 권한 층을 포함하며, 자세한 내용은 권한 관리 및 안전한 사용을 참조하세요.
권한 모드
- Ask: 각 고위험 조작마다 확인 팝업
- Auto: 일반적인 조작은 자동 실행, 극히 일부만 팝업
- Plan: 플랜 모드에 진입하여 각 단계마다 승인 필요
도구 호출 승인
- 파일 쓰기: 쓰기 전에 확인
- 명령 실행: shell 명령 실행 전에 확인
- MCP 도구: 각 MCP 도구를 개별 설정 가능
9. 키보드 단축키 설정
일부 단축키는 설정 내에서 조정 가능:
- 메시지 전송 단축키 (Enter / Ctrl+Enter)
- 응답 취소 단축키 (Esc)
- 새 세션 단축키
10. MBAgent 정보
버전 정보 확인
- MBAgent 버전: 예
1.112.10.18 - Cargo 패키지 버전: 예
1.112.10 - 빌드 일자
- 업데이트 채널 (stable / beta / dev)
업데이트 확인
"업데이트 확인" 버튼을 클릭하면 MBAgent가 자동으로 새 버전이 있는지 탐지합니다. 새 버전이 있으면 후니아오 브라우저 콘솔에서 다운로드하도록 안내합니다.
설정 리셋
설정이 어지러워진 경우:
- 중요 설정 백업
- "권장 기본값으로 되돌리기" 버튼 클릭
- MBAgent 재시작
11. 설정 권장
초보자 권장 설정
- 기본 모델:
deepseek-v4-flash또는deepseek-v4-pro - 사고 과정 표시: ✅ 활성화 (AI가 어떻게 사고하는지 학습)
- Token 및 비용 통계 표시: ✅ 활성화 (매번 비용 파악)
- AI 로컬 메모리 뱅크 표시: ✅ 활성화
- 로컬 지식베이스 표시: ✅ 활성화
- MCP 서비스 표시: ✅ 활성화
- 공식 계정 크레딧 표시: ✅ 활성화
- 언어: 简体中文
- 테마: 시스템 연동
- 작업 예산: 기본값 사용
고급 사용자 설정
- 기본 모델:
gpt-5.6-sol또는gpt-6.0-sol - 사고 과정 표시: 끄기 (Token 절약)
- 세션 표시 수: 30으로 조정
- API Key: 자체 게이트웨이 사용