2.16. 설정¶

설정 페이지는 Backend.AI GO의 모든 측면을 구성하는 중앙 허브입니다. 사이드바의 설정(톱니바퀴) 아이콘을 클릭하여 접근합니다.

개요¶

설정은 왼쪽 사이드바에 세 그룹으로 구성되어 있습니다.

앱

에이전트

시스템

상단의 설정 검색 바를 사용하여 키워드로 원하는 설정을 빠르게 찾을 수 있습니다.

조직이 관리하는 설정¶

Backend.AI GO를 기업 환경에 배포하면, 관리자가 머신 정책이나 중앙 정책으로 특정 설정을 잠글 수 있습니다. 잠긴 설정에는 "조직에서 관리함" 배지가 표시되고 사용자가 변경할 수 없습니다. 잠금은 정책이 지정한 항목에만 적용되며, 나머지 설정은 평소와 동일하게 동작합니다. 프로비저닝되지 않은 일반 설치에서는 잠긴 설정이 없고 배지도 표시되지 않습니다.

외관¶

테마¶

Backend.AI GO는 취향에 맞는 다양한 시각적 테마를 제공합니다:

• Glass: 반투명 유리 효과가 적용된 모던한 디자인입니다.

• Stained: 그라디언트 포인트가 적용된 생동감 있는 컬러풀 테마입니다.

색상 구성표¶

다음 중에서 선택할 수 있습니다:

• 밝게 (Light): 밝은 배경에 어두운 텍스트입니다.
• 어둡게 (Dark): 어두운 배경에 밝은 텍스트로, 저조도 환경에서 눈의 피로를 줄여줍니다.
• 시스템: 운영 체제의 외관 설정을 자동으로 따릅니다.

사이드바¶

• 기본적으로 사이드바 접기: 활성화하면 사이드바가 접힌 상태로 시작되어 콘텐츠 영역을 최대화합니다. 마우스를 올리거나 확장 버튼을 클릭하면 펼쳐집니다.

시스템 트레이¶

• 시스템 트레이 아이콘 표시: 시스템 트레이(macOS에서는 메뉴 바)에 아이콘을 표시하여 메인 창을 열지 않고도 Backend.AI GO에 빠르게 접근할 수 있습니다.

접근성¶

• 모션 줄이기: 테마 전환 효과 및 애니메이션을 비활성화합니다. 시스템 설정을 오버라이드하며, 모션에 민감한 사용자에게 유용합니다.

UI 스케일¶

인터페이스 확대/축소 수준을 조정하여 모든 요소를 크게 또는 작게 만들 수 있습니다. 슬라이더로 디스플레이와 취향에 맞게 미세 조정할 수 있으며, 100%로 초기화를 클릭하면 기본 크기로 돌아갑니다.

일반¶

언어¶

인터페이스 언어를 선택합니다. Backend.AI GO는 다음을 지원합니다:

• English
• 한국어

타임스탬프¶

애플리케이션 전체에서 메시지 타임스탬프가 표시되는 방식을 설정합니다. 자세한 내용은 채팅 인터페이스 > 타임스탬프 표시를 참조하세요.

모델¶

모델 로딩 파라미터 및 생성 기본값 등 모델별 설정에 대해서는 모델 설정 및 파라미터를 참조하세요.

생성¶

생성 섹션에는 추론 파라미터와 대화 동작 설정이 포함되어 있습니다.

• 입장 시 마지막 채팅 세션 복원: 활성화(기본값)되어 있으면, 활성 세션 없이 채팅 화면에 진입할 때 가장 최근에 업데이트된 대화를 자동으로 다시 엽니다. 항상 빈 채팅으로 시작하고 싶다면 이 옵션을 비활성화하세요.

자세한 내용은 대화 관리 > 세션 복원을 참조하세요.

도구 및 확장¶

도구 권한 및 MCP(Model Context Protocol) 서버 설정에 대해서는 MCP 연동하기를 참조하세요.

메모리¶

메모리 섹션은 지속적 메모리 시스템을 설정합니다. 메모리 뱅크, 메모리 뷰어, 자동 추출, 메모리 주입에 대한 전체 가이드는 메모리를 참조하세요.

음성 입력¶

음성 입력 섹션은 채팅 작성창의 푸시-투-토크(push-to-talk) 받아쓰기 기능을 제어합니다.

• 음성 입력 활성화: 채팅 작성창의 마이크 버튼을 켜거나 끕니다.

• 전사 언어: 말하는 언어를 선택하거나, 자동 감지를 유지하면 whisper.cpp가 언어를 자동으로 식별합니다.

• 전사 모델: whisper.cpp 모델 파일 경로를 입력합니다(예: ggml-base.bin). whisper.cpp 모델 저장소에서 모델을 다운로드한 후 경로를 입력하거나, 엔진 페이지에서 엔진 레지스트리를 통해 설치하세요.

