Microsoft Copilot · Schema

RetrievalHit

AgentsAI AssistantArtificial IntelligenceChatbotCopilotExtensibilityGenerative AIMicrosoft 365Productivity

Properties

Name Type Description
webUrl string The URL of the source document.
extracts array Collection of relevant text extracts from the document.
resourceType string The type of resource. Values include listItem (for SharePoint/OneDrive) and externalItem (for Copilot connectors).
resourceMetadata object Metadata fields for the resource, as requested via the resourceMetadata parameter. Keys and values depend on the requested fields.
sensitivityLabel object
View JSON Schema on GitHub

JSON Schema

microsoft-copilot-retrievalhit-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/RetrievalHit",
  "title": "RetrievalHit",
  "type": "object",
  "properties": {
    "webUrl": {
      "type": "string",
      "format": "uri",
      "description": "The URL of the source document.",
      "example": "https://www.example.com"
    },
    "extracts": {
      "type": "array",
      "description": "Collection of relevant text extracts from the document.",
      "items": {
        "$ref": "#/components/schemas/RetrievalExtract"
      },
      "example": []
    },
    "resourceType": {
      "type": "string",
      "description": "The type of resource. Values include listItem (for SharePoint/OneDrive) and externalItem (for Copilot connectors).",
      "enum": [
        "listItem",
        "externalItem"
      ],
      "example": "listItem"
    },
    "resourceMetadata": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Metadata fields for the resource, as requested via the resourceMetadata parameter. Keys and values depend on the requested fields.",
      "example": "example_value"
    },
    "sensitivityLabel": {
      "$ref": "#/components/schemas/SensitivityLabel"
    }
  }
}