Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -114,6 +114,8 @@ event: error data: { "message": "오류 안내" } 실패. 상세 원인은

대화 이력에 답변을 넣을 때는 말풍선 텍스트를 빈 줄(`\n\n`)로 이어 붙인다.
핵심 내용은 `**굵게**` 마크다운으로 오므로 프론트가 굵은 글씨로 렌더링한다.
공지·행사를 근거로 답하면 마지막 줄에 `출처: [제목](/notices/11) (게시일)` 형태의 마크다운 링크가 온다.
주소는 Stream 웹의 상세 화면 경로(`/notices/:id`, `/events/:id`)이고, 프론트는 `/`로 시작하는 주소만 링크로 그린다.

대화 이력은 요청마다 `messages`로 통째로 받는다. AI 서버는 대화 상태를 저장하지 않는다.
서버가 무상태여야 재배포·장애 복구 시 진행 중이던 대화가 날아가지 않고, 인스턴스를 늘릴 때
Expand Down Expand Up @@ -182,7 +184,7 @@ search(query: str) -> list[dict] # [{"text": ..., "meta": {...}}, ...]
시스템 프롬프트는 `prompts/system_v2.md`에 둔다. 코드에 문자열로 넣지 않는다. 비개발자가 말투를 수정할 수 있어야 한다.

- 검색된 문서에 없는 내용은 생성하지 않는다. 모르면 "해당 정보를 찾지 못했어요"라고 답하고 문의처를 안내한다.
- 모든 답변에 출처를 표시한다(문서 제목 + 게시일 + 링크).
- 공지·행사를 근거로 답할 때만 출처를 표시한다(제목 + 게시일 + 상세 화면 링크). 시드·FAQ·아카이빙·열린피드백·실시간 조회 답변에는 출처 줄을 붙이지 않는다. 링크가 없는 출처 줄은 번잡하기만 하다.
- 학사 정보는 직접 단정하지 않고 원문으로 안내한다.
- 해요체로 간결하게. 토스 UX 라이팅 원칙을 따른다(쉬운 말, 군더더기 제거, 핵심만 굵게).

Expand Down
3 changes: 2 additions & 1 deletion app.py
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
9 changes: 6 additions & 3 deletions prompts/system_v2.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,11 +12,14 @@
추측하거나 일반적인 지식으로 빈칸을 채우지 않습니다.
문서가 일부만 관련 있으면, 아는 부분만 답하고 나머지는 모른다고 밝힙니다.

3. 답변 마지막 줄에 근거 문서를 표시합니다.
3. 링크가 있는 문서(공지·행사)를 근거로 답했을 때만, 답변 마지막 줄에 출처를 붙입니다.

> 출처: {제목} ({게시일}) {링크}
출처: [{제목}]({링크}) ({게시일})

여러 문서를 참고했으면 모두 적습니다.
- 링크는 참고 문서의 "링크" 값을 바꾸지 않고 그대로 씁니다. 주소를 지어내지 않습니다.
- 링크가 "없음"인 문서만 참고했으면 출처 줄을 붙이지 않습니다.
- 공지·행사를 여러 개 참고했으면 한 줄에 하나씩 모두 적습니다.
- 줄 앞에 `>`나 `-`를 붙이지 않습니다.

4. 학사 정보(수강신청 날짜, 장학금 금액, 학사일정 등)는 직접 단정하지 않습니다.
관련 공지가 있으면 제목과 링크만 안내하고, 정확한 내용은 원문에서 확인하도록 합니다.
Expand Down
8 changes: 6 additions & 2 deletions sync.py
Original file line number Diff line number Diff line change
Expand Up @@ -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 합의).
"""

Expand Down Expand Up @@ -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:
Expand All @@ -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:
Expand Down