Notion Agent 같은 서비스 제작하기: 회사 문서 검색·수정·업무 데이터 정리 제작법

핵심 요약

1. 회사 문서에서 근거를 찾고 문서 수정안과 업무 데이터 변경을 만드는 서비스를 설계합니다. 2. Notion API로 허용된 자료를 연결하고 Claude API 또는 OpenAI Structured Outputs로 작업별 결과를 구성합니다. 3. 접근 권한, 변경 전후 비교, 데이터 검증과 승인·저장 이력은 자체 개발합니다.

Notion Agent의 기능에서 참고할 가치는 회사 자료를 읽는 일을 실제 문서와 업무 데이터의 변경으로 이어주는 것입니다. 사내 지식 검색 AI 구축에서 출발해 문서 수정과 데이터 정리까지 확장하는 구조를 살펴봅니다. 여기서 Notion API는 통합에 공유된 자료를 연결하는 수단이며, Notion Agent 자체를 호출하는 API로 전제하지 않습니다.

회사 문서를 권한에 맞게 연결하기

입력은 사용자의 질문과 통합에 공유한 페이지·데이터베이스입니다. Notion API로 필요한 내용과 문서 식별자, 갱신 정보를 읽어 서비스 내부 형식으로 정리합니다. 자체 로직은 사용자와 조직, 공유 범위의 관계를 확인하고 조회 가능한 문서를 결정합니다.

권한 기반 RAG 구현에서는 검색 후보를 만든 뒤 답변에서만 숨기는 방식으로 처리하지 않습니다. 검색과 모델 입력에 들어갈 자료를 선택할 때부터 접근 범위를 적용합니다. 출력은 해당 사용자가 사용할 수 있는 문서와 원문 주소이며, 공유 해제와 문서 변경도 검색 자료에 반영합니다.

질문에 필요한 문맥과 출처 찾기

입력은 질문과 권한 검사를 통과한 문서입니다. 문서를 제목·본문·업무 항목으로 나누어 검색하고, 찾은 문단에 원문 페이지와 위치를 연결합니다. 검색된 자료를 생성 모델에 함께 제공하는 RAG 구조로 사내 용어와 업무 맥락을 답변에 반영합니다.

자체 로직은 최신 문서와 폐기된 안내를 구분하고 같은 주제의 내용이 충돌하면 검토 대상으로 표시합니다. 충분한 근거가 없을 때는 필요한 문서나 조건을 추가로 요청합니다. 출력은 근거 문단과 이를 이용한 답변이며, 독자가 원문에서 내용을 확인할 수 있게 구성합니다.

문서 작성·수정 후보 생성하기

입력은 수정 지시, 현재 문서와 관련 근거입니다. Claude API로 수정 후보를 생성하고, 자체 코드는 원문과 변경안을 나란히 보여줍니다. 제목이나 특정 구간만 바꾸는 요청이면 변경 범위를 제한해 관련 없는 문단까지 바뀌지 않도록 합니다.

문서 수정 AI 서비스 개발에서는 승인 시점의 원문 버전을 저장하는 것이 중요합니다. 다른 사용자가 그사이 문서를 수정했다면 덮어쓰기 전에 차이를 다시 확인해야 합니다. 승인된 범위만 Notion API로 반영하고, 출력에는 변경한 페이지와 처리 결과를 연결합니다.

업무 데이터를 정해진 필드로 정리하기

입력은 사용자의 업무 지시와 기존 데이터베이스 항목입니다. OpenAI Structured Outputs로 담당자·기한·상태처럼 정해진 항목을 갖춘 변경 후보를 받도록 구성할 수 있습니다. 문서 작성 모델과 데이터 추출 모델은 기능별 대안으로 선택하며 반드시 모두 호출할 필요는 없습니다.

자체 로직은 담당자의 존재, 날짜 형식, 허용된 상태 전환과 중복 항목을 검사합니다. 모호한 표현은 임의의 확정값으로 바꾸지 않고 확인할 항목으로 보여줍니다. 출력은 항목별 변경 전후와 검증 결과이며, 사용자가 승인한 값만 실제 업무 데이터로 저장합니다.

실패와 중복을 관리하는 실행 이력 만들기

업무 데이터 정리 에이전트 만들기는 문장 생성 이후의 처리까지 포함합니다. 조회·변경 제안·승인·저장을 별도 상태로 두고 같은 요청이 재개돼도 이미 완료된 변경을 반복하지 않도록 작업 ID를 기록합니다. 통신이 끊기면 실제 저장 결과를 먼저 확인하고 재시도를 결정합니다.

외부 모델에 보낼 자료 범위, 문서 보관 기간과 조직별 접근 정책도 서비스에 맞게 정합니다. AI 스킬에는 문서 작성 원칙과 검토 순서를 담을 수 있으며 실제 권한과 저장 검사는 코드가 담당합니다. 연결할 문서, 필요한 수정 작업과 승인 절차를 정리해 트램스 AI에 제작을 문의해 주세요: https://trams.co.kr/ai-si/contact/#inquiry