用途:从 telerik/observability-skills 技能目录中复制一个已完成的 .NET 10 智能体模板项目,完成构建、三项冒烟测试与本地 UI 健康检查,并输出交接信息。不生成或定制源码,只复制选定资产并写入一个新项目文件夹。
主要能力:支持四个模板 ID——release-evidence-reviewer(Markdown 发布证据、上下文评审聊天)、docs-qa(Markdown 问答、本地词法 RAG)、operations-data-analyst(模拟 CSV、KPI 与仪表盘视图)、ticket-triage(JSON 收件箱与 Markdown 策略)。默认模板为 release-evidence-reviewer,默认目标目录为 ./<id>。
使用方式:需 .NET 10 SDK。读取技能目录中的 templates.json 获取 ID、项目文件名与三个冒烟用例 ID,然后运行:dotnet run --file <skill-directory>/scripts/copy-template.cs -- --template <id> --target <target>。--list 可打印目录而不创建项目。复制器只接受不存在的目标或真正的空目录。随后解析绝对路径并执行 dotnet build "<absolute-target>/<catalog-project>",再运行 dotnet run --project "<absolute-target>/<catalog-project>" -- --smoke,解析单行 SMOKE_REPORT=<json>,要求整体通过且恰好三个用例通过。启动 Web 应用使用 dotnet run --project "<absolute-target>/<catalog-project>" --no-build -- --urls http://127.0.0.1:0,读取实际监听端口后验证 /api/health 返回 HTTP 200 且 status=ready,以及 / 返回 HTTP 200。
配置与限制:应用输入包括 AzureOpenAI:Endpoint、AzureOpenAI:Deployment、可选 AzureOpenAI:ApiKey 与 Progress:Observability:ApiKey,缺失时只指出缺失键并参考 README 的 user-secrets 命令,不请求、检查或打印凭据值。不得读取父级 .env、不得运行 dotnet user-secrets list 或转储环境。模拟数据指内置业务夹具,冒烟用例与 UI 操作仍调用已配置的 Azure OpenAI。保留内置追踪设置,Progress:Observability:RecordInputs 与 RecordOutputs 默认 true。仅返回一个 Progress Observability Tracing 页面链接 https://observability.progress.com/observations,不构造逐 trace 深链。该工作流不独立验证后端 trace 摄取。仅在复制、构建、三项冒烟与 UI 健康全部通过后报告成功;失败时报告失败环节与最小安全重试。成功交接需附开发用途说明:user-secrets 以未加密 JSON 存储凭据,生产应通过部署密钥管理器注入环境变量;清理仅在测试后按请求执行,且 Progress.AgentBuilder.Mvp 为五个智能体共享。