feat: refine embedding parameter layout and guidance

Author: ulleo

frontend/src/i18n/en.json

@@ -69,6 +69,20 @@
     "return_to_view": "Return to View"
   },
   "parameter": {
+    "embedding_scope_hint": "These settings apply to all workspaces and take effect for new questions and background tasks after saving.",
+    "embedding_backfill_hint": "Enabling generates and uses vectors, with missing or stale vectors filled in the background. Disabling stops new generation; tasks already started may finish.",
+    "terminology": "Terminology",
+    "sql_example": "SQL examples",
+    "knowledge_type": "Knowledge type",
+    "similarity_threshold": "Similarity threshold",
+    "vector_candidates": "Vector candidates",
+    "similarity_hint": "Range: 0–1. Higher values require closer matches.",
+    "terminology_count_hint": "Candidates per keyword vector search. Combining multiple keywords and text matches may exceed this count.",
+    "sql_example_count_hint": "Candidates per vector search. Combining text matches may exceed this count.",
+    "table_count_hint": "Candidates retained by vector filtering. Explicitly mentioned tables and related tables may increase the final count.",
+    "datasource_count_hint": "Datasource candidates retained by vector filtering before automatic datasource selection.",
+    "table_alpha_hint": "Range: 0–1. Higher values favor vector matching; keyword weight is 1 minus this value. Used for hybrid scoring only when both table vector filtering and keyword extraction are enabled.",
+    "table_alpha_disabled_hint": "Enable keyword extraction to adjust the vector weight for hybrid matching.",
     "execution_details": "Execution Details",
     "overview": "Overview",
     "tokens_required": "Tokens Required",
@@ -99,19 +113,19 @@
     "default_login": "Default Login Method",
     "disable_initial_password": "Disable Initial Password",
     "hide_initial_password": "Hide Initial Password on Page",
-    "knowledge_enabled": "Knowledge vectors",
-    "knowledge_enabled_hint": "Controls vector generation and retrieval for terminology and SQL examples in all workspaces. Literal matching remains available when disabled. Reenabling fills missing or outdated vectors in the background; running tasks keep their original settings.",
-    "table_enabled": "Table and datasource vectors",
-    "table_enabled_hint": "Controls vector generation and candidate filtering across all workspaces. While disabled, metadata edits invalidate old vectors; enabling fills missing vectors in the background. Keyword extraction remains independent.",
+    "knowledge_enabled": "Vector matching",
+    "knowledge_enabled_hint": "Match additional terminology and SQL examples by semantic similarity. Text matching remains available when disabled.",
+    "table_enabled": "Vector filtering",
+    "table_enabled_hint": "Filter relevant tables and datasources for each question. When disabled, retain all accessible candidates.",
     "table_selection": "Table and datasource selection",
     "table_count": "Table candidates",
     "datasource_count": "Datasource candidates",
     "table_alpha": "Vector weight for table matching",
-    "keyword_enabled": "Extract keywords",
+    "keyword_enabled": "Keyword extraction",
     "table_candidates_hint": "Table candidate count is not a final table limit: explicitly mentioned tables and related tables are retained. Datasource count limits vector candidates before the model selects a datasource.",
     "table_weight_hint": "Vector weight ranges from 0 to 1; keyword weight is 1 minus this value.",
-    "keyword_enabled_hint": "Controls keyword extraction, terminology synonym expansion and hybrid table matching independently. Keywords still work when table vectors are disabled; previously saved keywords remain available for analysis.",
-    "knowledge_retrieval": "Knowledge retrieval",
+    "keyword_enabled_hint": "Extract keywords from questions for terminology and table matching. Works independently of the vector switches.",
+    "knowledge_retrieval": "Knowledge matching",
     "terminology_similarity": "Terminology similarity threshold",
     "terminology_top_count": "Terminology vector candidates per keyword",
     "data_training_similarity": "SQL example similarity threshold",

frontend/src/i18n/ko-KR.json

@@ -69,6 +69,20 @@
     "return_to_view": "화면으로 돌아가기"
   },
   "parameter": {
+    "embedding_scope_hint": "이 설정은 모든 워크스페이스에 적용되며, 저장 후 시작하는 질문과 백그라운드 작업부터 적용됩니다.",
+    "embedding_backfill_hint": "활성화하면 벡터를 생성하고 사용하며, 누락되거나 오래된 벡터는 백그라운드에서 보충합니다. 비활성화하면 새 벡터 생성을 중지하지만 이미 시작된 작업은 완료될 수 있습니다.",
+    "terminology": "용어",
+    "sql_example": "SQL 예제",
+    "knowledge_type": "지식 유형",
+    "similarity_threshold": "유사도 임계값",
+    "vector_candidates": "벡터 후보 수",
+    "similarity_hint": "범위: 0~1. 값이 높을수록 더 엄격하게 매칭합니다.",
+    "terminology_count_hint": "키워드별 벡터 검색 후보 수입니다. 여러 키워드와 텍스트 매칭을 합치면 최종 개수가 이 값을 초과할 수 있습니다.",
+    "sql_example_count_hint": "벡터 검색 후보 수입니다. 텍스트 매칭을 합치면 최종 개수가 이 값을 초과할 수 있습니다.",
+    "table_count_hint": "벡터 필터링으로 유지할 후보 수입니다. 명시적으로 언급된 테이블과 관계 보완 테이블로 인해 최종 개수가 늘어날 수 있습니다.",
+    "datasource_count_hint": "자동 데이터 소스 선택 전에 벡터 필터링으로 유지할 데이터 소스 후보 수입니다.",
+    "table_alpha_hint": "범위: 0~1. 값이 높을수록 벡터 매칭을 우선하며, 키워드 가중치는 1에서 이 값을 뺀 값입니다. 테이블 벡터 필터링과 키워드 추출이 모두 활성화된 경우에만 혼합 점수에 사용됩니다.",
+    "table_alpha_disabled_hint": "키워드 추출을 활성화하면 혼합 매칭의 벡터 가중치를 조정할 수 있습니다.",
     "execution_details": "실행 세부 정보",
     "overview": "개요",
     "tokens_required": "필요한 토큰 수",
@@ -99,19 +113,19 @@
     "default_login": "기본 로그인 방식",
     "disable_initial_password": "초기 비밀번호 비활성화",
     "hide_initial_password": "페이지에서 초기 비밀번호 숨기기",
-    "knowledge_enabled": "지식 벡터",
-    "knowledge_enabled_hint": "모든 작업 공간의 용어와 SQL 예제에 대한 벡터 생성 및 검색을 제어합니다. 비활성화해도 문자 일치는 유지됩니다. 다시 활성화하면 누락되거나 오래된 벡터를 백그라운드에서 보완하며, 실행 중인 작업은 기존 설정을 유지합니다.",
-    "table_enabled": "테이블 및 데이터 소스 벡터",
-    "table_enabled_hint": "모든 작업 공간의 벡터 생성과 후보 필터링을 제어합니다. 비활성화 중 메타데이터를 수정하면 기존 벡터가 무효화되며, 다시 활성화하면 백그라운드에서 보충합니다. 키워드 추출은 독립적으로 작동합니다.",
+    "knowledge_enabled": "벡터 매칭",
+    "knowledge_enabled_hint": "의미적 유사도로 용어와 SQL 예제를 추가 매칭합니다. 비활성화해도 텍스트 매칭은 유지됩니다.",
+    "table_enabled": "벡터 필터링",
+    "table_enabled_hint": "질문과 관련된 테이블과 데이터 소스를 선별합니다. 비활성화하면 접근 가능한 모든 후보를 유지합니다.",
     "table_selection": "테이블 및 데이터 소스 선택",
     "table_count": "테이블 후보 수",
     "datasource_count": "데이터 소스 후보 수",
     "table_alpha": "테이블 매칭 벡터 가중치",
     "keyword_enabled": "키워드 추출",
     "table_candidates_hint": "테이블 후보 수는 최종 테이블 수의 상한이 아닙니다. 명시적으로 언급된 테이블과 관계로 보완된 테이블은 유지됩니다. 데이터 소스 후보 수는 모델의 자동 선택 전 벡터 사전 필터링에 적용됩니다.",
     "table_weight_hint": "벡터 가중치는 0~1이며 키워드 가중치는 1에서 이 값을 뺀 값입니다.",
-    "keyword_enabled_hint": "키워드 추출, 용어 동의어 확장 및 테이블 혼합 매칭을 독립적으로 제어합니다. 테이블 벡터를 꺼도 키워드를 사용할 수 있으며 저장된 과거 키워드는 분석에 계속 사용됩니다.",
-    "knowledge_retrieval": "지식 검색",
+    "keyword_enabled_hint": "질문에서 키워드를 추출하여 용어와 테이블 매칭에 사용합니다. 벡터 설정과 독립적으로 작동합니다.",
+    "knowledge_retrieval": "지식 매칭",
     "terminology_similarity": "용어 유사도 임계값",
     "terminology_top_count": "키워드별 용어 벡터 후보 수",
     "data_training_similarity": "SQL 예제 유사도 임계값",

frontend/src/i18n/th-TH.json

@@ -69,6 +69,20 @@
     "return_to_view": "กลับไปดู"
   },
   "parameter": {
+    "embedding_scope_hint": "การตั้งค่าเหล่านี้ใช้กับทุกพื้นที่ทำงาน และมีผลกับคำถามและงานเบื้องหลังที่เริ่มใหม่หลังบันทึก",
+    "embedding_backfill_hint": "เมื่อเปิดจะสร้างและใช้เวกเตอร์ โดยเติมเวกเตอร์ที่ขาดหรือล้าสมัยในเบื้องหลัง เมื่อปิดจะหยุดการสร้างใหม่ แต่งานที่เริ่มแล้วสามารถทำจนเสร็จได้",
+    "terminology": "คำศัพท์",
+    "sql_example": "ตัวอย่าง SQL",
+    "knowledge_type": "ประเภทความรู้",
+    "similarity_threshold": "เกณฑ์ความคล้ายคลึง",
+    "vector_candidates": "จำนวนตัวเลือกเวกเตอร์",
+    "similarity_hint": "ช่วงค่า 0–1 ค่ายิ่งสูงยิ่งจับคู่เข้มงวด",
+    "terminology_count_hint": "จำนวนตัวเลือกต่อการค้นหาเวกเตอร์ของแต่ละคำสำคัญ เมื่อรวมหลายคำสำคัญและผลการจับคู่ข้อความ จำนวนสุดท้ายอาจเกินค่านี้",
+    "sql_example_count_hint": "จำนวนตัวเลือกต่อการค้นหาเวกเตอร์ เมื่อรวมผลการจับคู่ข้อความ จำนวนสุดท้ายอาจเกินค่านี้",
+    "table_count_hint": "จำนวนตัวเลือกที่เก็บจากการกรองเวกเตอร์ ตารางที่ระบุโดยตรงและตารางที่เชื่อมโยงอาจทำให้จำนวนสุดท้ายเพิ่มขึ้น",
+    "datasource_count_hint": "จำนวนแหล่งข้อมูลที่เก็บจากการกรองเวกเตอร์ก่อนเลือกแหล่งข้อมูลอัตโนมัติ",
+    "table_alpha_hint": "ช่วงค่า 0–1 ค่ายิ่งสูงยิ่งเน้นการจับคู่เวกเตอร์ น้ำหนักคำสำคัญเท่ากับ 1 ลบค่านี้ ใช้คำนวณคะแนนแบบผสมเมื่อเปิดทั้งการกรองเวกเตอร์ตารางและการดึงคำสำคัญเท่านั้น",
+    "table_alpha_disabled_hint": "เปิดการดึงคำสำคัญเพื่อปรับน้ำหนักเวกเตอร์ในการจับคู่แบบผสม",
     "execution_details": "รายละเอียดการทำงาน",
     "overview": "ภาพรวม",
     "tokens_required": "Tokens ที่ใช้",
@@ -99,19 +113,19 @@
     "default_login": "วิธีเข้าสู่ระบบเริ่มต้น",
     "disable_initial_password": "ปิดใช้งานรหัสผ่านเริ่มต้น",
     "hide_initial_password": "ซ่อนรหัสผ่านเริ่มต้นบนหน้าเว็บ",
-    "knowledge_enabled": "เวกเตอร์ความรู้",
-    "knowledge_enabled_hint": "ควบคุมการสร้างและค้นหาเวกเตอร์ของคำศัพท์และตัวอย่าง SQL ในทุกพื้นที่ทำงาน เมื่อปิดยังคงจับคู่ข้อความได้ เมื่อเปิดอีกครั้ง ระบบจะเติมเวกเตอร์ที่ขาดหายหรือล้าสมัยในเบื้องหลัง งานที่เริ่มแล้วจะใช้การตั้งค่าเดิม",
-    "table_enabled": "เวกเตอร์ตารางและแหล่งข้อมูล",
-    "table_enabled_hint": "ควบคุมการสร้างเวกเตอร์และการกรองตัวเลือกในทุกพื้นที่ทำงาน การแก้ไขเมทาดาทาขณะปิดใช้งานจะทำให้เวกเตอร์เดิมใช้ไม่ได้ เมื่อเปิดอีกครั้ง ระบบจะเติมเวกเตอร์ในเบื้องหลัง การดึงคำสำคัญทำงานอย่างอิสระ。",
+    "knowledge_enabled": "การจับคู่เวกเตอร์",
+    "knowledge_enabled_hint": "จับคู่คำศัพท์และตัวอย่าง SQL เพิ่มเติมด้วยความคล้ายคลึงเชิงความหมาย เมื่อปิดยังคงจับคู่ข้อความได้",
+    "table_enabled": "การกรองเวกเตอร์",
+    "table_enabled_hint": "กรองตารางและแหล่งข้อมูลที่เกี่ยวข้องกับคำถาม เมื่อปิดจะเก็บตัวเลือกทั้งหมดที่เข้าถึงได้",
     "table_selection": "การเลือกตารางและแหล่งข้อมูล",
     "table_count": "จำนวนตารางที่เป็นตัวเลือก",
     "datasource_count": "จำนวนแหล่งข้อมูลที่เป็นตัวเลือก",
     "table_alpha": "น้ำหนักเวกเตอร์ในการจับคู่ตาราง",
-    "keyword_enabled": "ดึงคำสำคัญ",
+    "keyword_enabled": "การดึงคำสำคัญ",
     "table_candidates_hint": "จำนวนตารางที่เป็นตัวเลือกไม่ใช่ขีดจำกัดจำนวนตารางสุดท้าย ตารางที่ระบุชัดเจนและตารางที่เพิ่มจากความสัมพันธ์จะยังคงอยู่ จำนวนแหล่งข้อมูลใช้กรองด้วยเวกเตอร์ก่อนให้โมเดลเลือกโดยอัตโนมัติ",
     "table_weight_hint": "น้ำหนักเวกเตอร์มีค่าตั้งแต่ 0 ถึง 1 และน้ำหนักคำสำคัญเท่ากับ 1 ลบค่านี้",
-    "keyword_enabled_hint": "ควบคุมการดึงคำสำคัญ การขยายคำพ้องของคำศัพท์ และการจับคู่ตารางแบบผสมอย่างอิสระ คำสำคัญยังใช้ได้เมื่อปิดเวกเตอร์ตาราง และคำสำคัญที่บันทึกไว้ยังใช้ในการวิเคราะห์ได้",
-    "knowledge_retrieval": "การค้นคืนความรู้",
+    "keyword_enabled_hint": "ดึงคำสำคัญจากคำถามเพื่อจับคู่คำศัพท์และตาราง ทำงานแยกจากสวิตช์เวกเตอร์",
+    "knowledge_retrieval": "การจับคู่ความรู้",
     "terminology_similarity": "เกณฑ์ความคล้ายคลึงของคำศัพท์",
     "terminology_top_count": "จำนวนคำศัพท์เวกเตอร์ต่อคำสำคัญ",
     "data_training_similarity": "เกณฑ์ความคล้ายคลึงของตัวอย่าง SQL",