QuickAgent 사용 설명서
QuickAgent는 로컬 우선 AI 에이전트 워크스페이스입니다. 목표를 오래 유지되는 Run으로 바꾸고, Workspace Profile로 그 Run의 범위를 제한하며, 민감한 작업 전에는 검토를 요청하고, 검증된 결과를 Artifacts에 보관합니다.
시작하기
- 다음을 엽니다: 설정 > AI를 열고 제공업체를 추가한 다음 연결 테스트를 실행하세요.
- 다음을 엽니다: 설정 > Workspace Profiles를 엽니다. 어떤 제공업체, 도구, 연결, 파일 루트, Knowledge 소스, Memory 범위를 쓸 수 있는지 선택하세요.
- 다음을 선택합니다: 새 채팅을 선택하고 프로필을 고른 뒤, 대화 위에 표시된 제공업체 대상을 확인하세요.
- 원하는 결과를 설명하세요. 이번 Run에 필요한 파일, 폴더, 미디어, Knowledge, Memory만 추가하세요.
- 계획, 승인 요청, Critical 확인, Data Send Preview가 나타나면 검토하세요.
- Timeline에서 진행 상황을 확인하세요. 완료된 결과물은 다음에서 엽니다: Artifacts 그리고 감사 기록은 다음에서 확인하세요: 기록.
인터페이스 개요
| 섹션 | 용도 |
|---|---|
| Chats | 대화, 제공업체 대상, Context Tray, 계획, 승인, 진행 중인 Run Timeline. |
| Runs | 계획됨, 실행 중, 일시 중지, 예약됨, 실패, 완료 상태의 모든 작업. |
| Approval Inbox | 사용자의 결정이 필요한 대기 중 작업, Critical, Data Send 검토. |
| Artifacts | Run이 만들어 낸 검증된 파일, 리포트, 로그, 미디어, 표, 작업 매니페스트. |
| Automations | 일정, 모니터, 웹훅, 앱 이벤트, 단축어/App Intent 트리거. |
| Skills | 타입이 지정된 입력, 허용 도구, 필수 연결, 위험도, 출력을 갖춘 재사용 가능한 지시문. |
| Connections | 제공업체, 브라우저 프로필, 파일/VFS 루트, SSH, MCP, HTTP/SaaS, 홈 브리지, 알림 채널. |
| Knowledge | 색인된 폴더, QuickNote 콘텐츠, 웹 클립, PDF, Office 문서. |
| 기록 | 추가만 가능한 형태로 남는 안전 결정, 도구 동작, 전송 대상, 타임스탬프. |
| 설정 | 화면 모양, 언어, AI, 도구, 안전, Workspace Profiles, 단축키, 권한, 도움말, Pro. |
제공업체와 Workspace Profile
QuickAgent는 운영체제가 호환 기능을 제공할 때 시스템 AI를 사용할 수 있고, Ollama·LM Studio·DeskLLM 같은 로컬 제공업체, LAN 또는 사용자 지정 OpenAI 호환 엔드포인트, Anthropic이나 Gemini 같은 구성된 클라우드 제공업체도 사용할 수 있습니다. 사용 가능 여부는 실시간 기능 테스트로 판단하므로, 제공업체 이름이 보인다고 해서 바로 쓸 수 있는 것은 아닙니다.
Workspace Profile은 Run의 권한 범위입니다. 선택한 제공업체/모델, 허용 도구, 연결, 파일 루트, Knowledge 소스, Memory 범위, 안전 예외, 예산을 스냅샷으로 저장합니다. 이후 설정이 바뀌면 스냅샷이 오래된 상태가 되어 다시 검토해야 합니다.
실행, 승인 및 복구
실행 제어
- 일시 중지 는 지속 가능한 체크포인트에서 협조적 중지를 요청합니다.
- 재개 는 동일한 Run과 완료된 작업을 이어갑니다.
- 중지 는 프로바이더 및 도구 작업을 취소합니다. 중지되었거나 불확실한 외부 효과는 성공으로 보고되지 않습니다.
- 재시도 는 QuickAgent가 안전한 재시도 경계를 식별할 수 있을 때만 사용할 수 있습니다.
안전 수준
| 수준 | 의미 |
|---|---|
| Safe | 활성 프로필 내에서 읽기, 검사 또는 변환합니다. |
| Approve | 일반적인 쓰기 또는 외부 작업을 검토합니다. |
| 다음이 켜져 있는지 확인하세요: | 영향이 크거나 되돌리기 어려운 변경을 검토합니다. |
| Critical | 매번 강력한 확인이 필요하며, 규칙이 자동 승인하지 않습니다. |
승인 화면에는 정확한 대상, 목적지, 제안된 인수, 위험도, 실행 취소 상태가 표시됩니다. 인수를 편집하면 QuickAgent가 편집된 작업을 다시 검증하고 위험도를 확인합니다.
멀티 에이전트 실행
복잡한 목표에는 플래너, 유형화된 전문 워커, 리뷰어, 보안 리뷰어를 활용할 수 있습니다. 타임라인에는 각 인계, 검토, 재시도, 폴백, 최종 응답 경계가 표시됩니다. 워커는 Skill 도구, Workspace Profile 도구, 역할 도구, 현재 사용 가능한 도구의 네 가지 교집합만 받습니다.
전역 및 역할별 예산은 호출 횟수, 시간, 비용, 네트워크 바이트, 토큰을 제한합니다. 예산에 도달하면 QuickAgent는 일시 중지합니다. 현재 한도와 제안된 한도를 표시하며, 명시적인 검토를 거친 후에만 한도를 늘립니다. 승인된 예산과 완료된 역할 기록은 재시작 후에도 유지됩니다.
컨텍스트, 지식 및 AI 메모리
컨텍스트 트레이
파일, 폴더, 이미지, 비디오 프레임, 오디오, 음성 메모, QuickNote 콘텐츠, Knowledge 또는 Workspace Memory를 추가하세요. QuickAgent는 지원되는 콘텐츠를 추출하거나 요약하고, 첨부 파일이 프로바이더로 직접 전송되는지 여부를 표시합니다.
Knowledge
Knowledge 소스는 채팅과 별도로 색인됩니다. Run은 해당 Workspace Profile이 허용한 소스만 검색할 수 있으며, 인용은 출처 정보를 그대로 유지합니다.
메모리
메모리는 자동으로 쌓이는 채팅 기록이 아니라 의도적으로 저장하는 정보입니다. User, Workspace, Project, Tool/Connection 범위는 서로 분리되어 있습니다. 모든 생성, 편집, 삭제 요청은 매번 새로 승인을 받아야 하며, 승인 미리보기에는 범위와 제안된 정확한 값이 표시됩니다.
도구 및 연결
라이브 카탈로그는 파일/VFS 작업, Office·PDF·구조화 데이터, 미디어 및 OCR, 브라우저 및 컴퓨터 제어, 개발 명령, SSH, MCP, HTTP 및 SaaS, 스마트홈 브리지, 알림, 일정, 모니터, 자동화 제어를 포함합니다. 연결된 MCP 서버는 스키마 검증과 QuickAgent 위험도 재평가를 거친 후 동적 도구를 추가할 수 있습니다.
Settings > Tools 에서 도구가 준비되었거나 비활성화된 이유를 확인할 수 있습니다. 일반적인 이유로는 연결 누락, 운영체제 권한, 미지원 플랫폼, Workspace Profile 제한, 테스트되지 않은 엔드포인트, 사용할 수 없는 프로바이더 기능이 있습니다.
Automations
자동화는 플랫폼이 지원하는 경우 시간, 파일/폴더, 웹, 웹훅, 이메일, 캘린더, 네트워크, 호스트, 기기, 센서, 위치, 앱 이벤트, Shortcut/App Intent, 명령 또는 수동 트리거로 시작할 수 있습니다. 트리거는 일반적인 Run을 생성할 뿐이며, Workspace Profile, 승인, Critical, 데이터 전송 검사를 우회하지 않습니다.
- 데스크톱 모니터링은 앱 프로세스가 실행 중일 때만 계속됩니다.
- 모바일 플랫폼은 앱이 포그라운드로 돌아올 때 지연된 작업을 복구합니다.
- 운영체제 수준의 전달이 필요한 경우 Shortcut/App Intent 또는 신뢰할 수 있는 이벤트 릴레이를 사용하세요.
- 대기 중인 이벤트, 일시 중지, 취소, 삭제는 항상 명시적으로 처리되므로 이벤트가 조용히 사라지지 않습니다.
Skill 및 Skill Pack
Skill은 결과 중심 프롬프트, 유형화된 변수, 프로바이더 추천, 허용 도구, 필요한 연결과 기능, 최대 위험도, 예상 Artifact를 저장합니다. 사용 전에 QuickAgent가 입력값과 실제 적용되는 권한을 보여주며, 이 미리보기 자체가 권한을 부여하지는 않습니다.
7개의 기본 제공 Pack은 Office, Coding, Smart Home, Research, Browser Automation, Personal Admin, Incident Response를 위한 실제 Skill을 제공합니다. Skill은 설치, 업데이트, 삭제, 커스터마이즈, 복제, 가져오기, 내보내기가 가능합니다. 가져온 JSON에는 신뢰도, 게시자, 서명, 권한, 위험도, 플랫폼, 충돌 미리보기가 표시됩니다. “둘 다 유지”를 선택하면 다른 게시자의 신뢰도를 물려받지 않고 서명되지 않은 로컬 파생본이 생성됩니다.
Artifact, 기록 및 실행 취소
Artifact는 출력 바이트, 메타데이터, 버전, 출처, 원본 Run, 작업 매니페스트를 보관합니다. 플랫폼 기능에 따라 열기, 공유, 내보내기, 파일 위치 표시가 가능합니다. 조건을 충족하는 작업은 검토를 거친 실행 취소를 제공하며, 파괴적이거나 불확실한 작업은 절대 자동으로 재실행되지 않습니다.
기록은 추가 전용입니다. Safe, Approve, Confirm, Critical로 필터링하고, 외부 기록이 필요할 때 감사 로그를 내보낼 수 있습니다.
설정
- 일반: 외관, 언어, Workspace Profile, 단축키, 도움말, 권한.
- AI: 프로바이더, 엔드포인트, 모델, 자격 증명, 실시간 테스트.
- 도구: 카탈로그 준비 상태, 플랫폼 지원, 설정 사유.
- 안전: 승인 규칙, 데이터 전송 동작, 기기 인증, 범위별 메모리 정책.
- 고급: 문제 해결을 위한 복구 및 진단 기능.
키보드 단축키
macOS에서는 표시된 Ctrl 단축키를 적절한 경우 플랫폼의 Command 키로 매핑합니다. 앱 내 단축키 페이지가 기준이 되며 사용자 지정도 지원합니다.
| 단축키 | 동작 |
|---|---|
| Ctrl + N | 새 채팅 |
| Ctrl + L | 작성창에 포커스 |
| Ctrl + Shift + Space | 활성 Run 일시 중지 또는 재개 |
| Ctrl + . | 활성 Run 중지 |
| Ctrl + 1 … 9 | 기록에서 채팅 열기 |
| Ctrl + , | 설정 열기 |
| F1 | 도움말 & 개인정보 열기 |
| Esc | 대화상자 닫기 또는 현재의 비파괴적 작업 취소 |
플랫폼 참고 사항
| 플랫폼 | 중요한 제약 |
|---|---|
| macOS | Debug와 Release 모두 샌드박스로 동작합니다. 파일 접근은 선택된 루트/보안 범위 북마크를 사용합니다. 화면 기록과 손쉬운 사용은 별도의 시스템 권한입니다. 로컬 프로세스 및 Shortcut 연동은 기능 테스트를 거쳐 사용됩니다. |
| Windows | 파일, Office/PDF/데이터, 브라우저, 개발, 원격, 데스크톱 제어 기능은 설치된 런타임과 권한에 따라 달라집니다. Apple 전용 연동은 사용할 수 없으며 그 이유가 표시됩니다. |
| iPhone / iPad | 파일은 시스템 선택기를 사용합니다. 카메라, 마이크, 음성 인식, 사진, 로컬 네트워크, 알림 권한은 필요한 시점에 요청됩니다. 백그라운드 모니터링은 보장되지 않으므로 Shortcuts/App Intents 또는 포그라운드 복구를 사용하세요. |
| Android | 파일과 폴더는 Storage Access Framework를 사용합니다. 백그라운드 작업은 Android의 제약을 따릅니다. 손쉬운 사용 기반 입력 제어는 서비스가 선언되어 있다는 이유만으로 허용된 것으로 간주되지 않습니다. |
| Web | 네이티브 저장이 필요한 기능에는 세션 전용 저장소를 사용하며, 지원되지 않는 기기·파일 루트·로컬 프로세스·백그라운드 기능은 명확히 비활성화합니다. |
팁 & 활용법
문제 해결
| 증상 | 확인할 것 |
|---|---|
| 프로바이더를 실행할 수 없음 | Settings > AI를 여세요. 설정, 인증, 모델 기능, 엔드포인트 연결 가능 여부, 타임아웃, 속도 제한 정보를 확인한 후 연결 테스트를 실행하세요. |
| 도구가 비활성화됨 | Settings > Tools를 열고 실시간 사유를 확인하세요. 현재 플랫폼, 권한, 연결 테스트, Workspace Profile, 선택된 루트를 점검하세요. |
| Run이 멈춘 것 같음 | Runs와 타임라인을 여세요. 일시 중지, 입력 대기, 승인 대기, Critical 확인 대기, 데이터 전송 검토, 예산 검토 상태일 수 있습니다. 중지는 언제든 가능합니다. |
| 권한이 변경됨 | Help > Overview 또는 설정을 연 다음 시스템 설정을 여세요. 돌아온 후 해당 연결이나 도구를 다시 테스트하세요. |
| 외부 작업 결과가 불확실함 | 대상 시스템을 확인하세요. 재시도해도 괜찮다는 것을 확인하기 전까지는 Run을 일시 중지 상태로 두거나 중지하세요. |
| 자동화가 백그라운드에서 실행되지 않음 | 모바일 운영체제는 임의의 폴링을 보장하지 않습니다. 포그라운드로 돌아와 밀린 작업을 처리하거나 Shortcut/App Intent 또는 신뢰할 수 있는 이벤트 소스를 설정하세요. |
| Artifact를 열거나 내보낼 수 없음 | 해당 바이트가 아직 남아 있는지, 플랫폼이 그 작업을 지원하는지, 선택한 대상 권한이 여전히 유효한지 확인하세요. |
개인정보, 권한 및 라이선스
QuickAgent는 대화, Run, 승인, Knowledge 메타데이터, Skill, 설정을 로컬에 저장합니다. 자격 증명은 플랫폼이 보호하는 저장소를 사용합니다. 콘텐츠는 사용자가 설정한 프로바이더나 연결된 서비스를 통해서만 기기를 벗어나며, 외부 전송 시에는 목적지를 명시한 미리보기가 제공됩니다.
권한은 필요한 시점에 요청됩니다. 파일/폴더, 사진, 카메라, 마이크, 음성 인식, 로컬 네트워크, 알림, 화면 기록, 손쉬운 사용/입력 제어는 각각 독립적입니다. 권한을 해제하면 해당 기능이 거짓 성공을 반환하는 대신 사용할 수 없게 됩니다.
다음을 엽니다: Settings > Help & Privacy 에서 현재 플랫폼 기능 표를 확인하고, 오픈소스 라이선스 에서 패키지 및 번들 네이티브 고지를 확인하세요.