AiAkiv 검색은 키워드 매칭이 아니라 의미 + 연결 검색이다. 잘 쓰면 키워드로는 불가능한 질문에 답한다.
기본: 그냥 자연어로 물어본다
ak 전투 시스템 설계가 어떻게 바뀌었어?
검색은 기본이 hybrid(이벤트 + 엔티티, 의미 기반)라서 단어가 안 겹쳐도 찾는다. 결과 각각에는:
- reason: 왜 이게 걸렸는지(유사 임베딩 / 공유 엔티티 / 순차 연결 등)
- 연결 지도(hint): 결과들이 어떤 스레드·엔티티·주제로 엮이는지
결과를 목록 그대로만 훑지 말고 reason과 연결 지도를 같이 읽어라. "최신/관련"을 물을 땐 유사 임베딩 표시가 이름이 바뀐 동의어를 가리키는 경우가 많다. 따라가면 더 나온다.
요약이 부족하면 원문을 가져온다
검색은 이벤트 요약을 준다. 요약은 LLM 생성물이라 드물게 부정확할 수 있다. 정확한 내용이 필요하면 원문 조회로 이벤트 원문을 가져온다.
@로 작성자·팀을 좁힌다
누가 쓴 기억인지는 서버가 저장 시점에 자동으로 찍는다(위조 불가). 검색 쿼리
맨 앞의 @handle이 귀속 필터다.
@[email protected]: 그 사용자의 이벤트를 최신순으로 브라우즈@[email protected] 세이브 버그: 그 사용자 범위 안에서 검색@팀이름 ...팀 귀속 콘텐츠로 필터
일반 태그는 @로 시작할 수 없어서, "누가 썼는가"는 클라이언트나 AI가 위조할 수
없다.
키워드가 못 하는 질문: AiAkiv의 자리
이런 질문이 AiAkiv가 빛나는 곳이다. 키워드가 구조적으로 실패하기 때문이다.
- 인과·시간 도약: "이 버그의 원인이 된 과거 결정은?" 버그 이벤트에서 원인 링크·시간축을 거슬러 과거 결정으로. (저장할 때 원인을 이어둔 게 여기서 살아난다 → 저장하기.)
- 공유 엔티티 연결: "인벤토리와 세이브가 왜 같이 바뀌었어?" 두 사건이 공유하는 엔티티로.
- 변화 이력: "밸런스 조정 히스토리 보여줘". 같은 주제의 사건들을 시간축 위에 나열.
가장 최근 것을 여는 열린 질문도 좋다: "가장 최근 버그랑 그 원인이 뭐야?" 특정 버그를 전제하지 않아도, 그래프가 최근 사건과 그 인과를 물어온다.
검색 범위는 서버가 정한다
검색 범위(도메인·태그)는 서버가 접근 정책으로 결정한다. 클라이언트가 쿼리로
좁히거나 넓힐 수 없다. 응답의 searched_scope가 실제 적용된 범위를 알려준다.
"내 팀에서 내가 읽을 수 있는 것"이 상한이다. 특정 도메인만 보고 싶으면 결과를
거르지, 쿼리에 도메인 필터를 넣지 않는다(그러면 데이터가 조용히 빠질 수 있다).