qoderwake支持五种参数化运行方式：一、cli命令行传参；二、webhook事件体映射；三、restful api注入；四、控制台手动输入；五、git仓库动态加载配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望QoderWake数字员工在执行任务时能根据外部输入实时调整行为逻辑、目标对象或处理参数，则可能是由于当前工作流采用静态配置，缺乏运行时变量注入能力。以下是实现参数化运行的具体方式：
一、通过CLI命令行传入动态参数
Qoder CLI支持在workflow run与skill exec指令中直接注入键值对形式的运行时参数，所有参数将自动注入沙盒上下文并覆盖工作流模板中的占位符（如{{target_version}}），确保同一工作流可复用于不同环境。
1、执行qoder workflow run --name="log-impact-analysis" --param=target_service=payment-gateway-v4.1.0 --param=lookback_hours=72启动日志影响分析流程，指定服务版本与回溯窗口。
2、使用--param-file=params.yaml加载外部YAML参数文件，该文件需符合标准键值结构，支持嵌套字段如database.credentials.host。
3、在参数值中引用环境变量：--param=region=${AWS_DEFAULT_REGION}，要求终端已预设对应shell变量。
二、通过Webhook事件体携带结构化参数
当QoderWake通过Webhook接收外部系统事件时，原始请求体中的JSON字段可被自动映射为任务上下文变量，无需额外解析代码，所有字段名即为可用参数名，支持点号路径访问（如payload.order.id）。
1、在外部系统发起POST请求时，在JSON body中包含完整参数对象：{"event_type":"order.fulfillment.delayed","payload":{"order_id":"ORD-778291","delay_minutes":47,"warehouse_code":"WH-SH-03"}}。
2、在QoderWake工作流编辑器中，于任意处理节点的参数配置栏输入{{payload.order_id}}，系统将在运行时自动替换为实际值。
3、启用参数校验开关，在「集成中心→Webhook设置」中为该接收端配置必填字段列表，例如强制payload.order_id与payload.delay_minutes存在且为数值类型。
三、通过API调用注入运行时变量
QoderWake提供RESTful接口/qoder/v1/workflows/trigger，允许客户端以HTTP POST方式提交含variables字段的JSON载荷，适用于CI/CD流水线、监控告警平台等系统级集成场景，所有variables内容将作为只读上下文注入本次执行实例。
1、构造POST请求体，包含workflow_id与variables对象：{"workflow_id":"wf-root-cause-2026","variables":{"git_commit_hash":"a1b2c3d4","service_name":"inventory-api","env":"staging"}}。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、在请求头中添加Authorization: Bearer
3、发送请求后，响应体返回execution_id与status_url，可通过GET /qoder/v1/executions/{id}轮询获取参数注入状态及执行日志。
四、通过控制台手动输入运行参数
在QoderWake管理控制台中触发工作流时，系统会自动识别模板中定义的参数占位符并生成交互式表单，用户可在执行前人工填写或选择预设选项，所有输入值经前端校验后序列化为上下文变量，仅对本次执行生效。
1、进入「工作流中心」，找到已发布的“数据库慢查询优化”工作流，点击右侧「立即执行」按钮。
2、页面弹出参数填写面板，显示字段：目标数据库实例（下拉选择已接入的RDS ID）、最大扫描表数量（数字输入框，默认值5）、是否启用SQL重写（开关控件）。
3、完成填写后点击「确认执行」，系统将生成带唯一execution_id的任务实例，并将所填参数以key-value形式注入Session账本。
五、通过Git仓库动态加载参数配置
QoderWake支持从指定Git分支的特定路径自动拉取parameters.json或parameters.yaml文件，该文件内容在任务启动前被解析为全局上下文变量，适用于多环境统一管理（如dev/staging/prod共用同一工作流但参数分离）。
1、在GitHub仓库根目录下创建/config/parameters/文件夹，在其中按环境建立子目录：/config/parameters/prod/parameters.json。
2、在prod/parameters.json中定义：{"db_host":"rds-prod-aliyun.mysql.rds.aliyuncs.com","max_connections":200,"enable_audit_log":true}。
3、在工作流配置页的「参数源」模块中，启用「Git参数同步」，填写仓库URL、分支名（如main）、参数文件路径（/config/parameters/{{env}}/parameters.json），并绑定env变量来源（如Webhook payload.env字段）。
