qoderwake支持四种参数传入方式:自然语言嵌入(轻量临时)、cli显式传参(精确可审计)、配置文件预设(高频统一)、事件元数据注入(自动上下文)。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要为QoderWake的Skill指定运行时参数,让数字员工在执行任务时能准确理解约束条件、数据范围或输出格式——比如要求“只分析2026年6月之后的日志”,或“用Markdown表格返回结果”,这些都不能靠默认行为实现。
在自然语言指令中嵌入参数
这是最轻量、最贴近日常协作的方式,适合临时调用、快速验证或非结构化场景。
直接在提问中写明参数名与值,用中文冒号或英文等号分隔,例如:“用日志分析Skill查错误,时间范围:2026-06-01到2026-07-30,输出格式=markdown”。
QoderWake会自动识别常见参数关键词(如“时间范围”“输出格式”“阈值”“模板名”),并映射到Skill定义的input_schema字段;若参数名未注册,将被忽略且不报错。
注意:该方式【不校验参数合法性】,拼错参数名或传入非法值(如把“true”写成“True”)会导致Skill跳过该参数,按默认值执行。
通过CLI命令显式传参
当你需要确保参数精确注入、参与审计追踪或集成进CI/CD流程时,必须使用CLI命令行方式传参。
第一步:确认目标Skill已启用且支持参数输入,执行qoder skill show --name=log-analyzer查看其input_schema定义。
第二步:构造完整调用命令,所有参数必须加--前缀,且键名严格匹配schema中property名,例如:
qoder skill exec --use=log-analyzer --start-date=2026-06-01 --end-date=2026-07-30 --output-format=markdown
第三步:若参数值含空格或特殊字符(如JSON字符串),需用单引号包裹,例如:--filter='{"level":"ERROR","service":"auth"}'。
这一步操作起来很简单,直接把文件拖进去就行。
在Skills配置文件中预设参数
适用于固定业务路径下的高频调用,避免每次重复输入,也便于统一策略管控。
方法一:修改~/.qoder/skills/log-analyzer/config.yaml,在params节下声明默认值:
params:
start-date: "2026-06-01"
end-date: "2026-07-30"
output-format: markdown
方法二:在项目级Skill目录(如./.qoder/skills/order-validate/config.yaml)中覆盖参数,优先级高于用户级配置。
保存后,下次调用该Skill时,未显式传入的参数将自动取config.yaml中的值;若CLI同时传参,则CLI值覆盖配置文件值。
⚠️ 修改config.yaml后【必须重启QoderWake服务】才能使新参数生效,否则仍加载旧缓存。
通过事件元数据动态注入参数
当Skill由外部系统(如Prometheus告警、GitHub PR事件)触发时,参数应来自事件本身,而非人工填写。
第一步:在submit命令中使用--metadata参数传入结构化键值对,例如:
qoderwake submit --event-type=alert-response --target-context="prometheus:alert-id=ALERT-7892" --metadata='{"severity":"critical","affected_service":"payment-gateway"}'
第二步:确保Skill的input_schema中已声明severity和affected_service字段,并设置type: string及required: true。
第三步:在Skill执行逻辑中,通过context.metadata.severity读取该值——这是唯一能保证参数随事件上下文自动带入、且不被用户覆盖的路径。










