Microsoft Copilot · Schema

Microsoft 365 Copilot Interaction

Schema representing an interaction between a user and Microsoft 365 Copilot, including prompts, responses, attachments, contexts, links, and mentions. Based on the microsoft.graph.aiInteraction resource type from the Microsoft Graph Copilot namespace.

AgentsAI AssistantArtificial IntelligenceChatbotCopilotExtensibilityGenerative AIMicrosoft 365Productivity

Properties

Name Type Description
id string The unique identifier for the interaction message.
appClass string The data source for Copilot data. Indicates which Microsoft 365 application hosted the interaction. Examples include IPM.SkypeTeams.Message.Copilot.Excel, IPM.SkypeTeams.Message.Copilot.Loop, IPM.Skyp
body object The body of the message, including the text content and its body type.
interactionType string Indicates whether the interaction is a user prompt or a Copilot response. userPrompt represents a user's input; aiResponse represents Copilot's reply.
conversationType string The type of the conversation. Common values include appchat (in-app Copilot interactions) and bizchat (Business Chat / Microsoft 365 Chat interactions).
requestId string The identifier that groups a user prompt with its corresponding Copilot response. Both the prompt and response in a single exchange share the same requestId.
sessionId string The thread ID or conversation identifier that maps to all Copilot sessions for the user. Groups all interactions within a single conversation session.
createdDateTime string The ISO 8601 date and time when the interaction was created.
etag string The timestamp of when the interaction was last modified. Used for concurrency control.
locale string The locale of the sender, in BCP 47 language tag format.
from object The user, application, or device that is associated with this interaction.
attachments array The collection of documents attached to the interaction, such as cards and images.
contexts array The identifiers that map to all contexts associated with the interaction, such as the file or application in which the interaction occurred.
links array The collection of links that appear in the interaction, including citation links and reference links.
mentions array The collection of entities that were mentioned in the interaction, including users, bots, and other entities.
View JSON Schema on GitHub