Variants, rework and exact cases
Use the shared contract and
filters/units.
Choose the branch answering the question; do not run a variant overview before an exact-case or rework request.
Ordered traces
Common or slow variants
get_variants_with_metrics_v2 {S,filterOptions:F,itemsPerPage:5,itemsToSkip:0,metricToSortBy:"CaseCount",sortOrder:"Descending"}.
- Only if mean-case slowness still needs comparison, repeat with
metricToSortBy:"CaseDuration".
If the first complete result already answers it, stop. CaseDuration is a mean;
variant Duration is not its substitute.
Cases with repeated work
- Copy F, appending to
caseMetricConditionFilters:
{metric:"CaseReworkCount",comparisonOperator:"GreaterThan",values:[0],isInclusive:true}.
get_cases_with_metrics_v2 {S,filterOptions:Fplus,itemsPerPage:5,itemsToSkip:0,metricToSortBy:"ReworkCount",sortOrder:"Descending"}.
A native count suffices; no formula or saved metric is needed.
- Only for unresolved transition evidence:
get_edges_with_metrics_v2 {S,filterOptions:Fplus,itemsPerPage:10,itemsToSkip:0}.
No edge sort exists; mark incomplete evidence page-local.
A specific case
- Reuse details to identify the metadata-proven case-key attribute K and its type T.
Bind the exact user/returned value X, e.g. synthetic
"Demo-17".
- Append
{attributeName:K,dataType:T,attributeValues:[X],isInclusive:true} to F's
attributeValueFilters; call
get_cases_with_metrics_v2 {S,filterOptions:Fcase,itemsPerPage:5,itemsToSkip:0}.
- An optional same-cohort bottleneck/edge query can summarize activities/handoffs.
If no exposed key expresses the case, stop; do not scan all cases or invent
caseId.
Guardrails
Continue relevant pages or drilldowns until the question is answered or evidence cannot discriminate;
no fixed call/total-row quota or automatic repeated queries. Show at most five headline rows by default.
Use filterOptions, itemsPerPage and itemsToSkip, not filters, metrics, limit or offset.
No variantId filter exists. For a user-specified sequence use only discovered attribute values
and the advertised sequence-filter schema; do not reconstruct unavailable variant Values.
No event-timeline or conformance-check tool exists. Rework/variation alone proves neither
event order nor a conformance violation. Retain scope, versions, metric units and partial coverage.
Activity occurrence is not full payment, successful dismissal, business closure or compliance.
Check the business outcome definition and available attributes/measures; route missing measures
to derive-metric, never infer success from an event name.
Missing events or terminal-looking traces may be censored, ongoing, legitimately ended or
incompletely recorded. Do not choose without closure, recording and observation-coverage evidence.
Use the investigation method: distinguish observed
presence/counts from tested outcomes; mark an unresolved outcome inconclusive and retain
definition provenance, baseline/test filters, evidence references and the next discriminating check.
1---2name: analyze-variants3description: Use when investigating common or slow variants, repeated work, unusual paths, or a specific Process Mining case.4allowed-tools: Read, AskUserQuestion5metadata:6 source: https://skillmd.com/skills/microsoft/analyze-variants7---89# Variants, rework and exact cases1011Use the [shared contract](../../references/analysis-contract.md) and12[filters/units](../../references/filters-and-units.md).13Choose the branch answering the question; do not run a variant overview before an exact-case or rework request.1415## Ordered traces1617**Common or slow variants**18191. `get_variants_with_metrics_v2 {S,filterOptions:F,itemsPerPage:5,itemsToSkip:0,metricToSortBy:"CaseCount",sortOrder:"Descending"}`.202. Only if mean-case slowness still needs comparison, repeat with `metricToSortBy:"CaseDuration"`.21 If the first complete result already answers it, stop. `CaseDuration` is a mean;22 variant `Duration` is not its substitute.2324**Cases with repeated work**25261. Copy F, appending to `caseMetricConditionFilters`:27 `{metric:"CaseReworkCount",comparisonOperator:"GreaterThan",values:[0],isInclusive:true}`.282. `get_cases_with_metrics_v2 {S,filterOptions:Fplus,itemsPerPage:5,itemsToSkip:0,metricToSortBy:"ReworkCount",sortOrder:"Descending"}`.29 A native count suffices; no formula or saved metric is needed.303. Only for unresolved transition evidence:31 `get_edges_with_metrics_v2 {S,filterOptions:Fplus,itemsPerPage:10,itemsToSkip:0}`.32 No edge sort exists; mark incomplete evidence page-local.3334**A specific case**35361. Reuse details to identify the metadata-proven case-key attribute K and its type T.37 Bind the exact user/returned value X, e.g. synthetic `"Demo-17"`.382. Append `{attributeName:K,dataType:T,attributeValues:[X],isInclusive:true}` to F's39 `attributeValueFilters`; call40 `get_cases_with_metrics_v2 {S,filterOptions:Fcase,itemsPerPage:5,itemsToSkip:0}`.413. An optional same-cohort bottleneck/edge query can summarize activities/handoffs.42 If no exposed key expresses the case, stop; do not scan all cases or invent `caseId`.4344## Guardrails4546Continue relevant pages or drilldowns until the question is answered or evidence cannot discriminate;47no fixed call/total-row quota or automatic repeated queries. Show at most five headline rows by default.48Use `filterOptions`, `itemsPerPage` and `itemsToSkip`, not `filters`, `metrics`, `limit` or `offset`.49No `variantId` filter exists. For a user-specified sequence use only discovered attribute values50and the advertised sequence-filter schema; do not reconstruct unavailable variant `Values`.51No event-timeline or conformance-check tool exists. Rework/variation alone proves neither52event order nor a conformance violation. Retain scope, versions, metric units and partial coverage.5354Activity occurrence is not full payment, successful dismissal, business closure or compliance.55Check the business outcome definition and available attributes/measures; route missing measures56to derive-metric, never infer success from an event name.57Missing events or terminal-looking traces may be censored, ongoing, legitimately ended or58incompletely recorded. Do not choose without closure, recording and observation-coverage evidence.59Use the [investigation method](../../references/investigation-method.md): distinguish observed60presence/counts from tested outcomes; mark an unresolved outcome **inconclusive** and retain61definition provenance, baseline/test filters, evidence references and the next discriminating check.