준비Prerequisite
Luna는 LLM이 연결되어 있을 때 활성화됩니다Luna activates when an LLM is connected
메인 창에서 Luna 탭을 누르면 대화 화면이 열립니다. 상단 배지에 현재 연결된 제공자와 모델이 표시되고, 배지를 눌러 모델을 바로 바꿀 수도 있습니다. LLM을 아직 연결하지 않았다면 설정 → LLM 탭에서 제공자를 연결하세요. Click the Luna tab in the main window to open the chat. The badge at the top shows the connected provider and model — click it to switch models. If no LLM is connected yet, set one up in Settings → LLM.
기본기Basics
묻고, 멈추고, 다시 묻기Ask, stop, and retry
- 전송: Enter — 줄바꿈은 Shift+Enter.Send: Enter — new line with Shift+Enter.
- 응답 중지: 답변이 길어지면 중지 버튼으로 즉시 끊을 수 있습니다.Stop: cut a long response short with the stop button.
- 재시도 / 복사: 답변 아래 버튼으로 같은 질문을 다시 보내거나 답변 전체를 복사합니다.Retry / copy: buttons under each answer re-ask the question or copy the whole response.
- 표와 코드: 답변은 Markdown으로 렌더링되어 표, 목록, 코드 블록이 깔끔하게 표시됩니다.Tables and code: responses render as Markdown — tables, lists, and code blocks display cleanly.
에이전트 동작Agentic behavior
Luna가 실행하는 도구 이해하기Understanding Luna's tool runs
Luna는 답변하기 전에 필요한 만큼 도구를 실행하고, 그 과정을 대화 안에 그대로 보여줍니다. 각 줄에는 도구 이름과 실행 결과 요약(예: “관련 문서 3건을 찾았습니다”)이 표시되므로 답변이 어떤 근거로 만들어졌는지 확인할 수 있습니다. Before answering, Luna runs whatever tools it needs and shows each run inline — the tool name plus a result summary (e.g. “found 3 related documents”), so you can see what the answer is based on.
| 도구Tool | 하는 일What it does |
|---|---|
| 파일 검색Search files | 파일명·내용으로 감시 폴더의 문서를 찾습니다.Finds documents in watched folders by name and content. |
| 문서 읽기Read document | 특정 문서의 페이지·구간을 읽어 답변의 근거로 사용합니다.Reads pages or sections of a document as evidence for the answer. |
| 문서 비교Compare documents | 두 문서의 추출 텍스트를 비교해 차이를 정리합니다. 결과는 접을 수 있는 비교 카드로 표시됩니다.Compares the extracted text of two documents; results appear as a collapsible diff card. |
| 폴더 구조 보기Folder tree | 감시 폴더 내부의 폴더·파일 구조를 읽습니다.Reads the folder/file structure inside watched folders. |
| MCP 외부 도구External MCP tools | 연결 센터에서 켠 외부 도구(웹 검색 등). 실행 전 승인 여부를 물을 수 있습니다.External tools enabled in Connection Center (web search, …); may ask for your approval first. |
Luna는 실제로 읽은 범위 안에서만 답합니다. 문서에 없는 내용은 없다고 말하도록 설계되어 있으므로, 근거가 되는 도구 실행 줄을 함께 확인하는 습관을 들이면 좋습니다. Luna answers only from what it actually read. It is designed to say so when something is not in the documents — checking the tool rows alongside the answer is a good habit.
첨부Attachments
특정 문서를 콕 집어 질문하기Focus the question on specific files
질문이 특정 문서에 관한 것이라면 파일을 첨부하세요. Luna가 그 파일을 우선 분석합니다. If your question is about specific documents, attach them — Luna analyzes attached files first.
- + 버튼: 입력창 왼쪽 + 버튼으로 파일 선택 창을 엽니다(여러 개 선택 가능, 최대 10개).+ button: opens a file picker (multi-select, up to 10 files).
- 드래그 앤 드롭: 탐색기에서 파일을 대화 화면으로 끌어다 놓아도 첨부됩니다.Drag & drop: drop files from Explorer straight into the chat.
- 지원 형식: 검색과 동일 — PDF, HWP/HWPX, Word, Excel, PowerPoint, TXT, MD.Supported formats: same as search — PDF, HWP/HWPX, Word, Excel, PowerPoint, TXT, MD.
- 감시 폴더 밖 파일: 첨부하면 그 대화에서는 분석할 수 있지만, 인덱스에는 추가되지 않습니다.Files outside watched folders: can be analyzed in that conversation, but are not added to the index.
기록History
대화 기록 관리Managing chat sessions
- 새 채팅: 왼쪽 레일의 + 버튼. 주제가 바뀌면 새 채팅으로 시작하는 편이 답변 품질에 좋습니다.New chat: the + button in the left rail. Starting fresh per topic keeps answers sharp.
- 기록 열기: 패널 버튼으로 사이드바를 펼치면 이전 대화 목록이 나옵니다. 제목은 첫 질문으로 자동 생성됩니다.Open history: expand the sidebar with the panel button; titles are generated from the first question.
- 삭제: 목록에서 휴지통 아이콘으로 개별 삭제, 전체 삭제는 설정 → 엔진의 “대화 이력 삭제”.Delete: trash icon per session; delete everything via “Clear chat history” in Settings → Engine.
- 보관 위치: 대화는 최대 100개까지 내 PC에만 저장됩니다.Storage: up to 100 sessions, stored only on your PC.
활용In practice
이렇게 요청해 보세요Prompts that work well
| 요청 예시Example request | Luna가 하는 일What Luna does |
|---|---|
| “2026 사업계획서 찾아서 핵심만 요약해줘”“Find the 2026 business plan and summarize the key points” | 파일 검색 → 문서 읽기 → 불릿·표 요약Search → read → bullet/table summary |
| “이 계약서에서 해지 조건 찾아줘” (파일 첨부)“Find the termination clause in this contract” (attached) | 첨부 문서에서 해당 조항과 페이지를 찾아 인용Locates and quotes the clause with its page |
| “작년 계획서와 올해 계획서 차이 비교해줘”“Compare last year's plan with this year's” | 두 문서를 읽고 비교 카드 + 변경점 목록 생성Reads both and produces a diff card with a change list |
| “이 폴더 안 프로젝트 구조 알려줘”“Show me the structure of this project folder” | 폴더 트리를 읽어 구조를 정리(감시 폴더 내부만)Reads the folder tree (inside watched folders only) |
| “회의록에서 결정된 항목만 뽑아서 표로 만들어줘”“Extract only the decisions from the minutes as a table” | 문서 검색·읽기 후 결정 사항만 추출해 표로 정리Finds and reads the minutes, then tabulates the decisions |
MCP
외부 도구(MCP) 승인 다루기Approving external (MCP) tools
연결 센터에서 외부 MCP 서버를 켜면 Luna가 웹 검색 같은 외부 도구도 쓸 수 있게 됩니다. 확인이 필요한 도구를 호출하면 대화 중에 승인 카드가 나타나며, 이번만 허용 / 항상 허용 / 거부 중에서 선택하면 됩니다. 예상하지 못한 도구 호출은 거부하는 것이 안전합니다. Enable external MCP servers in the Connection Center and Luna can also use tools like web search. When a tool requires confirmation, an approval card appears in the chat — choose allow once, always allow, or deny. Deny anything you did not expect.