Summary
The Getting Started docs include an eval.yaml example that omits the required executor property. Running the example command fails with:
waza-test azd waza run -v
unknown engine type:
Affected docs
Problem details
The YAML snippet in the docs currently shows fields like name, description, skill, version, and config, but does not include executor.
Without executor, the runtime cannot determine the engine and returns unknown engine type:.
Expected behavior
The Getting Started example should include a valid executor value so the sample runs successfully as written.
Suggested fix
- Update the Step 6
eval.yaml sample to include the required executor property.
- Optionally add a short note that
executor is required and what values are supported.
- Verify the exact command in the guide (
waza-test azd waza run -v) succeeds after following the documented steps.
Repro steps
- Follow https://microsoft.github.io/waza/getting-started/.
- Use the
evals/code-explainer/eval.yaml snippet shown in Step 6.
- Run:
waza-test azd waza run -v
- Observe error:

Summary
The Getting Started docs include an
eval.yamlexample that omits the requiredexecutorproperty. Running the example command fails with:Affected docs
Problem details
The YAML snippet in the docs currently shows fields like
name,description,skill,version, andconfig, but does not includeexecutor.Without
executor, the runtime cannot determine the engine and returnsunknown engine type:.Expected behavior
The Getting Started example should include a valid
executorvalue so the sample runs successfully as written.Suggested fix
eval.yamlsample to include the requiredexecutorproperty.executoris required and what values are supported.waza-test azd waza run -v) succeeds after following the documented steps.Repro steps
evals/code-explainer/eval.yamlsnippet shown in Step 6.