Demo 技能用于演示 UltraRAG 风格的执行追踪,结合原生工作流与 YAML 管道。
用途 该技能主要用于演示和测试工作流执行追踪能力,包括 YAML 管道的编译与执行、循环控制、条件分支、记忆追踪以及带质量门控的 graphflow 运行时。
主要能力
- hello:简单演示命令,用于测试热重载。参数 name(字符串,可选),默认值为 "Guest"。
- echo:回显输入消息。参数 message(字符串,可选),默认值为 "Hello!"。
- test_yaml_pipeline:测试 YAML 管道的编译与执行,使用 omni.tracer。参数 pipeline_type(字符串,可选),可选值包括 simple(顺序管道:analyze → draft → finalize)、loop(带迭代循环的管道:analyze → evaluate → reflect)、branch(带条件分支的管道)、rag(带检索的完整 RAG 管道)。
- run_graphflow:执行打包的 graphflow 运行时,输出追踪与质量门控。参数包括 scenario(字符串,可选,值为 "simple" 或 "complex")、quality_threshold(字符串,可选,草稿/最终质量阈值)、quality_gate_novelty_threshold(字符串,可选,门控新颖性阈值)、quality_gate_coverage_threshold(字符串,可选,门控覆盖率阈值)、quality_gate_min_evidence_count(字符串,可选,最小证据数量)、quality_gate_require_tradeoff(字符串,可选,要求输出中包含权衡)、quality_gate_max_fail_streak(字符串,可选,强制草稿前的最大门控失败连续次数)。
- list_pipeline_examples:列出可用的 YAML 管道测试示例,返回可用的管道类型及其描述和使用说明。
YAML 管道示例 该演示技能在 pipelines/ 目录中包含以下 YAML 管道文件:
- simple.yaml:顺序管道,analyze → draft → finalize。
- loop.yaml:迭代反思,质量评估 + 循环。
- branch.yaml:条件路由,基于路由器的分支。
- rag.yaml:完整 RAG,检索 + 生成 + 评估。
YAML 管道结构示例: servers: generator: builtin
parameters: topic: "$topic"
pipeline:
- generator.analyze
- generator.draft
- generator.finalize
runtime: checkpointer: kind: memory tracer: callback_dispatch_mode: inline
UltraRAG 特性 该演示展示了以下特性:
- YAML 管道:声明式工作流定义。
- 循环控制:带 max_iterations 的迭代反思。
- 条件分支:基于路由器的路由。
- 记忆追踪:变量随历史保存。
- 丰富输出:彩色的逐步追踪。
使用方式 通过 omni skill run 命令调用,例如:
- 简单问候:omni skill run demo.hello --name "World"
- 回显测试:omni skill run demo.echo --message "Test message"
- 列出可用管道示例:omni skill run demo.list_pipeline_examples
- 测试 YAML 管道:omni skill run demo.test_yaml_pipeline --pipeline_type "simple"(或 "loop"、"branch"、"rag")
- 运行打包的 graphflow 运行时:omni skill run demo.run_graphflow --scenario "complex"
适用场景 适用于需要演示或测试 UltraRAG 风格执行追踪、YAML 管道定义与执行、循环与分支控制、记忆追踪以及质量门控的开发与调试场景。
限制 关于该技能的收费、价格、平台支持范围、具体效果等事实暂未提供。