vent_agent_2.0/.env.example

# deep_agent 2.0 环境变量样例
# 复制为 .env 后按需修改。所有变量均有代码内默认值（默认值 = 可跑的最小配置）。

# ============================================================
# 配置优先级
# ============================================================
# 本 .env 与「进程环境变量」冲突时谁生效：
#   dotenv （默认）本文件优先，防被污染的 shell 静默改掉项目配置
#   process        进程环境优先，用于跑变体实例（不同端口/库/方言）：
#                  DEEP_AGENT_ENV_PRIORITY=process DB_DIALECT=mysql PORT=8081 python main.py
#   none           完全忽略本文件，只认进程环境与代码默认值（测试/CI）
# 无论哪一档，冲突都会打 WARNING 并出现在 /health 的 config_conflicts
DEEP_AGENT_ENV_PRIORITY=dotenv

# ============================================================
# 模型（主 agent）
# ============================================================
# provider:model 形式；deepseek* 前缀会走 langchain-deepseek（若已安装），否则走 ChatOpenAI
DEEPAGENT_MODEL=deepseek-flash
OPENAI_BASE_URL=https://api.deepseek.com
OPENAI_API_KEY=sk-your-key-here
OPENAI_TIMEOUT=180

# 思考级别：off / high / highest（烧进模型实例，重启生效）
DEEPAGENT_THINKING=off

# ============================================================
# 服务
# ============================================================
HOST=0.0.0.0
PORT=8080
# INFO：启动、任务及请求汇总；DEBUG：含并发位、健康检查等细节
LOG_LEVEL=INFO
# text：本地阅读；json：每行一条结构化日志，适合采集
LOG_FORMAT=text

# ============================================================
# SQLite（会话历史 / 业务任务 / 计费 / 调度）
# ============================================================
DB_DIALECT=sqlite
DB_SQLITE_PATH=data/vent_agent.sqlite
# 旧 MySQL 部署可显式设 DB_DIALECT=mysql，以下配置在 SQLite 模式下不使用。
DB_HOST=127.0.0.1
DB_PORT=3306
DB_USER=root
DB_PASSWORD=
DB_NAME=vent_agent_v2
DB_PING_IDLE_SECONDS=60

# ============================================================
# 图状态（checkpoint）
# ============================================================
# sqlite：图状态与中断上下文落盘（默认）；memory：纯内存，重启即丢
CHECKPOINTER=sqlite
CHECKPOINT_DB_PATH=data/checkpoints.sqlite

# 网页智能体测试工作台；资料与执行记录使用本应用SQLite和独立测试会话。
TEST_LAB_ENABLED=1
TEST_LAB_DATA_DIR=data/test_lab
# 可选：内置PDF/图片/JSON样例所在目录；未配置时尝试同级陕西局代码/测试数据。
TEST_LAB_SAMPLE_DIR=

# ============================================================
# 上下文与压缩
# ============================================================
# 声明的上下文窗口（0 = 用模型登记值）。
# 这是压缩的唯一调节旋钮：框架在「声明窗口的 85%」处触发摘要压缩，
# 想更早压缩就把这里调小（例如真实窗口 128000、想 70% 触发 → 填 105000）。
CONTEXT_LIMIT=0
# 自动压缩开关。关掉会同时失去「淘汰历史自动落盘到 /conversation_history/」
# 的能力——长会话会硬撑到超窗报错，只在排查压缩相关问题时才关。
CTX_COMPACT_ENABLED=1
# 冷启动从会话历史补种的最近消息条数
CTX_RECENT_LIMIT=30

# ============================================================
# 人机协同（HITL）
# ============================================================
# 需要人工审批的工具（逗号分隔），会追加到默认的计划审批工具之上。
# 未注册的工具名会阻止启动，避免审批配置拼写错误被忽略。
# 例：HITL_TOOLS=calculate  → 每次计算都要用户点头，便于自测中断闭环
HITL_TOOLS=

# ============================================================
# 计费
# ============================================================
# 每用户每日 token 限额（0 = 不限）；预检 fail-closed
TFAGENTS_DAILY_TOKEN_LIMIT=0
# 模型未在 billing_pricing 表中定价时：0=直接报错（fail-closed，默认）
# 1=按 0 价计费并告警（仅本地开发用，会让用量数字失真）
BILLING_ALLOW_UNPRICED=0

# ============================================================
# 并发闸（超限直接 429，不排队）
# ============================================================
TFAGENTS_MAX_CONCURRENT_TASKS=10
TFAGENTS_MAX_USER_TASKS=2
TFAGENTS_TASK_WALL_TIMEOUT=1800

# 独立算法：单图/批量共享并行上限，批量等待名额；配置变更后重启。
ALGORITHM_MAX_PARALLEL=2
# 所有批次合计等待及执行中的图片上限
ALGORITHM_MAX_PENDING_IMAGES=100
ALGORITHM_RESULT_TTL_HOURS=24
ALGORITHM_JOB_DIR=data/algorithm_jobs

# ============================================================
# 鉴权
# ============================================================
# 2.0 骨架不做鉴权：user_name 由 /api/chat 的 multipart 字段自报，缺省 default。
# 此开关保留给后续接入真实鉴权时使用，当前无效。
AUTH_ENABLED=0

# ============================================================
# 观测
# ============================================================
TFA_TRACE_MIDDLEWARE=1

