---
title: "run(scenario:)"
framework: Siri Evaluations
role: symbol
role_heading: Type Method
platforms: [iOS 27.3+, iPadOS 27.3+, macOS 27.3+, visionOS 27.3+]
path: "sirievaluations/siriservice/run(scenario:)"
---

# run(scenario:)

Runs a scenario through Siri and returns what Siri did, for your evaluation to grade.

## Declaration

```swift
static func run(scenario: SiriScenario) async throws -> SiriScenarioSubject
```

## Discussion

Discussion Call it from your evaluation’s subject(from:), with any setup the scenario needs before it. If you clean up after it, record a failure instead of throwing: a subject(from:) that throws discards the run, so the scenario drops out of every average. It runs only in a UI test target. If the run stops partway, the turns that ran are graded and the report’s Diagnostics shows how many completed. If it can’t start, it throws.
