diff --git a/AGENTS.md b/AGENTS.md index 554372e..30fe2e9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -114,6 +114,8 @@ event: error data: { "message": "오류 안내" } 실패. 상세 원인은 대화 이력에 답변을 넣을 때는 말풍선 텍스트를 빈 줄(`\n\n`)로 이어 붙인다. 핵심 내용은 `**굵게**` 마크다운으로 오므로 프론트가 굵은 글씨로 렌더링한다. +공지·행사를 근거로 답하면 마지막 줄에 `출처: [제목](/notices/11) (게시일)` 형태의 마크다운 링크가 온다. +주소는 Stream 웹의 상세 화면 경로(`/notices/:id`, `/events/:id`)이고, 프론트는 `/`로 시작하는 주소만 링크로 그린다. 대화 이력은 요청마다 `messages`로 통째로 받는다. AI 서버는 대화 상태를 저장하지 않는다. 서버가 무상태여야 재배포·장애 복구 시 진행 중이던 대화가 날아가지 않고, 인스턴스를 늘릴 때 @@ -182,7 +184,7 @@ search(query: str) -> list[dict] # [{"text": ..., "meta": {...}}, ...] 시스템 프롬프트는 `prompts/system_v2.md`에 둔다. 코드에 문자열로 넣지 않는다. 비개발자가 말투를 수정할 수 있어야 한다. - 검색된 문서에 없는 내용은 생성하지 않는다. 모르면 "해당 정보를 찾지 못했어요"라고 답하고 문의처를 안내한다. -- 모든 답변에 출처를 표시한다(문서 제목 + 게시일 + 링크). +- 공지·행사를 근거로 답할 때만 출처를 표시한다(제목 + 게시일 + 상세 화면 링크). 시드·FAQ·아카이빙·열린피드백·실시간 조회 답변에는 출처 줄을 붙이지 않는다. 링크가 없는 출처 줄은 번잡하기만 하다. - 학사 정보는 직접 단정하지 않고 원문으로 안내한다. - 해요체로 간결하게. 토스 UX 라이팅 원칙을 따른다(쉬운 말, 군더더기 제거, 핵심만 굵게). diff --git a/app.py b/app.py index e95827c..7d84120 100644 --- a/app.py +++ b/app.py @@ -194,7 +194,8 @@ def build_context(docs: list[dict]) -> str: f"제목: {m.get('제목', '(제목 없음)')}\n" f"게시일: {m.get('게시일', '(알 수 없음)')}\n" f"유효기간: {m.get('유효기간') or '없음'}\n" - f"링크: {m.get('출처URL', '')}\n" + # 링크는 공지·행사에만 있다. 비어 있으면 "없음"으로 적어, 모델이 빈 링크로 출처 줄을 만들지 않게 한다(#81). + f"링크: {m.get('출처URL') or '없음'}\n" f"내용: {d.get('text', '')}" ) return "\n\n".join(blocks) diff --git a/prompts/system_v2.md b/prompts/system_v2.md index 5672154..61842ef 100644 --- a/prompts/system_v2.md +++ b/prompts/system_v2.md @@ -12,11 +12,14 @@ 추측하거나 일반적인 지식으로 빈칸을 채우지 않습니다. 문서가 일부만 관련 있으면, 아는 부분만 답하고 나머지는 모른다고 밝힙니다. -3. 답변 마지막 줄에 근거 문서를 표시합니다. +3. 링크가 있는 문서(공지·행사)를 근거로 답했을 때만, 답변 마지막 줄에 출처를 붙입니다. - > 출처: {제목} ({게시일}) {링크} + 출처: [{제목}]({링크}) ({게시일}) - 여러 문서를 참고했으면 모두 적습니다. + - 링크는 참고 문서의 "링크" 값을 바꾸지 않고 그대로 씁니다. 주소를 지어내지 않습니다. + - 링크가 "없음"인 문서만 참고했으면 출처 줄을 붙이지 않습니다. + - 공지·행사를 여러 개 참고했으면 한 줄에 하나씩 모두 적습니다. + - 줄 앞에 `>`나 `-`를 붙이지 않습니다. 4. 학사 정보(수강신청 날짜, 장학금 금액, 학사일정 등)는 직접 단정하지 않습니다. 관련 공지가 있으면 제목과 링크만 안내하고, 정확한 내용은 원문에서 확인하도록 합니다. diff --git a/sync.py b/sync.py index 0fbc407..b6be1bd 100644 --- a/sync.py +++ b/sync.py @@ -10,6 +10,10 @@ `{"text": 본문, "meta": {문서ID, 출처URL, 제목, 게시일, 유효기간, 문서유형}}` 문서ID 접두어(notice-, event-, archive-, feedback-)도 같게 맞췄다. 골든셋의 근거문서ID를 다시 맞출 때 이 이름을 쓴다. +출처URL은 공지·행사에만 넣는다(#81). Stream 웹의 상세 화면 경로(`/notices/11`, `/events/3`)이고, +챗봇이 답변 끝에 이 주소로 링크를 붙인다. 아카이빙·열린피드백은 출처 줄 자체를 붙이지 않기로 해서 비워 둔다. +주소 앞부분(도메인)은 넣지 않는다. 프론트가 같은 사이트 안 이동으로 처리하고, dev·운영 주소가 달라도 그대로 쓸 수 있다. + 담당: AGENTS.md상 승빈 담당 파일이다. 내부 API 연결은 이상현이 먼저 만들었다(2026-11-09 합의). """ @@ -65,7 +69,7 @@ def _notice(n: dict) -> dict: return {"text": n["content"], "meta": { "문서ID": f"notice-{n['noticeId']}", "제목": n["title"], "게시일": _date(n.get("createdAt")), "유효기간": "", - "출처URL": "", "문서유형": "공지"}} + "출처URL": f"/notices/{n['noticeId']}", "문서유형": "공지"}} def _event(e: dict) -> dict: @@ -85,7 +89,7 @@ def _event(e: dict) -> dict: "문서ID": f"event-{e['eventId']}", "제목": e["title"], "게시일": _date(e.get("applyStartAt") or e.get("eventStartAt")), "유효기간": _date(e.get("eventEndAt")), - "출처URL": "", "문서유형": "행사"}} + "출처URL": f"/events/{e['eventId']}", "문서유형": "행사"}} def _archive(a: dict) -> dict: