processConversationMetadata

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa los metadatos de una entrada de contenido que forma parte de una conversación, por ejemplo, un mensaje de chat y una interacción de IA.

Hereda de processContentMetadataBase.

Propiedades

Propiedad Tipo Descripción
accessedResources_v2 Colección resourceAccessDetail Indica los detalles sobre los recursos a los que acceden los agentes de IA, incluidos los identificadores, el tipo de acceso y el estado.
agentes Colección aiAgentInfo Indica la información sobre un agente de IA que participó en la preparación del mensaje.
contenido contentBase Representa el contenido real, ya sea como texto (textContent) o datos binarios (binaryContent). Opcional si los metadatos por sí solos son suficientes para la evaluación de directivas. No usar para actividades de contenido. Heredado de processContentMetadataBase.
correlationId Cadena Un identificador que se usa para agrupar varias entradas de contenido relacionadas (por ejemplo, diferentes partes del mismo archivo cargado, mensajes en una conversación). Heredado de processContentMetadataBase.
createdDateTime DateTimeOffset Necesario. Marca de tiempo de creación del contenido original (por ejemplo, hora de creación del archivo, hora de envío del mensaje). Heredado de processContentMetadataBase.
identificador Cadena Obligatorio. Un identificador único para esta entrada de contenido específica dentro del contexto de la aplicación de llamada o el plano de cumplimiento (por ejemplo, Id. de mensaje, ruta de acceso o URL de archivo). Heredado de processContentMetadataBase.
isTruncated Booleano Obligatorio. Indica si el contenido proporcionado se ha truncado de su forma original (por ejemplo, debido a límites de tamaño). Heredado de processContentMetadataBase.
length Int64 La longitud del contenido original en bytes. Heredado de processContentMetadataBase.
modifiedDateTime DateTimeOffset Necesario. Marca de tiempo de cuándo se modificó por última vez el contenido original. Para contenido efímero como mensajes, podría ser lo mismo que createdDateTime. Heredado de processContentMetadataBase.
name Cadena Obligatorio. Un nombre descriptivo para el contenido (por ejemplo, nombre de archivo, título de página web o mensaje de chat). Heredado de processContentMetadataBase.
parentMessageId Cadena Identificador del mensaje primario en una conversación encadenada, si procede.
complementos Colección aiInteractionPlugin Lista de plugins utilizados durante la generación de este mensaje (relevantes para las interacciones IA/bot).
número de secuencia Int64 Un número de secuencia que indica el orden en que se generó o se debe procesar el contenido, necesario cuando se usa correlationId . Heredado de processContentMetadataBase.
accessedResources (en desuso) Colección string Lista de recursos (por ejemplo, direcciones URL de archivos, direcciones URL de web) a los que se accede durante la generación de este mensaje (relevante para interacciones de bots). La propiedad accessedResources quedó en desuso y dejó de devolver datos el 20 de agosto de 2025. De ahora en adelante, use la propiedad accessedResources_v2 .
Categoría de contenido microsoft.graph.contentCategory El tipo de contenido. Los valores posibles son: none, ai, unknownFutureValue. El valor predeterminado es ai, que hace referencia al contenido generado por IA. Heredado de processContentMetadataBase.

Relaciones

Ninguna.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

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