원문 캡처 · docsgpt.cloud
원문 캡처 · docsgpt.cloud

DocsGPT 1.1은 대화에서 문서가 답하지 못한 질문을 찾아내고, 에이전트의 실행·일정·모니터링 활동을 한곳에 모은다. 공개 문서 사이트용 채팅 위젯과 자체 배포 환경에서 실행할 수 있는 0.4B 매개변수 모델 arc-decide도 추가했다.

대화 분석과 에이전트 활동

Insights는 대화를 분석해 답변이 질문에 충분히 답했는지, 사용자가 원하는 결과를 얻었는지, 불만을 나타내거나 사람의 응대를 요청했는지 추정한다. 결과는 답변 방식, 사용자 반응, 답변이 미흡한 이유, 요청 유형, 주제별로 이전 기간과 비교해 보여준다. 특히 Docs gaps에서는 문서가 질문을 다루지 않아 답변이 부족했던 사례를 페이지·자료 출처·주제별로 묶고, 각 항목에 예시 질문을 붙인다. 항목을 열어 사례를 더 보거나 Logs에서 대화를 확인하고 CSV로 내보낼 수 있으며, 에이전트 소유자는 매주 문서 공백 요약 알림을 받을 수 있다.

Insights는 각 에이전트의 Monitoring과 계정에서 확인할 수 있으며 앱, 공유 링크, API, 위젯의 트래픽을 다룬다. 대화가 끝난 뒤 몇 분이 지나면 백그라운드에서 분류하며, 응답을 기다리는 동안에는 분석하지 않는다. 모든 수치는 추정치다. 문서 공백으로 분류된 질문은 실제로 페이지가 있어도 검색이 찾지 못한 경우일 수 있으며, 이를 확인하려면 Test retrieval을 사용해야 한다. 분류별 신뢰 수준은 Insights 문서에 안내돼 있다.

Activity 탭은 New Chat 아래에 있으며 에이전트의 실행과 일정을 다섯 가지 보기로 모은다. Now에서는 승인 대기, 실행 중인 작업, 다음 24시간의 실행 일정과 모니터링 항목을 확인하고 진행 중인 답변을 중지할 수 있다. Calendar는 예약 실행과 지식 동기화를 일·주·월 단위로 보여주며 놓친 실행도 포함한다. History에는 예약·웹훅·워크플로 실행, 백그라운드 작업, 모니터 작동 기록을 7일·30일·90일 동안 보관한다. Schedules는 대화 중 어시스턴트가 설정한 일정을 포함해 모든 에이전트의 일정을 보여주고, Monitors에서는 가격 하락이나 페이지 변경을 감시하도록 요청할 수 있다. 조건이 충족되면 모니터가 확인한 뒤 대화를 이어간다.

자리를 비운 사이 끝난 대화는 읽지 않음으로 표시되고 브라우저 탭에 개수가 나타난다. 승인과 작업 완료는 알림창으로 표시되며, 운영자가 설정한 경우 웹 푸시 알림도 받을 수 있다.

arc-decide와 공개 문서 사이트 위젯

arc-decide는 대화 분석 등에 쓰는 0.4B 매개변수 분류 모델이다. 텍스트를 생성하지 않고, 예·아니요나 목록 중 하나를 고르거나 점수를 매기는 질문에 보정된 확률과 함께 답한다. 공개 데이터셋과 합성 대화로 학습했으며 실제 사용자 대화는 학습에 쓰지 않았다. 모델은 MIT 라이선스로 Hugging Face에 공개됐다.

DocsGPT 1.1에서 이 모델은 대화 분석, 프롬프트 인젝션 검사, 검색 결과 관련성 재정렬에 쓰인다. 인젝션 검사는 사용자 입력, 검색된 문단, 도구 결과, 첨부 파일, MCP 도구 설명에 점수를 매긴 뒤 에이전트의 안전장치에서 표시하거나 차단한다. 기존 규칙 기반 검사도 대체하지 않고 함께 작동한다. 표시된 문단은 답변에서 제외되며 자료 편집 권한이 있는 사람이 검토하고 수정하거나 안전하다고 표시할 수 있다. 관련성 설정은 자료 출처별로 Loose, Balanced, Strict 중 선택한다.

