SuperAPI AI 工具集

demo

智能体与模型

查看项目

更新于 10-16 06:05

技能介绍

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 管道定义与执行、循环与分支控制、记忆追踪以及质量门控的开发与调试场景。

限制 关于该技能的收费、价格、平台支持范围、具体效果等事实暂未提供。