processConversationMetadata

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Representa metadados para uma entrada de conteúdo que faz parte de uma conversa, por exemplo, uma mensagem de chat e uma interação de IA.

Herda de processContentMetadataBase.

Propriedades

Propriedade	Tipo	Descrição
accessedResources_v2	Coleção resourceAccessDetail	Indica os detalhes sobre os recursos acessados por agentes de IA, incluindo identificadores, tipo de acesso e status.
agentes	Coleção aiAgentInfo	Indica as informações sobre um agente de IA que participou da preparação da mensagem.
conteúdo	contentBase	Representa o conteúdo real, seja como texto (textContent) ou dados binários (binaryContent). Opcional se os metadados por si só forem suficientes para a avaliação da política. Não use para contentActivities. Herdado de processContentMetadataBase.
correlationId	Cadeia de caracteres	Um identificador usado para agrupar várias entradas de conteúdo relacionado (por exemplo, partes diferentes do mesmo upload de arquivo, mensagens em uma conversa). Herdado de processContentMetadataBase.
createdDateTime	DateTimeOffset	Obrigatório. Carimbo de data/hora em que o conteúdo original foi criado (por exemplo, hora de criação do arquivo, hora de envio da mensagem). Herdado de processContentMetadataBase.
identificador	Cadeia de caracteres	Obrigatório. Um identificador exclusivo para essa entrada de conteúdo específica no contexto do aplicativo de chamada ou do plano de imposição (por exemplo, ID da mensagem, caminho/URL do arquivo). Herdado de processContentMetadataBase.
isTruncated	Booliano	Obrigatório. Indica se o conteúdo fornecido foi truncado de sua forma original (por exemplo, devido a limites de tamanho). Herdado de processContentMetadataBase.
Comprimento	Int64	O comprimento do conteúdo original, em bytes. Herdado de processContentMetadataBase.
modifiedDateTime	DateTimeOffset	Obrigatório. Carimbo de data/hora em que o conteúdo original foi modificado pela última vez. Para conteúdo efêmero, como mensagens, pode ser o mesmo que createdDateTime. Herdado de processContentMetadataBase.
nome	Cadeia de caracteres	Obrigatório. Um nome descritivo para o conteúdo (por exemplo, nome do arquivo, título da página da Web ou mensagem de chat). Herdado de processContentMetadataBase.
parentMessageId	Cadeia de caracteres	Identificador da mensagem pai em uma conversa encadeada, se aplicável.
plug-ins	Coleção aiInteractionPlugin	Lista de plug-ins usados durante a geração desta mensagem (relevante para interações de IA/bot).
número de sequência	Int64	Um número de sequência que indica a ordem em que o conteúdo foi gerado ou deve ser processado, necessário quando correlationId é usado. Herdado de processContentMetadataBase.
accessedResources (preterido)	String collection	Lista de recursos (por exemplo, URLs de arquivo, URLs da Web) acessados durante a geração desta mensagem (relevante para interações de bot). A propriedade accessedResources foi preterida e parou de retornar dados em 20 de agosto de 2025. No futuro, use a propriedade accessedResources_v2 .
contentCategory	microsoft.graph.contentCategory	O tipo de conteúdo. Os valores possíveis são: none, ai, unknownFutureValue. O valor padrão é ai, que se refere ao conteúdo gerado por IA. Herdado de processContentMetadataBase.

Relações

Nenhum

Representação JSON

A representação JSON a seguir mostra o 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"
}