用途:验证 Agent Framework 仓库中的 .NET 示例项目是否仍按预期工作,并核对实际输出与预期输出是否一致。
主要能力:读取示例代码,识别所需环境变量,检查变量是否已设置;若缺失则列出需设置的变量并终止;概述预期输出;运行示例并实时展示输出;将实际输出与预期对比;最后逐个报告结果。
使用方式:先确认示例仅依赖环境变量且无复杂启动要求。检查变量是否已设置,例如 echo $AZURE_OPENAI_ENDPOINT;缺失时提示用户设置,如 export AZURE_OPENAI_ENDPOINT="https://my-openai-instance.openai.azure.com/" 与 export AZURE_OPENAI_DEPLOYMENT_NAME="gpt-4o-mini"。运行通用模式为 cd dotnet/samples/<category>/<sample-dir> 后执行 dotnet run;多目标项目需指定框架,如 dotnet run --framework net10.0。
结果输出:匹配时输出“[Sample Name] Succeeded”;不匹配时输出“[Sample Name] Failed”,并附实际输出与预期输出及不匹配原因。
适用场景:需要回归验证 .NET 示例、确认环境变量配置正确、排查示例输出异常时。
限制:仅支持使用环境变量配置且无复杂启动要求的示例;多应用协同或需启动浏览器等场景不在支持范围。必须报告已运行与未运行的示例及原因。