Assist 검색에 맞는 문서 작성

검색 증강 생성(RAG)은 문서를 작은 단위로 나누고 질문과 관련된 부분을 검색하여 응답 문맥에 제공합니다. 기본 Assist에서는 검색한 사용자 정의 내용과 공개 문서 정보를 함께 사용할 수 있습니다. 문서 전체의 앞뒤를 읽어야만 이해할 수 있는 문장은 검색된 일부 내용만으로 해석하기 어렵습니다.

주제별 구조

제목과 하위 제목마다 하나의 주제나 질문을 다룹니다. 자동화, 암호화, 협업과 분석 기능을 한 문단에 묶기보다 각각 별도 절에 설명합니다. 각 절에는 그 기능을 식별할 이름과 설명을 함께 둡니다. 검색된 절만 읽어도 대상과 조건을 이해할 수 있어야 합니다.

공개 문서 용어와 구분

build, code repository처럼 공개 문서에도 있는 용어를 사내 고유 의미로 쓴다면 해당 업무에서 무엇을 뜻하는지 명시합니다. 같은 단어가 다른 기능이나 절차를 가리키면 검색 결과가 혼동될 수 있습니다.

폐기된 안내 정리

절차가 바뀌면 원래 내용을 현재 절차로 수정하거나 잘못된 문서를 제거합니다. 오래된 안내를 그대로 두고 맨 위에 폐기 표시를 하거나 문서 끝에 덮어쓰는 지시를 추가하면 검색된 조각에 수정 안내가 포함되지 않을 수 있습니다.

예를 들어 높은 우선순위의 문제를 이메일로 보내던 절차가 관리 시스템 티켓 생성으로 바뀌었다면, 이메일 지시와 나중에 붙인 변경 주석을 함께 남기지 않습니다. 현재 사용자가 해야 할 "관리 시스템에서 서비스 티켓을 생성합니다"라는 지시로 통합합니다.