tenantDataSecurityAndGovernance: processContent

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Verarbeiten Sie Inhalte aus einer Agent-Interaktion anhand der Mandantendatenschutzrichtlinien. Der geschützte Agent wird in protectedAppMetadata.applicationLocation identifiziert, und die anderen Parteien in der Interaktion werden in activityMetadata.participants identifiziert.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ✅ ✅ ❌

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Content.Process.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application Content.Process.All Nicht verfügbar.

Für diese Content.Process.All Berechtigung ist die Zustimmung des Administrators erforderlich.

HTTP-Anforderung

POST /security/dataSecurityAndGovernance/processContent

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.
If-None-Match Das von tenantProtectionScopeContainer: Compute zurückgegebene ETag. Optional. Verwenden Sie diesen Header, um zu bestimmen, ob sich der Status der zwischengespeicherten Richtlinie geändert hat.

Anforderungstext

Geben Sie im Anforderungstext ein JSON-Objekt mit dem folgenden Parameter an.

Parameter Typ Beschreibung
contentToProcess processContentRequest Der Inhalt und die Metadaten, die ausgewertet werden sollen. Erforderlich. Legen Sie für die Agent-Auswertung evaluationScope.type auf agent; geben Sie einen policyLocationAgent in protectedAppMetadata.applicationLocation an; und schließen Sie mindestens einen konkreten Teilnehmer in activityMetadata.participants ein.

Antwort

Bei erfolgreicher Ausführung gibt diese Aktion einen 200 OK Antwortcode und ein processContentResponse-Objekt im Antworttext zurück.

Antwortheader

Name Beschreibung
ETag Gibt den aktuellen Richtlinienstatus an. Wenn sich das ETag ändert und protectionScopeState ist modified, aktualisieren Sie die zwischengespeicherten Bereiche, indem Sie tenantProtectionScopeContainer: compute aufrufen.

Beispiele

Anforderung

Im folgenden Beispiel wird eine Eingabeaufforderung ausgewertet, bevor sie in einen geschützten Agent gelangt.

POST https://graph.microsoft.com/beta/security/dataSecurityAndGovernance/processContent
Authorization: Bearer {token}
Content-Type: application/json
If-None-Match: "8936456543210"

{
  "contentToProcess": {
    "contentEntries": [
      {
        "@odata.type": "microsoft.graph.processConversationMetadata",
        "identifier": "d01b09f7-b666-4ec9-9819-217a68ef1345",
        "name": "Human prompt",
        "content": {
          "@odata.type": "microsoft.graph.textContent",
          "data": "Summarize this confidential document."
        },
        "correlationId": "3691e553-9db2-4b7b-a84f-3d248d3c8335",
        "sequenceNumber": 1,
        "isTruncated": false,
        "createdDateTime": "2026-08-05T17:00:00Z",
        "modifiedDateTime": "2026-08-05T17:00:00Z"
      }
    ],
    "activityMetadata": {
      "activity": "uploadText",
      "participants": [
        {
          "@odata.type": "microsoft.graph.userParticipant",
          "value": "11111111-1111-1111-1111-111111111111"
        }
      ]
    },
    "integratedAppMetadata": {
      "name": "Agent365.Sydney",
      "version": "2026.8.5.1"
    },
    "deviceMetadata": {},
    "protectedAppMetadata": {
      "applicationLocation": {
        "@odata.type": "microsoft.graph.policyLocationAgent",
        "value": "22222222-2222-2222-2222-222222222222",
        "agentMetadata": {
          "agentAdministrativeUnitId": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
          "agentBlueprintId": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
          "agentCategory": "Agents.Foundry.MicrosoftAzure",
          "agentOwner": "owner@contoso.com",
          "agentPublisher": "Contoso",
          "altAgentIds": [
            "sydney-agent-22222222"
          ],
          "isEntraAgentId": true
        }
      }
    },
    "evaluationScope": {
      "type": "agent"
    }
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 200 OK
Content-Type: application/json
ETag: "8936456543210"

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.processContentResponse",
  "@odata.type": "#microsoft.graph.processContentResponse",
  "protectionScopeState": "notModified",
  "policyActions": [
    {
      "@odata.type": "#microsoft.graph.restrictAccessAction",
      "action": "restrictAccess",
      "restrictionAction": "block"
    }
  ],
  "processingErrors": []
}
  • Zuletzt aktualisiert um