Environment Variables

环境变量参考 / Environment Variables

中英双语 | Bilingual

---

中文

将 .env.example 复制为 data_agent/.env 并根据需要修改。

必需变量

变量	说明	默认值	示例
POSTGRES_HOST	PostgreSQL 主机	db	localhost
POSTGRES_PORT	PostgreSQL 端口	5432	5432
POSTGRES_DATABASE	数据库名	gis_agent	gis_agent
POSTGRES_USER	数据库用户	agent_user	agent_user
POSTGRES_PASSWORD	数据库密码	(无)	your_strong_password
GOOGLE_GENAI_USE_VERTEXAI	是否使用 Vertex AI	TRUE	TRUE / FALSE
GOOGLE_CLOUD_PROJECT	GCP 项目 ID	(无)	my-project-id
GOOGLE_CLOUD_LOCATION	GCP 区域	global	us-central1
GOOGLE_API_KEY	Google AI API Key (替代 Vertex AI)	(无)	AIza...
GAODE_API_KEY	高德地图 API Key（地理编码/POI）	(无)	7e9...
CHAINLIT_AUTH_SECRET	JWT 认证密钥	(无)	用 chainlit create-secret 生成

可选变量

变量	说明	默认值
OAUTH_GOOGLE_CLIENT_ID	Google OAuth 客户端 ID	(禁用)
OAUTH_GOOGLE_CLIENT_SECRET	Google OAuth 密钥	(禁用)
HUAWEI_OBS_AK / SK / SERVER / BUCKET	华为 OBS 云存储	(禁用)
TIANDITU_TOKEN	天地图底图令牌	(禁用)
DYNAMIC_PLANNER	启用动态规划器	true
DAILY_ANALYSIS_LIMIT	每用户每日分析上限	0 (无限)
MONTHLY_TOKEN_LIMIT	每用户每月 Token 上限	0 (无限)
AUDIT_LOG_RETENTION_DAYS	审计日志保留天数	90
ARCPY_PYTHON_EXE	ArcPy Python 路径	(禁用)
REDIS_URL	Redis URL（实时流）	(内存回退)
LOG_LEVEL	日志级别	INFO
LOG_FORMAT	日志格式	text
MCP_TOOLBOX_URL	MCP Toolbox URL	(禁用)
WECOM_CORP_ID 等	企业微信机器人配置	(禁用)

---

English

Copy .env.example to data_agent/.env and customize.

Required Variables

Variable	Description	Default	Example
POSTGRES_HOST	PostgreSQL host	db	localhost
POSTGRES_PORT	PostgreSQL port	5432	5432
POSTGRES_DATABASE	Database name	gis_agent	gis_agent
POSTGRES_USER	Database user	agent_user	agent_user
POSTGRES_PASSWORD	Database password	(none)	your_strong_password
GOOGLE_GENAI_USE_VERTEXAI	Use Vertex AI	TRUE	TRUE / FALSE
GOOGLE_CLOUD_PROJECT	GCP project ID	(none)	my-project-id
GOOGLE_CLOUD_LOCATION	GCP region	global	us-central1
GOOGLE_API_KEY	Google AI API Key (alternative)	(none)	AIza...
GAODE_API_KEY	Gaode Maps API Key (geocoding)	(none)	7e9...
CHAINLIT_AUTH_SECRET	JWT auth secret	(none)	Generate with chainlit create-secret

Optional Variables

Variable	Description	Default
OAUTH_GOOGLE_CLIENT_ID	Google OAuth client ID	(disabled)
OAUTH_GOOGLE_CLIENT_SECRET	Google OAuth secret	(disabled)
HUAWEI_OBS_AK / SK / SERVER / BUCKET	Huawei OBS cloud storage	(disabled)
TIANDITU_TOKEN	Tianditu basemap token	(disabled)
DYNAMIC_PLANNER	Enable dynamic planner	true
DAILY_ANALYSIS_LIMIT	Max analyses per user/day	0 (unlimited)
MONTHLY_TOKEN_LIMIT	Max tokens per user/month	0 (unlimited)
AUDIT_LOG_RETENTION_DAYS	Audit log retention	90
ARCPY_PYTHON_EXE	ArcPy Python executable path	(disabled)
REDIS_URL	Redis URL for streaming	(in-memory fallback)
LOG_LEVEL	Logging level	INFO
LOG_FORMAT	Log format (text/json)	text
MCP_TOOLBOX_URL	MCP Toolbox URL	(disabled)
WECOM_*	WeCom (Enterprise WeChat) bot config	(disabled)