현장에서 제품 매뉴얼을 바로 찾는 AI 앱 개발하기

핵심 요약

1. 제품 모델과 설치 버전으로 매뉴얼을 찾고, 답변의 근거가 되는 원문을 확인하는 앱을 만듭니다. 2. 문서 검색과 근거 표시 기술을 연결하고, 네트워크가 없을 때는 저장한 매뉴얼을 따로 보여 줍니다. 3. 버전별 검색 범위, 자료가 없을 때의 담당자 문의, 저장 문서 갱신 규칙은 직접 개발합니다.

출장 현장에서는 매뉴얼을 빨리 찾는 것만큼 해당 제품에 적용할 수 있는 자료인지 확인하는 일이 중요합니다. AI 앱 개발과 챗봇 개발을 발주할 때도 답변 화면뿐 아니라 모델과 버전을 확인하는 흐름까지 정해야 합니다. 아래는 출장기사용 앱을 제작할 때 필요한 기능과 구현 범위입니다.

제품 모델과 설치 버전으로 매뉴얼 찾기

첫 화면에는 제품 모델, 설치 버전, 궁금한 증상을 입력하는 칸을 둡니다. 기사가 ‘매뉴얼 찾기’를 누르면 선택한 모델과 버전에 해당하는 문서부터 검색합니다. 설치 버전을 모르는 경우에는 확인 위치를 안내하고, 임의의 버전을 선택해 답변하지 않도록 처리합니다.

LlamaIndex는 문서와 문서 조각인 노드에 부가 정보인 메타데이터와 관계를 함께 저장할 수 있습니다. 이를 활용하려면 매뉴얼마다 적용 모델, 설치 버전, 문서 개정일을 붙이는 작업을 직접 구현해야 합니다. 문서를 나눈 뒤에도 이 정보가 유지되어야 하며, 비슷한 모델의 문서가 검색 결과에 섞이지 않는지 확인합니다.

답변 옆에서 근거 구간과 문서 버전 확인하기

검색된 문서의 관련 부분을 바탕으로 짧은 답변을 만들고, 답변 옆에 ‘근거 원문 보기’ 버튼을 둡니다. Claude Citations는 제공 문서와 답변의 근거 구간을 연결하지만, 답변의 정확성이나 문서 최신성까지 보장하지는 않습니다. 따라서 답변에 사용할 문서를 먼저 올바르게 고르는 처리가 필요합니다.

원문 화면에는 문서명, 문서 개정일, 적용 버전, 해당 절 제목을 함께 표시합니다. 인용된 구간과 실제 매뉴얼을 연결하는 화면 및 이동 로직은 별도로 개발합니다. 검수할 때는 버튼이 열리는지만 보지 않고, 답변에 적힌 조치가 표시된 원문에 있는지와 선택한 설치 버전에 적용되는지 확인합니다.

자료가 없으면 담당자 문의로 이어가기

해당 버전의 매뉴얼이 없거나 질문을 설명할 근거 구간을 찾지 못하면 ‘확인할 자료가 없습니다’라고 안내합니다. 이때 다른 버전의 설명을 대신 내보내지 않도록 검색 조건과 답변 생성 조건을 직접 연결합니다. 조회 결과가 없다는 사실과 제품에 이상이 없다는 판단은 구분해서 보여 줘야 합니다.

‘담당자 문의’를 누르면 제품 모델, 설치 버전, 기사 질문을 담은 문의 초안을 엽니다. 기사는 현장에서 확인한 내용을 덧붙인 뒤 전송하고, 담당자는 같은 정보를 보고 확인을 시작할 수 있게 만듭니다. 제품군별 담당 부서 연결과 접수 내역 확인 기능도 개발 범위에 포함하며, 문의 화면으로 넘어갈 때 입력 정보가 빠지지 않는지 검수합니다.

Flutter로 저장 매뉴얼과 온라인 검색 구분하기

Flutter 공식 문서는 기기에 저장한 자료와 원격 API를 데이터 관리 계층에서 함께 다루는 오프라인 우선 설계 예시를 제공합니다. 출장 전에 필요한 매뉴얼을 선택해 저장하는 기능에 이 방식을 적용할 수 있습니다. 다운로드 대상, 저장 용량, 갱신 시점은 업무에 맞춰 직접 정합니다.

네트워크가 끊기면 ‘저장한 매뉴얼’ 목록을 열고, 문서 버전과 마지막 저장 시각을 표시합니다. 저장하지 않은 자료는 연결 후 검색하도록 안내하고, 다시 연결되면 서버의 문서 정보와 비교해 교체가 필요한 자료를 알려 줍니다. 연결이 끊긴 상태에서 저장 문서를 최신 자료로 표시하지 않는지 검수하며, 저장 문서 열람과 오프라인 AI 답변·사진 진단은 별개의 기능으로 다룹니다.

문서 등록 규칙과 버전 오류 검수하기

개발 전에 받을 자료는 두 종류로 구체화할 수 있습니다. 예를 들어 ‘MX-200 설치 매뉴얼 개정 3판 PDF’와 ‘현장번호·제품 모델·제어 프로그램 설치 버전이 적힌 설치 이력표’입니다. 문서 개정 번호와 현장 설치 버전은 서로 다른 정보이므로, 어느 매뉴얼이 어느 설치 버전에 적용되는지 연결한 목록도 함께 확인해야 합니다.

대표 실패 사례는 설치 버전 2.1을 선택했는데 검색 대상에 있는 3.0 문서를 근거로 조치 방법을 답하는 경우입니다. 이 조건에서는 적용 가능한 자료가 없음을 알리고 담당자 문의로 연결되어야 검수를 통과하도록 정합니다. 관리자가 새 매뉴얼을 등록할 때도 적용 버전을 확인하게 하고, 기존 저장본의 교체 기준을 정해 앱과 문서 관리 업무를 연결합니다.

제품별 매뉴얼 PDF와 현장 설치 버전 자료, 문의를 넘길 담당 부서를 준비해 트램스에 개발을 문의해 주세요. 모델별 검색부터 근거 원문 확인, 저장 매뉴얼 열람까지 필요한 기능을 함께 알려 주시면 구현 범위를 구체화할 수 있습니다.

트램스 AI 제작 문의 (https://trams.co.kr/ai-si/contact/#inquiry)