Agent/examples/auto_put_ad_mini/.env.example

# 兼容本地开发的组件级样例。生产部署统一以仓库根目录 runtime.env.example 为准。
# 不要在两个组件样例中分别维护生产配置。

# ========================================
# 腾讯广告 API 配置
# ========================================
TENCENT_AD_ACCOUNT_ID=80769799

# Access Token（应用级认证）
# TENCENT_AD_ACCESS_TOKEN=xxx        # 可选，优先使用 Token API 动态获取

# User Token（用户级实名认证令牌）
# ⚠️ 重要：写操作（暂停广告/修改出价）必须配置 user_token
# 获取方式：https://docs.qq.com/doc/DSVdkdk1LQ1hOam5n
TENCENT_AD_USER_TOKEN=xxx
# 可选,默认使用内部接口按 accountId 动态获取最新 user_token
# TENCENT_AD_USER_TOKEN_API=https://api.piaoquantv.com/ad/put/tencent/getUserToken

# TENCENT_AD_BASE_URL=https://api.e.qq.com/v3.0

# 统一生产服务
DAILY_CREATION_ENABLED=0
DAILY_CREATION_HOUR=10
DAILY_CREATION_MINUTE=30
DAILY_REVIEW_ENABLED=0
DAILY_REVIEW_INTERVAL_HOURS=2
DAILY_RUN_ON_STARTUP=0
DAILY_REVIEW_RUN_ON_STARTUP=0
DAILY_SYNC_DELIVERY_TEMPLATE=0

# 日级 ROI 北极星指标与表格逐行审批。默认关闭,分阶段启用。
DAILY_ROI_ENABLED=0
DAILY_ROI_HOUR=9
DAILY_ROI_MINUTE=0
DAILY_ROI_POLL_INTERVAL_MINUTES=30
DAILY_ROI_POLL_CUTOFF_HOUR=18
DAILY_ROI_POLL_CUTOFF_MINUTE=0
DAILY_ROI_RUN_ON_STARTUP=0
# 每天15:30运行独立内部测试，只将“自动化投放”分表发送到“内部”Webhook，不进入腾讯审批执行。
ROI_INTERNAL_TEST_ENABLED=0
ROI_INTERNAL_TEST_HOUR=15
ROI_INTERNAL_TEST_MINUTE=30
# 生产默认去重；测试环境显式设0时每次触发使用独立测试批次。
ROI_INTERNAL_TEST_DEDUP_ENABLED=1
ROI_APPLY_ENABLED=0
ROI_SHEET_APPROVAL_ENABLED=0
ROI_SHEET_APPROVAL_POLL_SECONDS=60
ROI_APPROVAL_TTL_MINUTES=120
# 合格小程序创意三日ROI前20%且广告age>=3时生成扩量建议。
ROI_SCALE_RATIO=1.10
ROI_SCALE_COOLDOWN_DAYS=3
ROI_MAX_BASE_RATIO=2.00
# 小程序使用T-1实际成本5%软预算；公众号即转保留独立实体等权P20。
ROI_SELF_STOP_MIN_AGE=4
ROI_SELF_STOP_COST_SOFT_LOWER_RATIO=0.045
ROI_SELF_STOP_COST_TARGET_RATIO=0.05
ROI_SELF_STOP_COST_SOFT_UPPER_RATIO=0.055
ROI_SELF_STOP_COST_HARD_CAP_RATIO=0.06
ROI_SELF_STOP_THREE_DAY_SHARE=0.60
ROI_SELF_STOP_ONE_DAY_SHARE=0.40
ROI_PARTNER_STOP_QUANTILE=0.20
ROI_UP_QUANTILE=0.80
ROI_OBSERVE_MIN_LATEST_UV=200
# 严格排除三日正式样本；剩余创意需同时满足UV>200、ROI<=0.20和实体等权P10。
ROI_ONE_DAY_MIN_UV=200
ROI_ONE_DAY_HARD_STOP_ROI=0.20
ROI_ONE_DAY_STOP_QUANTILE=0.10
ROI_FISSION_PARAMETER_VERSION=20260712_A0-A15_v2
# ROI报表发送到此群；同时抄送 FEISHU_OPERATOR_CHAT_ID，重复ID自动去重。
# 审批表链接为获得链接者可编辑，黄色审批列选择“批准”即自动执行。
# 为空时依次复用 FEISHU_AD_PROJECT_CHAT_ID / RTC_COMMAND_CHAT_ID
ROI_FEISHU_CHAT_ID=
# 日级ROI定时任务失败告警群；为空时回退FEISHU_OPERATOR_CHAT_ID。
ROI_FAILURE_FEISHU_CHAT_ID=
# 代理表由飞书应用上传后，通过各代理自定义机器人发送在线表卡片。
# 默认关闭；JSON 的 key 使用代理简称（如“棱镜”），“内部”为内部测试专用路由。
ROI_AGENCY_WEBHOOK_ENABLED=0
ROI_AGENCY_WEBHOOKS_JSON={}

