---
title: Calls
framework: Siri Evaluations
role: symbol
role_heading: Structure
platforms: [iOS 27.3+, iPadOS 27.3+, macOS 27.3+, visionOS 27.3+]
path: sirievaluations/calls
---

# Calls

An expectation that Siri calls, or doesn’t call, a set of intents during a turn or scenario.

## Declaration

```swift
struct Calls
```

## Overview

Overview Use Calls to name the intents Siri calls during a turn or anywhere in a scenario. By default, the expectation requires Siri to call them in the order you list them. Pass Calls.Ordering.unordered to accept any order, or Calls.Ordering.disallowed to require that Siri doesn’t call them. The values Calls.Ordering.ordered and Calls.Ordering.unordered check only that Siri makes the calls you list. They don’t catch extra calls, such as Siri performing the wrong action. To catch an action Siri shouldn’t take, use Calls.Ordering.disallowed. The framework checks two Calls groups in the same turn independently, so Siri can call another intent before, between, or after them. To require one sequence, write one group. A call counts only if it runs. A call that Siri plans but doesn’t complete satisfies no Calls expectation. This includes a call that stops to ask the person for a missing value or for confirmation, and a call that fails. A Calls.Ordering.disallowed expectation fails if the call runs. It also fails if Siri asks the person to confirm the call, because Siri already chooses the action and its arguments. A clarifying question from Siri, such as which topic the person means, doesn’t count. Constrain an intent’s arguments with expect, using the parameter names as labels. The string matchers, such as .equals(_:) and .contains(_:), compare string values. To check a parameter of another type, such as an integer, use .matches(_:requirement:) with a predicate, as the following example shows: let quizExampleIntents = IntentDefinitions(bundleIdentifier: "com.example.QuizExample") let startQuizIntent = quizExampleIntents.intents["StartQuizIntent"]

Calls {     startQuizIntent         .expect(             topic: .equals("Science"),             questionCount: .matches(#Predicate<Int> { $0 == 5 })         ) } The following example shows a turn that expects Siri to create a reminder for a topic and not to start a quiz: let quizExampleIntents = IntentDefinitions(bundleIdentifier: "com.example.QuizExample") let startQuizIntent = quizExampleIntents.intents["StartQuizIntent"] let createQuizReminderIntent = quizExampleIntents.intents["CreateQuizReminderIntent"]

UserTurn("Use QuizExample to create a history quiz reminder for tomorrow at 7 p.m.") {     Calls {         createQuizReminderIntent             .expect(topic: .equals("History"))     }

// Fails if Siri runs or asks the person to confirm the intent.     Calls(.disallowed) {         startQuizIntent     } }

## Topics

### Creating a call expectation

- [init(_:_:)](sirievaluations/calls/init(_:_:).md)
- [IntentExpectationBuilder](sirievaluations/intentexpectationbuilder.md)

### Configuring call order

- [ordering](sirievaluations/calls/ordering-swift.property.md)
- [Calls.Ordering](sirievaluations/calls/ordering-swift.enum.md)

## Relationships

### Conforms To

- [Decodable](swift/decodable.md)
- [Encodable](swift/encodable.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### Expectations

- [Finds](sirievaluations/finds.md)
- [Loads](sirievaluations/loads.md)
- [OnScreen](sirievaluations/onscreen.md)
- [SiriResponse](sirievaluations/siriresponse.md)
