Edit

Share via

processConversationMetadata

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents metadata for a content entry that is part of a conversation, for example, a chat message, and an AI interaction.

Properties

Property Type Description
accessedResources String collection List of resources (for example, file URLs, web URLs) accessed during the generation of this message (relevant for bot interactions).
content contentBase Represents the actual content, either as text (textContent) or binary data (binaryContent). Optional if metadata alone is sufficient for policy evaluation. Do not use for contentActivities Inherited from processContentMetadataBase.
correlationId String An GUID identifier used to group multiple related content entries (for example, different parts of the same file upload, messages in a conversation).
createdDateTime DateTimeOffset Required. Timestamp indicating when the original content was created (for example, file creation time, message sent time).
identifier String Required. A unique identifier for this specific content entry within the context of the calling application or enforcement plane (for example, message ID, file path/URL).
isTruncated Boolean Required. Indicates if the provided content has been truncated from its original form (for example, due to size limits).
length Int64 The length of the original content in bytes.
modifiedDateTime DateTimeOffset Required. Timestamp indicating when the original content was last modified. For ephemeral content like messages, this might be the same as createdDateTime.
name String Required. A descriptive name for the content (for example, file name, web page title, "Chat Message").
parentMessageId String Identifier of the parent message in a threaded conversation, if applicable.
plugins aiInteractionPlugin collection List of plugins used during the generation of this message (relevant for AI/bot interactions).
sequenceNumber Int64 A sequence number indicating the order in which content was generated or should be processed, required when correlationId is used.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.processConversationMetadata",
  "identifier": "String",
  "content": {
    "@odata.type": "microsoft.graph.contentBase"
  },
  "name": "String",
  "correlationId": "String",
  "sequenceNumber": "Integer",
  "length": "Integer",
  "isTruncated": "Boolean",
  "createdDateTime": "String (timestamp)",
  "modifiedDateTime": "String (timestamp)",
  "parentMessageId": "String",
  "accessedResources": [
    "String"
  ],
  "plugins": [
    {
      "@odata.type": "microsoft.graph.aiInteractionPlugin"
    }
  ]
}