기본 설정에서는 모델이 DocsGPT API 안에서 CPU로 실행되며 메모리는 1GB 미만을 사용한다. 사이드카 컨테이너, Mac이나 NVIDIA GPU에서의 docsgpt decide-server, vLLM을 통한 실행도 지원한다. 대화 분류와 인젝션 검사는 CPU에서 실행할 수 있지만, 답변마다 여러 문단의 관련성을 평가하는 기능에는 GPU가 필요하다. 네트워크와 분리된 설치 환경에서는 docsgpt decisions prefetch로 모델을 미리 내려받을 수 있다. 세 기능은 각각 따로 켜며 기본값은 모두 꺼져 있다.

공개 문서 사이트용 Website 자료 유형은 기존 Link, Crawler, Sitemap을 대체한다. 사이트맵을 이용하거나 링크를 따라 한 페이지 또는 사이트 전체를 추가할 수 있고, DocsGPT는 각 페이지의 주요 내용을 Markdown으로 저장한다. 시작한 사이트의 범위 안에서만 페이지를 수집하며 일정에 따라 갱신한다. 기존 Link, Crawler, Sitemap 자료도 계속 동기화된다.

채팅 위젯은 전체 높이의 사이드바로 고정하거나 기존처럼 띄울 수 있다. 방문자 브라우저 설정에 따라 8개 언어로 표시되고, 환영 카드 아래 추천 질문과 방문자별 대화 기록을 제공한다. JavaScript API로 페이지에서 위젯을 열거나 방문자를 대신해 질문하고 이벤트에 반응하게 할 수 있다. 요금제나 계정 ID 같은 전달 값은 질문과 함께 에이전트 프롬프트 및 Logs에 기록된다. 위젯 대화도 에이전트의 Insights에 포함된다. 위젯 데모에서 확인할 수 있다.

기타 변경과 업그레이드 조건

에이전트별 문맥 한도를 설정할 수 있어 한 대화를 수주간 이어가는 봇과 위젯에서 요청당 모델에 보내는 토큰 수를 제한한다. 자료를 다시 가져올 때는 변경된 파일만 다시 임베딩하며, docsgpt-cli sources upload --sync로 폴더와 자료를 동기화할 수 있다. Google Drive는 사용자가 선택한 파일만 요청하고, 서비스 계정으로 폴더와 공유 드라이브를 동기화한다. Drive, SharePoint, Confluence의 인용은 원본 파일을 연다.

폴더 전체를 한 번에 올릴 수 있다. 답변이 만든 파일은 채팅에 카드로 표시되고 버전이 있는 사이드 패널에서 열 수 있으며, Word 출력은 제목·목록·표를 지원하고 API 클라이언트는 결과물을 내려받을 수 있다. 예약 및 웹훅 실행에서 코드 실행기를 사용할 수 있고, Stop은 해당 대화 차례가 시작한 백그라운드 작업도 취소한다. Airtable, Alpha Vantage, CoinGecko, Context7, Neon용 MCP 프리셋도 추가했다. 그 밖에 관리자 화면의 Activity는 Audit log로 이름이 바뀌었고 사용자 이메일이 표시된다. 앱은 프랑스어를 지원하며 Markdown·RST·JSON 파서와 재귀 청커도 수정됐다.

1.0에서 업그레이드하기 전에 1.1.0 업그레이드 안내를 확인해야 한다. 업로드, 커넥터 수집, 재수집, 동기화, 그래프 빌드는 새 Celery 큐인 ingest에서 실행된다. 명시적인 -Q 목록으로 워커를 실행한다면 이 큐를 추가해야 하며, 그렇지 않으면 새 자료가 "processing" 상태에 머문다.

새 Google Drive 로그인은 사용자가 선택한 파일만 요청하는 drive.file 권한을 사용한다. 전체 폴더 동기화를 유지하려면 Google Picker API를 활성화하고 GOOGLE_SERVICE_ACCOUNT_KEY를 설정하거나 GOOGLE_DRIVE_ACCESS=readonly를 지정해야 한다. 기존 연결은 계속 작동한다. GUARDRAILS_FLOOR는 더 이상 사용하지 않으며, 첫 시작 때 그 값이 인스턴스 기본 안전장치 수준으로 저장된 뒤 Admin › Guardrails에서 편집한다. 결정 모델 기능은 기본적으로 꺼져 있다. DECISION_ANALYTICS_ENABLED=true를 설정했다면 워커가 새 analytics 큐를 처리해야 한다. 시작 시 마이그레이션 0053~0057이 실행되며, 0057은 대규모 설치 환경에서 시간이 걸릴 수 있는 인덱스를 동시에 만든다.

변경 사항은 changelog와 GitHub 릴리스에서 확인할 수 있다.