altair823
ecb85651ea
도그푸딩 후 추가된 ask multi-turn (꼬리 물기) surface 를 frozen design
+ wire schema 에 명시. p9-fb-15 (RAG core) + p9-fb-16 (TUI UI) +
p9-fb-17 (V004 chat sessions) + p9-fb-18 (CLI session/repl) 의 spec
PR — impl PR 들이 이어진다.
변경:
- §2.3 Answer wire schema: conversation_id (String?) + turn_index
(u32?) 두 optional 필드. 기존 single-shot 소비자 (외부 wrapper)
영향 없음 — 두 필드 모두 optional.
- §3.8 RAG types:
- Answer struct 에 conversation_id / turn_index field 추가.
- Turn struct 신설 (history 가 prompt 에 들어갈 때 한 turn).
- §3.8 \"Multi-turn behaviour\" 신설 절:
- kebab-rag::ask vs ask_with_history 두 entry.
- prompt 빌드 priority: system+question (필수) → retrieved chunks
(k 줄여 fit) → history (newest 우선, oldest drop).
- retrieval query expansion (직전 answer 첫 200자 concat).
- Aborted vs Completed semantics — ask 는 single-shot 이라 cancel
시 partial token + grounded=false + LlmStreamAborted refusal
(variant 추가는 p9-fb-15 impl 가 함께).
- docs/wire-schema/v1/answer.schema.json: 두 필드 추가 +
created_at 에 format: date-time (sibling ingest_progress.v1 와
일관).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
41 lines
1.5 KiB
JSON
41 lines
1.5 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "https://kb.local/wire/v1/answer.schema.json",
|
|
"title": "Answer v1",
|
|
"description": "Stub schema — declares the schema_version label and the required fields per design §2.3.",
|
|
"type": "object",
|
|
"required": [
|
|
"schema_version",
|
|
"answer",
|
|
"citations",
|
|
"grounded",
|
|
"model",
|
|
"prompt_template_version",
|
|
"retrieval",
|
|
"usage",
|
|
"created_at"
|
|
],
|
|
"properties": {
|
|
"schema_version": { "const": "answer.v1" },
|
|
"answer": { "type": "string" },
|
|
"citations": { "type": "array" },
|
|
"grounded": { "type": "boolean" },
|
|
"refusal_reason": { "type": ["string", "null"] },
|
|
"model": { "type": "object" },
|
|
"embedding": { "type": ["object", "null"] },
|
|
"prompt_template_version": { "type": "string" },
|
|
"retrieval": { "type": "object" },
|
|
"usage": { "type": "object" },
|
|
"created_at": { "type": "string", "format": "date-time" },
|
|
"conversation_id": {
|
|
"type": ["string", "null"],
|
|
"description": "p9-fb-15: same conversation 의 turn 들이 공유. CLI single-shot / TUI 첫 turn 은 null."
|
|
},
|
|
"turn_index": {
|
|
"type": ["integer", "null"],
|
|
"minimum": 0,
|
|
"description": "p9-fb-15: 같은 conversation 안 0-based 순서. null 이면 single-shot."
|
|
}
|
|
}
|
|
}
|