Gobi Desktop 가이드

개요

Gobi Desktop은 AI4PKM Orchestrator의 GUI 클라이언트입니다. 환경설정 및 관리를 손쉽게 하고, 음성비서 등 부가 기능을 직관적인 인터페이스로 제공합니다.

💡 처음 설치하시나요? 온보딩 시나리오를 따라하면서 이 가이드를 함께 참고하세요.

주요 특징:

• Multi-Vault 지원: 여러 Vault를 등록하고 좌측 사이드바에서 전환하며 관리
• 통합 관리: Task, Worker, Prompt, 설정을 한 곳에서 관리
• 실시간 모니터링: Orchestrator 실행 상태를 실시간으로 확인

주요 기능

화면별 상세

Orchestrator (음성비서)

음성으로 Orchestrator와 대화할 수 있는 인터페이스.

• 중앙 버튼으로 음성 입력 시작/중지
• 실시간 음성 인식 및 응답
• Vault 내 지식에 대한 질의응답
• Agent를 이용한 작업 실행 요청

Tasks

Task 목록을 확인하고 관리하는 화면. 실행 중 실패한 Task를 확인하고 바로 재실행할 수 있습니다.

활용 팁:

• Failed 상태의 Task를 확인하고 원인 파악
• 상황 판단 후 Retry 버튼으로 즉시 재실행
• Output File 링크로 결과물 바로 확인

Workers

현재 등록된 Agent와 Prompt를 시각적으로 관리하는 화면.

Workers 섹션:

• Target: 연결된 Prompt
• Trigger: 실행 조건 (파일 이벤트, 스케줄)
• Output Location: 출력 디렉토리
• Actions: Edit, Delete, Duplicate, On/Off 토글

Prompts 섹션:

• 등록된 Prompt 목록 및 최종 수정일
• New Prompt 버튼으로 새 Prompt 생성
• Prompt 클릭하여 내용 편집

Contents

Vault의 파일 구조를 탐색하고 편집하는 화면.

• 좌측: 파일 트리 탐색기
• 우측: 선택한 파일 내용 편집
• 상단: 새 파일/폴더 생성 버튼

Logs

Orchestrator 실행 상태를 실시간으로 모니터링하는 화면.

• Task 생성, Agent 실행, 완료/실패 상태 등 실시간 로그
• 각 Agent의 실행 진행 상황 추적
• Clear 버튼으로 로그 초기화

로그 활용:

• 문제 발생 시 원인 파악
• Agent 실행 시간 및 패턴 분석
• 실시간 Orchestrator 상태 확인

Settings

Orchestrator 환경설정을 GUI로 관리하는 화면. orchestrator.yaml을 직접 편집하지 않고도 설정 변경 가능.

Orchestrator 설정:

• Prompts Dir, Tasks Dir, Logs Dir 등 디렉토리 경로
• Max Concurrent: 전역 동시 실행 수
• Poll Interval: 이벤트 폴링 간격

Defaults 설정:

• Executor: 기본 실행 엔진
• Timeout Minutes: 기본 타임아웃
• Max Parallel: Agent별 동시 실행 수
• Task Create: Task 파일 생성 여부

참조

• (0) Orchestrator 개요 - 아키텍처 개요
• (4) Orchestrator 설정 - 설정 파일 상세
• 용어 사전 - 용어 정의

학습 경로

관련 문서:

• (0) 실전 가이드 개요 - 도구 선택 가이드
• (3) Agent Skill 가이드 - 스킬 가이드