AI Intents

AIIntentType classifies an action recognized by an AI provider. The host application must validate device state, permissions, and product support before performing the requested action.

Intent Reference

State and conversation

Fallback values and conversation-level actions.

6

.unknown

The provider returned an unrecognized intent.

-1

.none

No actionable intent was detected.

0

.dialogExit

Exit the active conversation.

command: dialog.exit

9

.roleSet

Switch the active AI role.

command: role.set

10

.voiceClone

Start a provider voice-cloning action.

command: voice.clone

12

.locationQuery

Request the user location through the host application.

command: location.query

23

Camera and recording

Photo, video, and recording intents.

6

.photoStart

Start taking a photo.

command: photo.start

1

.photoUnderstand

Analyze the content of a photo.

command: photo.understand

2

.audioRecording

Start audio recording.

command: recording.start

3

.videoStart

Start video recording.

command: video.start

4

.videoStop

Stop video recording.

command: video.stop

5

.callRecording

Start recording the active incoming call.

command: call.recording

20

Device and calling

Volume, power, battery, calling, and find-device actions.

9

.volumeUp

Increase the device volume.

command: volume.up

6

.volumeDown

Decrease the device volume.

command: volume.down

7

.volumeSet

Set the device volume.

command: volume.set

8

.devicePowerOff

Power off the device.

command: device.shutdown

11

.deviceBattery

Query the device battery level.

command: device.battery

17

.answerCall

Answer the incoming call.

command: call.answer

18

.declineCall

Decline the incoming call.

command: call.decline

19

.findPhone

Start finding the iPhone.

command: find.phone

21

.stopFindPhone

Stop finding the iPhone.

command: stop.phone

22

Music playback

Music playback and track navigation actions.

4

.musicPlay

Start or resume music playback.

command: music.play

13

.musicNext

Play the next track.

command: music.next

14

.musicPrev

Play the previous track.

command: music.prev

15

.musicStop

Stop music playback.

command: music.stop

16

Provider support varies. Treat the received AIIntentType as a request for the host app to validate and handle, not as proof that the action has already completed.