Oleafly에서 어시스턴트와 함께 작업하기
모델이나 CLI 에이전트를 연결하고, 승인 규칙을 정하고, 검증할 수 있는 작업을 맡깁니다.
Oleafly에서 어시스턴트와 함께 작업하기
쓸모 있는 요청은 어시스턴트가 확인할 수 있는 결과를 줍니다. “이 프로젝트에서 정의되지 않은 인용을 고치고, 컴파일한 다음, 아직 빠진 키가 무엇인지 알려 줘.”라고 요청해 보세요. Oleafly는 어시스턴트에게 프로젝트 파일, 참고문헌 도구, 컴파일러 로그, PDF 검사 기능에 대한 접근 권한을 주므로, 코드 조각을 제안하는 데서 그치지 않고 작업을 이어 갈 수 있습니다.
사용하는 어시스턴트 연결하기
설정 → AI 어시스턴트를 엽니다. 제공자와 키에서 호스팅 제공자, OpenAI 호환 사용자 지정 엔드포인트, 또는 Ollama를 설정하세요. 로컬 모델을 쓰려면 Ollama를 실행하고 원하는 모델을 내려받은 다음 로컬 서버를 연결합니다. 모델과 프로젝트 의존성을 내려받고 나면 이 구성은 오프라인에서도 쓸 수 있습니다.
CLI 에이전트를 선택해 Claude Code나 Codex처럼 설치된 에이전트를 설정할 수도 있습니다. 이들은 자체 계정과 인증을 사용합니다. 어시스턴트로 돌아가 Oleafly 에이전트 또는 CLI 에이전트를 선택한 뒤, 대화에 쓸 런타임과 모델을 고르세요. 정확한 절차는 제공자 설정, CLI 에이전트, Ollama를 참고하세요.
승인 모드 정하기
승인 선택기는 채팅 메시지 입력란 아래에 있으며 프로젝트별로 저장됩니다.
| 모드 | 사용하는 경우 |
|---|---|
| 승인 요청 | 읽기로 분류된 도구는 실행하게 두고, 그 밖의 작업은 먼저 검토합니다. |
| 알아서 승인 | 읽기와 네트워크 도구를 허용합니다. 파일 변경과 셸 명령은 여전히 먼저 물어봅니다. |
| 전체 접근 권한 | 도구 작업을 승인 요청 없이 실행합니다. |
| 사용자 지정 | 저장해 둔 허용/거부 규칙을 적용하고, 규칙에 맞지 않는 도구에는 표준 위험 정책을 적용합니다. |
처음 편집할 때는 승인 요청을 고르세요. 승인하기 전에 각 승인 카드의 도구 작업 내용을 읽어 보세요. 선택한 구절만 고치는 경우에는 인라인 편집이 검토하기 좋은 대체 문안을 보여 줍니다. 승인 관련 컨트롤은 선택한 런타임에 따라 다르며, CLI 에이전트에는 자체 설정도 있습니다.
지침과 승인에서 프로젝트 규칙, approvals.toml, 그 밖의 설정 파일을 설명합니다. 지침은 작업의 방향을 안내하고, 승인 모드는 어시스턴트가 실행할 수 있는 것을 제어합니다.
충분한 맥락 주기
관련된 장, 참고문헌, 그림, 데이터를 프로젝트 안에 두세요. 맥락 추가로 요청에 필요한 자료를 어시스턴트에게 알려 줍니다. 표기법이나 문체 선호가 있다면 설정 → AI 어시스턴트 → 지침에 사용자 지정 지침으로 저장하세요.
프리앰블의 표기 매크로는 그대로 유지해 줘. 인용 키는 바꾸지 마. LaTeX를 편집한 뒤에는 컴파일하고 영향을 받은 PDF 페이지를 확인해 줘. 확인하지 못한 부분은 모두 알려 줘.
스킬은 문헌 검색, 그림, 검토 같은 반복 작업을 위한 재사용 가능한 작업 절차를 제공합니다. 어시스턴트의 스킬 카드나 슬래시 메뉴에서 하나를 고른 다음, 질문과 필요한 결과물을 덧붙이세요.
결과를 확인할 수 있게 만들기
빌드를 고칠 때는 실패하는 파일을 지정하고 컴파일 성공을 요청하세요. 그림은 데이터, 크기, 레이블, 저장 위치를 지정하세요. 문헌 검색은 제목, 출처 링크, 각 논문이 리뷰에 들어가야 하는 이유에 대한 짧은 설명을 요청하세요.
특정 절을 요청하는 예는 이렇습니다.
서론의 첫 두 단락을 더 명확하게 고쳐 줘. 주장, 표기, 인용 키는 그대로 유지해 줘. 프로젝트를 컴파일해서 수정한 문장이 PDF에 나타나는지 확인하고, 바꾼 내용을 목록으로 알려 줘.
결과를 요청과 대조해서 읽으세요. 빌드가 성공했다는 것은 문서가 컴파일된다는 뜻일 뿐, 과학적 주장이나 인용이 옳다는 것을 보증하지는 않습니다.
긴 작업은 연구 작업으로 맡기기
연구 작업 공간 → 작업 → 새 작업을 엽니다. 제목을 붙이고, 지시를 작성하고, 사용할 수 있는 에이전트와 모델을 고르세요. 작업을 만든 다음 시작합니다. 에이전트는 격리된 사본에서 작업하므로 그동안 계속 글을 쓸 수 있습니다.
예를 들어 관련 논문 다섯 편, 확인된 식별자, 각 논문의 관련성을 설명하는 한 단락이 담긴 reading-list.md를 만들게 할 수 있습니다. 활동을 따라가고, 검토에서 파일 미리 보기를 열어 본 뒤, 준비되면 선택한 결과를 적용하세요. 문헌 조사, 독립적인 검토, 원고에 가져오기 전에 확인하고 싶은 그림 실험에 유용합니다.
연구 작업 가이드에서 작업을 시작, 중지, 검토, 적용, 제거하는 방법을 설명합니다.
쓸 만한 버전 보관하기
저장된 체크포인트와 Git은 맡은 일이 다릅니다. 컴파일에 성공하면 소스가 바뀌었고 빌드가 조건에 맞을 때 Oleafly가 체크포인트를 저장할 수 있습니다. 버전 관리 → 저장된 체크포인트를 열어 체크포인트를 확인하거나 복원하세요. 의도적인 Git 커밋을 만들고 공동 작업자와 공유하려면 소스 관리를 사용하세요.
AI가 편집할 때마다 체크포인트가 자동으로 만들어지는 것은 아닙니다. 큰 수정 전에는 현재 초안을 컴파일해서 체크포인트가 있는지 확인하거나 Git 커밋을 만드세요. 체크포인트와 Git 기록을 참고하세요.