커리큘럼
아카데미모듈 5 · 에이전트와 일하기
케이스 파일: 모든 조사의 집
이 레슨에서 배우는 것
- 대화를 고정하거나, 엔티티 페이지에서, 또는 백지에서 케이스를 만들 수 있습니다
- 핵심 질문으로 케이스의 방향을 잡고 수사 로그를 이어서 적을 수 있습니다
- 고정 엔티티 세트를 키우고 다듬어 그래프 캔버스와 엔티티 테이블로 투사할 수 있습니다
- 새 증거 스트립으로 지난 방문 이후의 변화를 따라잡을 수 있습니다
- 케이스와 컬렉션 중 상황에 맞는 쪽을 고를 수 있습니다
어떤 질문 하나를 3주째 붙잡고 있다고 해봅시다. 급여 정산을 어느 업체에 맡길지, 반복되는 버그가 결국 한 라이브러리 탓인지.
증거는 이미 다 있습니다. 다만 채팅 세션 몇 개(그중 몇은 긴 에이전트 작업), 노트 열두 개, 그래프 곳곳의 엔티티에 흩어져 있을 뿐이죠. 그래서 다시 들여다볼 때마다 맥락을 기억에 의지해 처음부터 짜맞추게 됩니다.
케이스(Case)는 이 문제에 대한 Consilience의 답입니다. 하나의 조사를 오래 담아 두는 그릇이라고 보면 됩니다. 케이스 하나에 핵심 질문 하나, 직접 고정한 지식그래프 엔티티, 편입한 대화, 자유 텍스트 로그가 들어갑니다. 다시 돌아오면, 자리를 비운 사이 어느 고정 엔티티에 새 증거가 붙었는지 알려줍니다.
케이스에 담기는 것
| 필드 | 설명 |
|---|---|
| 이름 | 고정한 대화의 제목에서 따옵니다(제목이 없으면 "제목 없는 케이스"). 그 자리에서 바로 고쳐 쓰고, Enter를 누르거나 다른 곳을 클릭하면 저장됩니다. |
| 핵심 질문 | 선택 입력이며 자유 텍스트입니다. 안내 문구가 이렇게 묻습니다: "이 케이스는 무엇에 관한 것인가요?" |
| 고정된 엔티티 | 지식그래프 엔티티입니다. 그래프의 실제 엔티티 노드를 가리키는 참조이고, 고정한 순간에 붙잡아 둔 표시 라벨을 함께 저장합니다. |
| 대화 | 케이스에 편입한 채팅입니다. 케이스는 채팅을 가리키는 포인터만 담으므로 채팅 자체는 평소 채팅 기록에 그대로 남습니다. |
| 수사 로그 | 자유 텍스트 메모입니다. 입력란에서 포커스가 벗어나면 저장되고, 세션이 바뀌어도 계속 쌓입니다. |
- 케이스 (Case)
- 하나의 핵심 질문, 고정 엔티티, 편입 대화, 로그를 묶는 오래 가는 수사 컨테이너.
- 고정된 엔티티
- 그래프의 실제 노드 자체를 가리키는 참조입니다. 라벨은 고정한 순간의 것을 저장합니다.
- 편입된 대화
- 케이스에 속한 채팅. 포인터일 뿐이라 원본은 채팅 기록에 그대로 있습니다.
- 핵심 질문 (driving question)
- 케이스의 방향을 잡는 한 줄: "이 케이스는 무엇에 관한 것인가요?"
- 수사 로그
- 발견을 적어 두는 자유 텍스트입니다. 포커스가 벗어날 때 저장되고 계속 쌓입니다.
- 새 증거 스트립
- 케이스를 다시 열 때, 지난 방문 이후 그래프 증거가 늘어난 고정 엔티티를 알려주는 검사.
케이스를 시작하는 세 가지 방법
기본 경로: 대화를 케이스로 고정
대화를 나눕니다
평소처럼 주제를 이야기합니다.
@로 엔티티를 멘션하거나, 어시스턴트가 답변에[[엔티티]]를 인용하도록 둡니다. 나중에 고정할 때 읽는 것이 바로 이 기록입니다.고정합니다
사이드바 세션 목록에서 채팅을 우클릭(또는 "…" 버튼 클릭)하고 "케이스로 고정…"("Pin as case…")을 선택합니다.
토스트를 확인합니다
"새 케이스로 고정됨" 토스트가 고정된 엔티티 개수와 함께 뜹니다. 채팅이 편입되고 인식된 엔티티가 모두 고정된 채로, 채팅 제목을 그대로 이어받은 케이스가 열립니다.
- 엔티티 페이지에서: 헤더의 "케이스에 추가"("Add to case") 드롭다운을 엽니다. "이 엔티티로 새 케이스"를 고르면 그 엔티티가 미리 고정된, 엔티티 이름을 딴 케이스가 생깁니다. 구분선 아래에는 기존 케이스가 전부 나열되니 원하는 곳에 골라 담을 수도 있습니다. 담으면 "{라벨}을(를) 케이스에 추가했습니다" 토스트가 확인해 줍니다.
- 백지에서: ⌘⇧K로 케이스 목록을 열고 "새 케이스"("New case")를 누릅니다. 엔티티도 대화도 없는 "제목 없는 케이스"가 하나 만들어집니다.
이해도 체크
채팅을 우클릭해 "케이스로 고정…"을 선택했습니다. Consilience는 어떤 엔티티를 고정할지 어떻게 정합니까?
케이스를 일상적으로 굴리기
케이스는 "케이스"라는 탭 하나에서 삽니다. 그 탭 하나가 전체 케이스 목록과 개별 케이스 상세를 모두 담당하고, 다른 케이스를 열면 같은 탭이 그 자리에서 갈아탑니다. 그래프 탭이나 엔티티 테이블 탭과 똑같은 방식이죠. 케이스 안에는 필요한 것이 한 화면에 다 모여 있습니다:
| 컨트롤 | 동작 |
|---|---|
| "이 케이스로 이어가기" (Continue in this case) | 새 채팅을 열어 케이스에 편입하고, 고정된 엔티티 전부를 실제 @멘션 칩으로 컴포저에 미리 채워 둡니다. 보내기 전에 필요 없는 칩은 지우면 됩니다. |
| "캔버스에 표시" (Show on canvas) | 딱 고정된 세트만 그래프 캔버스에 따로 띄우고, 타입별로 색을 입힙니다. 엔티티를 하나라도 고정하면 활성화됩니다. |
| "테이블로 열기" (Open as table) | 이 케이스 범위의 엔티티 테이블을 엽니다(이름/타입/연결/노트, 필터와 정렬). 역시 엔티티를 하나 고정하면 활성화됩니다. |
| 엔티티 칩 | 라벨을 클릭하면 그 엔티티의 프로필 페이지가 열리고, 호버 후 ✕("제거")를 누르면 고정이 해제됩니다. |
| "수사 로그" | 케이스에 남기는 진행 메모입니다. 안내 문구가 지금까지 알아낸 것을 적으라고 권하고, 포커스가 벗어나면 저장됩니다. |
| "케이스 삭제" (Remove case) | 확인창을 거쳐 컨테이너만 지웁니다: "노트와 대화는 그대로 유지됩니다." |
지난번 이후 무엇을 알게 됐나
한동안 떠나 있다가 케이스를 다시 열면, Consilience는 지난번에 이 케이스를 마지막으로 연 시각을 기준으로 잡습니다. 그런 다음 그 시점 이후에 새 사실이 붙은 고정 엔티티가 있는지 지식그래프에 물어봅니다. 있다면 스트립이 뜹니다: "지난 방문 이후 고정 엔티티 N개에 새 증거:" 뒤에 해당 라벨이 이어집니다.
다 따라잡았으면 ✕("닫기")를 누르세요. 닫힘은 그 세션 동안만 유지되고, 이 검사는 케이스를 열 때마다 한 번씩 돌아갑니다.
이해도 체크
새 증거 스트립이 고정 엔티티 두 개를 이름과 함께 띄웠습니다. 이것은 무엇을 뜻합니까?
케이스냐 컬렉션이냐
케이스와 저장된 엔티티 컬렉션은 그래프를 같은 방식으로 들여다봅니다. "캔버스에 표시"와 "테이블로 열기"는 컬렉션이 쓰는 바로 그 뷰입니다. 아무것도 복제되지 않고, 둘 다 하나의 그래프를 보는 렌즈일 뿐입니다. 그렇다면 언제 어느 쪽에 손을 뻗어야 할까요.
| 원하는 것 | 선택 |
|---|---|
| 언제든 다시 꺼내 보고, 정렬하고, 필터링하는 재사용 가능한 엔티티 집합 | 컬렉션 |
| 하나의 질문, 그리고 그 주위의 대화와 메모, 증거의 흐름 | 케이스 |
| 직접 고른 세트에 대한 "지난번 이후 무엇이 달라졌나" 확인 | 케이스, 새 증거 스트립으로 |
| 엔티티 테이블의 소스 전환기에 늘 떠 있는 세트 | 컬렉션. "전체 엔티티"·타입 항목과 나란히 전환기에 바로 뜹니다 |
케이스는 앱에서 가장 가볍고 안전한 구조입니다. 하나하나가 워크스페이스 단위로 기기 안에만 저장되니, 마크다운에는 절대 기록되지 않고 모델로 전송되지도 않습니다. "케이스 삭제"를 눌러도 노트와 엔티티, 채팅은 전부 그대로 남습니다.
질문 하나가 채팅 한 판을 넘어서는 순간, 케이스를 하나 열어 주세요. 다음은 또 다른 종류의 기록입니다. 내장 Git 패널이 파일이 거쳐 온 변경의 내력을 그대로 남겨 둡니다.