Files
group_fqcd_jr/app/core/nl2sql_contracts.py
T
张胜宇 e239eb778b docs: 品牌全量口径统一为「南方基金」+ 作废文档清理
1) 客服 Agent 四份交付文档 + 构建脚手架:品牌由包装占位 XX科技 / 旧名 南方财富
   统一为南方基金(热线 400-889-8899 / 官网 nffund.com),系统名改为「智能服务系统」;
   同步追加 §0.4 修订记录行,工程记录行保留原占位字面以支撑硬编码扫描验收。
2) 开发文档:清理 28 份已作废/残留文档(14 份移出归档 + 14 份仓库副本),
   新增《文档规整方案与开发前待决事项-2026-09-17》。
3) 客服agent 四份交付文档首次纳入本分支。
2026-09-17 15:15:22 +08:00

54 lines
1.7 KiB
Python

from typing import Any
from pydantic import BaseModel, ConfigDict, Field, field_validator
class FinancialNL2SQLInput(BaseModel):
"""金融 NL2SQL 公共工具入参;身份和权限只信任 RequestContext。"""
model_config = ConfigDict(extra="forbid", frozen=True)
question: str = Field(min_length=1, max_length=500)
confirmation: str | None = Field(default=None, max_length=200)
dry_run: bool = False
limit: int = Field(default=50, ge=1, le=200)
@field_validator("question")
@classmethod
def question_must_not_be_blank(cls, value: str) -> str:
if not value.strip():
raise ValueError("question must not be blank")
return value.strip()
class FinancialQueryPlan(BaseModel):
model_config = ConfigDict(extra="forbid", frozen=True)
intent: str
domains: tuple[str, ...]
tables: tuple[str, ...]
metrics: tuple[str, ...] = ()
dimensions: tuple[str, ...] = ()
filters: tuple[dict[str, Any], ...] = ()
time_mode: str = "none"
time_column: str | None = None
start: str | None = None
end: str | None = None
limit: int = Field(default=50, ge=1, le=200)
confidence: float = Field(default=0.0, ge=0, le=1)
needs_confirmation: bool = False
confirmation_question: str | None = None
unsupported_reason: str | None = None
class FinancialNL2SQLResult(BaseModel):
model_config = ConfigDict(extra="forbid", frozen=True)
status: str
message: str
data: dict[str, Any] = Field(default_factory=dict)
query_plan: dict[str, Any] = Field(default_factory=dict)
sql: str | None = None
parameters: dict[str, Any] = Field(default_factory=dict)
audit: dict[str, Any] = Field(default_factory=dict)