• 삽입 모드: 삽입은 변환된 텍스트를 작성창에 삽입해 수정 후 전송할 수 있게 합니다. 자동 전송은 변환 완료 직후 메시지를 바로 전송합니다.

고급¶

고급 섹션에는 네트워크 설정, 로깅, 개발자 옵션이 있습니다.

포트 범위¶

Backend.AI GO는 여러 개의 로컬 TCP 포트 풀을 바인딩합니다. 평소에는 변경할 필요가 없지만, 다른 애플리케이션이 기본 포트를 선점하는 경우 — 가장 흔하게는 Windows의 WSL2/Hyper-V — 여기서 풀을 비어 있는 범위로 옮길 수 있습니다.

• 추론 서버 포트: 로컬 추론 서버(llama-server)용 포트 풀입니다. 기본값 39000–39019.
• 시스템 모니터 포트: 시스템 모니터 서비스(all-smi)용 포트 풀입니다. 기본값 39500–39509.

API 서버 / 라우터 포트는 설정 → API → 포트에서 별도로 설정합니다(기본값 39080).

"No available ports" 오류가 발생하면 — 특히 WSL2를 사용하는 Windows에서 — 진단 명령과 권장 우회 방법은 문제 해결 → Windows/WSL2 포트 충돌을 참고하세요.

커넥터¶

커넥터 섹션(실험적 기능)에서는 에이전트와 자동화가 작업할 수 있는 외부 계정을 설정합니다:

• 이메일 커넥터 (IMAP + SMTP): IMAP 읽기 권한과 함께, 필요하면 SMTP 전송(보내기, 답장, 임시 보관, 삭제)까지 쓸 수 있는 이메일 계정입니다. 비밀번호는 운영체제의 보안 키체인에 저장되고 평문으로 디스크에 기록되지 않습니다. 저장 전에 연결 테스트 버튼으로 계정을 확인할 수 있습니다.
• Google Calendar 커넥터: Google Calendar용 OAuth 클라이언트입니다. 동의 흐름을 시작하고 브라우저에서 접근을 허용한 뒤, 인증 코드를 양식에 붙여넣으면 됩니다. 자격 증명은 OS 키체인에 저장됩니다.

감사 로그¶

커넥터가 수행한 모든 작업은 감사 로그 페이지(사이드바 > 감사 로그)에 기록됩니다. 각 항목에는 커넥터, 작업, 발생 시각, 결과(성공, 실패, 취소됨), 그리고 되돌리기 판정(되돌리기 대상 아님, 되돌리기 가능, 되돌리기 (최선 수준), 되돌리기 불가)이 표시됩니다.

되돌리기가 가능한 항목에는 보낸 작업 철회, 생성된 항목 삭제, 스냅샷에서 복구 같은 되돌리기 동작이 함께 제공됩니다. 실행 전에 확인 대화상자가 되돌리기로 무엇이 일어나는지 설명해 주고, 메시지 회수처럼 시간 제한이 지나면 닫히는 되돌리기 창도 있습니다. 민감한 필드는 로그에서 마스킹됩니다.

유지보수¶

업데이트¶

• 자동으로 업데이트 확인: 애플리케이션 시작 시 새 버전을 확인합니다. 오프라인 환경에서는 비활성화하세요.

• 업데이트 채널: 업데이트를 받을 릴리스 채널을 선택합니다.

  • 안정 버전 (Stable): 프로덕션 준비가 끝난 릴리스입니다 (권장).
  • 베타 버전 (Beta): 새 기능을 테스트 중인 사전 릴리스 버전입니다.
  • 기미상궁 버전 (Canary): 가장 앞선 빌드로, 이른 테스트용입니다.

  안정 버전이 아닌 채널에는 버그나 미완성 기능이 있을 수 있습니다. 베타 버전 채널에서는 최신 베타보다 새로운 안정 릴리스가 발행되면 업데이터가 그 안정 릴리스를 제안합니다.

• 추론 엔진 자동 업데이트: 번들된 추론 엔진을 자동으로 최신 상태로 유지합니다.

• 익명 사용 통계: 익명 사용 통계를 공유해 애플리케이션 개선에 참여합니다.

백업 및 복원¶

설정을 파일로 내보내거나 이전 백업을 가져올 수 있습니다. 가져오기 대화상자는 파일에 들어 있는 카테고리(일반, 추론, 도구, 대화, 고급 등)를 나열하고 적용할 항목을 고르게 해 주는데, 가져오면 선택한 카테고리의 현재 설정을 덮어씁니다. 백업에는 API 키 등 민감한 데이터가 포함되지 않습니다.

초기화¶

기본값으로 초기화는 확인 메시지를 거쳐 모든 설정을 기본값으로 되돌립니다.