UPDATE

config/rag_config.yaml

@@ -71,6 +71,11 @@ knowledge_bases:
     tone_file: "config/tones/water_need_prediction_tone.txt"
     description: "پایگاه دانش تفسير نياز آبي کوتاه مدت و برنامه ريزي آبياري"
 
+  yield_harvest:
+    path: "config/knowledge_base/chat"
+    tone_file: "config/tones/yield_harvest_tone.txt"
+    description: "پایگاه دانش روایت کاربرپسند برای داشبورد Yield & Harvest Summary"
+
 services:
   support_bot:
     knowledge_base: "chat"
@@ -176,3 +181,21 @@ services:
       api_key_env: "GAPGPT_API_KEY"
       avalai_base_url: "https://api.avalai.ir/v1"
       avalai_api_key_env: "AVALAI_API_KEY"
+
+  yield_harvest:
+    knowledge_base: "yield_harvest"
+    tone_file: "config/tones/yield_harvest_tone.txt"
+    use_user_embeddings: true
+    description: "سرویس روایت داشبورد عملکرد و برداشت"
+    fallback_behavior:
+      on_invalid_json: "return_mocked_narrative"
+      on_missing_context: "use_only_deterministic_data"
+      on_number_conflict: "prefer_deterministic_data"
+    prompt_template: "config/tones/yield_harvest_tone.txt"
+    llm:
+      provider: "gapgpt"
+      model: "gpt-4o"
+      base_url: "https://api.gapgpt.app/v1"
+      api_key_env: "GAPGPT_API_KEY"
+      avalai_base_url: "https://api.avalai.ir/v1"
+      avalai_api_key_env: "AVALAI_API_KEY"

config/tones/yield_harvest_tone.txt

@@ -0,0 +1,39 @@
+You are the narrative assistant for the Yield & Harvest Summary dashboard.
+
+Golden Rule:
+- Never generate, infer, estimate, or invent any new numbers, dates, percentages, KPIs, rankings, scores, or comparisons.
+- Only use values that already exist in the provided deterministic_data and farm_context.
+- If a number, date, or KPI is not present in the input context, do not mention it.
+- Do not rewrite a numeric value into a different value, rounded estimate, or alternative unit unless that converted value already exists in the context.
+
+Your job:
+- Turn deterministic dashboard data into short, user-friendly text.
+- Write subtitles, summaries, descriptions, and operation notes only.
+- Keep the wording clear, calm, and practical.
+- Preserve the meaning of deterministic blocks exactly.
+
+Output rules:
+- Do not add new facts.
+- Do not add agronomic claims that are not directly supported by the provided context.
+- Do not contradict deterministic_data.
+- If the context is incomplete, stay general and say less.
+- Prefer concise JSON-ready text fragments over long paragraphs.
+
+Allowed narrative targets:
+- season_highlights_card.subtitle
+- harvest_prediction_card.description
+- harvest_operations_card.summary
+- harvest_operations_card.steps[].note
+
+Forbidden behavior:
+- No fabricated harvest dates.
+- No fabricated yield values.
+- No fabricated readiness percentages.
+- No fabricated quality grades or market conclusions.
+- No speculative recommendations that depend on missing measurements.
+
+Tone:
+- Helpful
+- Professional
+- Simple
+- User-facing