RTC_START_HOUR=12
RTC_STOP_HOUR=21
RTC_POLL_SECONDS=600
RTC_HIGH_CPM=250
RTC_LOW_CPM=190
RTC_BID_UP_RATIO=1.05
RTC_MAX_PARTITION_LAG_HOURS=2
RTC_APPLY_ENABLED=0
RTC_COMMAND_ENABLED=1
RTC_COMMAND_CHAT_ID=
RTC_COMMAND_ALLOWED_OPEN_IDS=
RTC_COMMAND_CONFIRM_TTL_MINUTES=10
RTC_COMMAND_WORKERS=2
RTC_COMMAND_NEXT_DELIVERY_HOUR=6
RTC_COMMAND_DRAFT_TTL_MINUTES=5
RTC_NL_COMMAND_ENABLED=0
RTC_COMMAND_LLM_MODEL=google/gemini-3-flash-preview
RTC_COMMAND_LLM_TIMEOUT_SECONDS=20
RTC_COMMAND_LLM_CONFIDENCE_THRESHOLD=0.85
OPEN_ROUTER_API_KEY=

# ========================================
# 飞书 IM 审批配置
# ========================================
FEISHU_APP_ID=cli_xxx
FEISHU_APP_SECRET=xxx

# 运营审批群聊（需要审批回复的群）
FEISHU_OPERATOR_OPEN_ID=ou_498988d823b61ab89c9afe4310f85bb4
FEISHU_OPERATOR_CHAT_ID=oc_88e0a1970a7de02eb5ac225a8b0cedea
# 广告审批、创意审批和创建执行汇报专用群；为空时回退运营审批群。
FEISHU_CREATION_CHAT_ID=

# 投放项目群聊（仅通知，不需审批）— 可选配置
# 如何获取群聊ID：运行 python3 get_chat_id.py
# FEISHU_AD_PROJECT_CHAT_ID=oc_xxxxxxxxxxxxxxxxxxxxxx

# ========================================
# ODPS 数据平台配置
# ========================================
# ODPS_ACCESS_ID=xxx
# ODPS_ACCESS_SECRET=xxx
# ODPS_PROJECT=loghubods

# ========================================
# LLM API Key
# ========================================
# QWEN_API_KEY=xxx
# OPEN_ROUTER_API_KEY=xxx
# AI 图片生成模型。当前默认使用 OpenRouter Images API 可用的 pro 图片模型。
# OPENROUTER_IMAGE_MODEL=google/gemini-3-pro-image

# 外部素材召回账户专用。飞书「素材来源」填“外部素材”或“外部素材召回”时生效。
EXTERNAL_RECALL_SOURCE_LABEL=外部合作
EXTERNAL_RECALL_CANDIDATE_LIMIT=300
EXTERNAL_RECALL_EDIT_LIMIT_PER_LANDING=3
EXTERNAL_RECALL_UV_WINDOW_DAYS=90
# 默认复用 OPENROUTER_IMAGE_MODEL；可单独指定支持 input_references 的图片模型。
# EXTERNAL_IMAGE_MODEL=google/gemini-3.1-flash-image

# ========================================
# 数据库配置（MySQL）
# ========================================
DB_HOST=localhost
DB_PORT=3306
DB_USER=ad_rw
DB_PASSWORD=your_password
DB_NAME=auto_put_ad_mini

# ========================================
# 生产环境配置（海外部署）
# ========================================

# 白名单账户（逗号分隔）
# 注意：优先从数据库读取，数据库不可用时降级到环境变量
WHITELIST_ENABLED=true
WHITELIST_ACCOUNTS=80769799,71305011

# 代理配置（海外访问腾讯 API）
# HTTP_PROXY=http://proxy-server:port
# HTTPS_PROXY=http://proxy-server:port

# 时区配置（默认 UTC，可选 Asia/Shanghai）
TZ=UTC

# 执行开关（生产环境谨慎开启）
# 注意：优先从数据库读取，数据库不可用时降级到环境变量
EXECUTION_ENABLED=false

# API 端点（可选覆盖）
# TENCENT_AD_BASE_URL=https://api.e.qq.com/v3.0

# APScheduler 定时调度（使用 server.py 时）
# CRON_SCHEDULE=0 2 * * *  # 每天凌晨2点UTC
# RUN_ON_STARTUP=false     # 启动时是否立即执行
# PORT=8080                # FastAPI 服务端口