---
title: conversation
framework: appintents
role: symbol
role_heading: Instance Property
path: appintents/appschema/messagesentity/conversation
---

# conversation

An entity schema for a conversation.

## Declaration

```swift
var conversation: some AppSchemaEntity { get }
```

## Discussion

Discussion To make your app’s content available to Apple Intelligence, conform your AppEntity to a schema that describes your content to the system. If your app’s functionality aligns with the messages domain and its content matches the conversation schema, you can generate the properties and protocol conformance the schema requires for your app entity implementation with the @AppEntity( .messages.conversation) Swift macro. To make your app work with Siri, see Apple Intelligence and Siri AI. The following example shows an app entity that conforms to the conversation schema: @AppEntity(schema: .messages.conversation) struct ConversationEntity {     // MARK: Static

static let defaultQuery = ConversationEntityQuery()

// MARK: Properties

let id: <#Identifiable.ID#>

var recipients: [<#MessagePerson#>]     var displayName: String     var previewText: AttributedString     var conversationName: String?     var isRead: Bool     var attributes: Set<<#ConversationAttribute#>>     var dateLastActive: Date?

var displayRepresentation: DisplayRepresentation {         <#DisplayRepresentation#>     }

// MARK: Query

struct ConversationEntityQuery: EntityQuery {         func entities(for identifiers: [ConversationEntity.ID]) async throws -> [ConversationEntity] {             <#code#>         }     } } The schema supports the following system experiences: Siri Shortcuts For more information about the App Intents framework and the experiences it supports, see Getting started with the App Intents framework.

## See Also

### Content and parameter types

- [customAttachment](appintents/appschema/messagesentity/customattachment.md)
- [message](appintents/appschema/messagesentity/message.md)
- [messagePerson](appintents/appschema/messagesentity/messageperson.md)
- [AppSchema.MessagesEntity](appintents/appschema/messagesentity.md)