# 离线扩展示例：共享术语表服务 + 工具 + 上下文中间件，默认关闭
CONTEXT_DEMO_ENABLED=0

# ============================================================
# 多业务智能体；当前启用主通风机资料核验和初步筛查
# ============================================================
MAIN_FAN_ENABLED=1
MAIN_FAN_MAX_CONCURRENCY=1
BUSINESS_RECURSION_LIMIT=40
# Skill 自主探索预算；主通风机默认使用此模式
AGENT_EXPLORATION_RECURSION_LIMIT=480
# Python 执行器：macOS sandbox-exec；Linux 需安装 bubblewrap，不回退无沙箱执行
AGENT_PYTHON_MAX_SECONDS=120
# 地址空间限制仅 Linux；两平台均限制 CPU、执行时长、文件大小及输出长度
AGENT_PYTHON_MEMORY_MB=2048
AGENT_PYTHON_MAX_RUNS=40
# 业务任务提交、管理、记录查询的服务凭证；与对方网关凭证不同。
# 留空时这些 API 返回 503；网页聊天入口沿用现有身份机制。
BUSINESS_API_TOKEN=

# ============================================================
# 对方部署的陕西局取数网关（JSON 转发、文件下载鉴权）
# ============================================================
SHANXI_GATEWAY_ENABLED=0
SHANXI_GATEWAY_URL=
SHANXI_GATEWAY_TOKEN=
# 文件所属系统根地址及下载相对路径由对方提供；不能用网关地址代替。
SHANXI_FILE_BASE_URL=
SHANXI_HTTP_TIMEOUT=30
SHANXI_MAX_FILE_MB=50
# 对方给本业务的取数调用身份，与结果平台的 agentCode 分开。
MAIN_FAN_AGENT_CODE=
# 真实 JSON 接口路径由对方提供；响应通过 main_fan/data_source.py 显式适配。
MAIN_FAN_DEVICES_PATH=
MAIN_FAN_POINTS_PATH=
MAIN_FAN_REPORTS_PATH=
# 本地模拟分别使用 /mock-platform/main-fan/series 和 /mock-platform/main-fan/states。
MAIN_FAN_SERIES_PATH=
MAIN_FAN_SWITCHES_PATH=
MAIN_FAN_OPERATION_LOG_PATH=
MAIN_FAN_RULES_FILE=examples/main_fan/equivalence_rules.json
# 简短业务请求的身份目录；真实环境配置正式编码。模拟目录绑定本地网关，不能用于真实网关。
MAIN_FAN_TARGETS_FILE=
# 简短请求默认重新读取原件；完整结构化输入可显式指定缓存策略。
MAIN_FAN_DEFAULT_DOCUMENT_CACHE_POLICY=refresh
# 自动扫描件识别需要兼容当前模型服务的视觉模型，并配置该模型的计费单价。
# 当前 DeepSeek 官方 deepseek-flash 已支持图像；可复用主模型凭证。
MAIN_FAN_VISION_MODEL=
# 文本 PDF 的结构化模型，留空默认主模型；两种模型可分别指定其他兼容服务。
MAIN_FAN_TEXT_MODEL=
MAIN_FAN_VISION_BASE_URL=
MAIN_FAN_VISION_API_KEY=
MAIN_FAN_TEXT_BASE_URL=
MAIN_FAN_TEXT_API_KEY=
MAIN_FAN_MAX_DOCUMENT_PAGES=32
MAIN_FAN_DOCUMENT_TIMEOUT=180
MAIN_FAN_DOCUMENT_BATCH_PAGES=2
MAIN_FAN_DOCUMENT_MAX_TOKENS=20000
# 生产默认不使用人工转录缓存；旧离线演示才显式开启。
MAIN_FAN_ALLOW_MANUAL_CACHE=0
# 数据筛查窗口，不是工程安全阈值；采集时间按 Asia/Shanghai 解释。
MAIN_FAN_FRESHNESS_SECONDS=600
MAIN_FAN_SYNC_SECONDS=120

# ============================================================
# 独立的研判结果接收平台；不使用 SHANXI_GATEWAY_URL/TOKEN
# ============================================================
RESULT_PLATFORM_ENABLED=0
# 完整的 POST 接口地址。本地接收平台：http://127.0.0.1:8767/api/judgments
RESULT_PLATFORM_URL=
RESULT_PLATFORM_TOKEN=
# 默认 Authorization: Bearer <token>。自定义 API Key 可用 X-API-Key + scheme=none。
# 无鉴权接口显式设置 AUTH_HEADER=none；不向网关索取结果平台凭证。
RESULT_PLATFORM_AUTH_HEADER=Authorization
RESULT_PLATFORM_AUTH_SCHEME=Bearer
RESULT_PLATFORM_TIMEOUT=30
# 支持嵌套字段，如 data.code。HTTP 204 直接视为接收成功；其余成功响应必须匹配。
RESULT_PLATFORM_SUCCESS_FIELD=code
RESULT_PLATFORM_SUCCESS_VALUES=0,200
MAIN_FAN_RESULT_AGENT_CODE=main_fan_equivalence_agent
MAIN_FAN_RESULT_AGENT_NAME=矿井主通风机同等能力研判
# 启用结果平台后，网页/工具研判完成即入推送队列；设0则只生成结果。
# 任务 API 以每次请求的 publish 字段为准。
MAIN_FAN_AUTO_PUBLISH=1