import os from dataclasses import dataclass, field from pathlib import Path from dotenv import load_dotenv PROJECT_ROOT = Path(__file__).resolve().parent.parent load_dotenv(PROJECT_ROOT / ".env") @dataclass(frozen=True) class Settings: # LLM 配置 llm_api_key: str = field( default_factory=lambda: os.getenv("LLM_API_KEY", ""), repr=False, ) llm_model: str = field(default_factory=lambda: os.getenv("LLM_MODEL", "")) llm_base_url: str | None = field( default_factory=lambda: os.getenv("LLM_BASE_URL") or None ) # 统计 5000 多次调用:正常的都在 30 秒内(含上千 token 的长输出), # 卡住的请求会一直等到超时才重试,超时越长,卡一次多等越久 llm_timeout: float = field( default_factory=lambda: float(os.getenv("LLM_TIMEOUT", "30")) ) llm_max_retries: int = 2 # 推理 token 占了单次调用耗时的大头;步骤都很简单,不需要深想 llm_reasoning_effort: str | None = field( default_factory=lambda: os.getenv("LLM_REASONING_EFFORT", "low") or None ) # Jev typesafe_api_key: str = field( default_factory=lambda: os.getenv("TYPESAFE_API_KEY", ""), repr=False ) typesafe_model: str = field( default_factory=lambda: os.getenv("TYPESAFE_DEFAULT_MODEL") or "jev-latest" ) typesafe_base_url: str = field( default_factory=lambda: ( os.getenv("TYPESAFE_BASE_URL") or "https://api.typesafe.ai" ) ) typesafe_timeout: float = field( default_factory=lambda: float(os.getenv("TYPESAFE_TIMEOUT", "30")) ) typesafe_max_retries: int = field( default_factory=lambda: int(os.getenv("TYPESAFE_MAX_RETRIES", "2")) ) # 意图门控:Jev 选中 qa 且概率达到阈值才走问答,其余都交给 screen agent;阈值按真实语料校准 intent_qa_min_probability: float = field( default_factory=lambda: float(os.getenv("INTENT_QA_MIN_PROBABILITY", "0.5")) ) # screen agent 单次运行的模型调用上限,包括读取 skill、查询物料、提交修正和最终回复; # 用尽或没有给出结论时节点再收尾 1 次,所以一次请求最多 MAX_AGENT_STEPS + 1 次 max_agent_steps: int = field( default_factory=lambda: int(os.getenv("MAX_AGENT_STEPS", "12")) ) # 问答 agent 单次运行的模型调用上限;查询数据时每次查询多一次调用 max_qa_steps: int = field( default_factory=lambda: int(os.getenv("MAX_QA_STEPS", "8")) ) # 单次 MCP 工具调用的超时(秒),服务列表见 mcp_servers.json mcp_tool_timeout: float = field( default_factory=lambda: float(os.getenv("MCP_TOOL_TIMEOUT", "5")) ) # 没有任何对话的空会话保留时长(秒),超时后视为不存在 conversation_empty_ttl: int = field( default_factory=lambda: int(os.getenv("CONVERSATION_EMPTY_TTL", "7200")) ) # 每次请求从会话记录读取的最近轮数上限,实际带入多少由 history_max_tokens 决定 conversation_history_turns: int = field( default_factory=lambda: int(os.getenv("CONVERSATION_HISTORY_TURNS", "20")) ) # 每次请求带入的会话历史 token 预算(近似计数),从最近一轮往前保留完整的轮次 history_max_tokens: int = field( default_factory=lambda: int(os.getenv("HISTORY_MAX_TOKENS", "4096")) ) # MongoDB 连接串,未配置时会话记录和检查点回退为进程内存实现 mongodb_uri: str | None = field( default_factory=lambda: os.getenv("MONGODB_URI") or None, repr=False ) mongodb_db: str = field( default_factory=lambda: os.getenv("MONGODB_DB") or "screen_agent" ) # 检查点保留时长(秒),超时由 MongoDB TTL 索引清理,0 表示永久保留 mongodb_checkpoint_ttl: int = field( default_factory=lambda: int(os.getenv("MONGODB_CHECKPOINT_TTL", "604800")) ) # 上传的数据文件:原文件和解析出的 Parquet 放这个目录,相对路径相对项目根目录;容器部署时挂载出来 data_file_dir: Path = field( default_factory=lambda: ( PROJECT_ROOT / (os.getenv("DATA_FILE_DIR") or "data/files") ) ) # 单个数据文件的大小上限(MB) data_file_max_mb: int = field( default_factory=lambda: int(os.getenv("DATA_FILE_MAX_MB", "500")) ) # 数据文件保留时长(秒),从上传时算起,默认 7 天 data_file_ttl: int = field( default_factory=lambda: int(os.getenv("DATA_FILE_TTL", "604800")) ) # 上传后用 LLM 分析文件(一句话说明、图表推荐、列的含义);关闭后文件照常可用,只是没有这些信息 data_file_insights: bool = field( default_factory=lambda: ( os.getenv("DATA_FILE_INSIGHTS", "true").strip().lower() not in ("false", "0", "no", "off") ) ) # 大屏保存与发布:单次请求体上限(MB);图表绑定数据文件时数据快照嵌在页面里,一屏很容易上 MB screen_max_mb: int = field( default_factory=lambda: int(os.getenv("SCREEN_MAX_MB", "10")) ) # 回收站保留天数:软删的大屏超过这个时间由后台任务彻底删除(连同发布历史和封面) trash_retention_days: int = field( default_factory=lambda: int(os.getenv("TRASH_RETENTION_DAYS", "30")) ) # 大屏封面图存放目录,相对路径相对项目根目录;和数据文件一样放本地磁盘 thumbnail_dir: Path = field( default_factory=lambda: ( PROJECT_ROOT / (os.getenv("THUMBNAIL_DIR") or "data/thumbnails") ) ) # 模型写的单条数据查询的超时(秒) data_query_timeout: float = field( default_factory=lambda: float(os.getenv("DATA_QUERY_TIMEOUT", "10")) ) # apply_actions 里一个 $query 写进组件的最多行数,超过时报错,让模型在 SQL 里聚合 data_embed_max_rows: int = field( default_factory=lambda: int(os.getenv("DATA_EMBED_MAX_ROWS", "1000")) ) # 用户中心:请求携带的 token 交给它校验,换回 user_id user_center_url: str = field( default_factory=lambda: ( os.getenv("USER_CENTER_URL") or "http://127.0.0.1:8100" ).rstrip("/") ) user_center_timeout_seconds: float = field( default_factory=lambda: float(os.getenv("USER_CENTER_TIMEOUT_SECONDS", "5")) ) # 关闭后不校验 token,所有请求视为同一个本地调试用户,仅用于开发 auth_enabled: bool = field( default_factory=lambda: ( os.getenv("AUTH_ENABLED", "true").strip().lower() not in ("false", "0", "no", "off") ) ) # token 校验结果缓存时长(秒),登出或禁用后最多延迟这么久失效,0 表示不缓存 auth_cache_ttl_seconds: int = field( default_factory=lambda: int(os.getenv("AUTH_CACHE_TTL_SECONDS", "30")) ) def __post_init__(self): if self.user_center_timeout_seconds <= 0: raise ValueError("USER_CENTER_TIMEOUT_SECONDS 必须是正数") if self.auth_cache_ttl_seconds < 0: raise ValueError("AUTH_CACHE_TTL_SECONDS 必须是非负整数") if self.mongodb_checkpoint_ttl < 0: raise ValueError("MONGODB_CHECKPOINT_TTL 必须是非负整数") if self.conversation_empty_ttl <= 0: raise ValueError("CONVERSATION_EMPTY_TTL 必须是正整数") if self.conversation_history_turns < 0: raise ValueError("CONVERSATION_HISTORY_TURNS 必须是非负整数") if self.history_max_tokens < 1: raise ValueError("HISTORY_MAX_TOKENS 必须是正整数") if self.max_agent_steps < 1: raise ValueError("MAX_AGENT_STEPS 必须是正整数") if self.max_qa_steps < 1: raise ValueError("MAX_QA_STEPS 必须是正整数") if self.mcp_tool_timeout <= 0: raise ValueError("MCP_TOOL_TIMEOUT 必须是正数") if self.data_file_max_mb < 1: raise ValueError("DATA_FILE_MAX_MB 必须是正整数") if self.data_file_ttl < 1: raise ValueError("DATA_FILE_TTL 必须是正整数") if self.trash_retention_days < 1: raise ValueError("TRASH_RETENTION_DAYS 必须是正整数") if self.screen_max_mb < 1: raise ValueError("SCREEN_MAX_MB 必须是正整数") if self.data_query_timeout <= 0: raise ValueError("DATA_QUERY_TIMEOUT 必须是正数") if self.data_embed_max_rows < 1: raise ValueError("DATA_EMBED_MAX_ROWS 必须是正整数") if not 0 <= self.intent_qa_min_probability <= 1: raise ValueError("INTENT_QA_MIN_PROBABILITY 必须在 0 到 1 之间") settings = Settings()