Teilen über

Migrieren von der Public Preview von Azure KI Inhaltssicherheit zur öffentlich verfügbaren Version

  • Artikel

Dieser Artikel zeigt Ihnen, wie Sie ein Upgrade für Ihren vorhandenen Code aus der öffentlichen Vorschauversion von Azure KI Inhaltssicherheit auf die allgemein verfügbare Version durchführen.

REST-API-Aufrufe

Achten Sie bei allen API-Aufrufen darauf, den Parameter api-version in Ihrem Code zu ändern:

old neu
api-version=2023-04-30-preview api-version=2023-10-01

Beachten Sie die folgenden Änderungen des REST-Endpunktnamens:

Benennung in der öffentlichen Vorschauversion Benennung in der allgemein verfügbaren Version
addBlockItems addOrUpdateBlocklistItems
blockItems blocklistItems
removeBlockItems removeBlocklistItems

JSON-Felder

Die folgenden JSON-Felder wurden umbenannt. Achten Sie darauf, diese zu ändern, wenn Sie Daten an einen REST-Aufruf senden:

Benennung in der öffentlichen Vorschauversion Benennung in der allgemein verfügbaren Version
blockItems blocklistItems
BlockItemId blocklistItemId
blockItemIds blocklistItemIds
blocklistMatchResults blocklistsMatch
breakByBlocklists haltOnBlocklistHit

Rückgabeformat

Einige JSON-Rückgabeformate wurden geändert. Sehen Sie sich die folgenden aktualisierten JSON-Rückgabebeispiele an.

Den API-Aufruf text:analyze mit einer Kategorieanalyse:

{
  "categoriesAnalysis": [
    {
      "category": "Hate",
      "severity": 2
    },
    {
      "category": "SelfHarm",
      "severity": 0
    },
    {
      "category": "Sexual",
      "severity": 0
    },
    {
      "category": "Violence",
      "severity": 0
    }
 ]
}

Den API-Aufruf text:analyze mit einer Blockliste:

{
  "blocklistsMatch": [
    {
      "blocklistName": "string",
      "blocklistItemId": "string",
      "blocklistItemText": "bleed"
    }
  ],
  "categoriesAnalysis": [
    {
      "category": "Hate",
      "severity": 0
    }
  ]
}

Den API-Aufruf addOrUpdateBlocklistItems:

{
  "blocklistItems:"[
    {
      "blocklistItemId": "string",
      "description": "string",
      "text": "bleed"
    }
  ]
}

Den API-Aufruf blocklistItems (Auflisten aller Blocklistenelemente):

{
  "values": [
    {
      "blocklistItemId": "string",
      "description": "string",
      "text": "bleed",
    }
  ]
}

Den API-Aufruf blocklistItems mit einer Element-ID (Abrufen eines einzelnen Elements):

{
  "blocklistItemId": "string",
  "description": "string",
  "text": "string"
}

Nächste Schritte