Kompatibilität mit Azure Language PII
Migrieren Sie unterstützte Azure-PII-Workloads für Text, Gespräche und Dokumente zu ShinrAI.
Migration von Azure Language PII
Verwenden Sie Ihren ShinrAI-API-Schlüssel in Ocp-Apim-Subscription-Key und richten Sie den Client auf die Basis-URL der ShinrAI-API. Der Text-PII-Adapter implementiert die unten unterstützten Anfrage- und Antwortverträge; Modellvorhersagen und vollständige Azure-Funktionsabdeckung sind davon getrennt.
| Vertrag | Endpunkt |
|---|---|
| Modern synchron | POST /language/:analyze-text?api-version=2023-04-01 oder 2026-05-01 |
| Modern asynchron | POST /language/analyze-text/jobs?api-version=2023-04-01 oder 2026-05-01 |
| Legacy synchron | POST /text/analytics/v3.1/entities/recognition/pii |
| Legacy asynchron | POST /text/analytics/v3.1/analyze |
curl 'https://api.shinrai.innovius.io/language/:analyze-text?api-version=2023-04-01' \
-H "Ocp-Apim-Subscription-Key: $SHINRAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"kind":"PiiEntityRecognition","analysisInput":{"documents":[{"id":"1","language":"en","text":"Email emma@example.com"}]},"parameters":{"modelVersion":"latest","stringIndexType":"Utf16CodeUnit"}}'
Beispielausgabe (simuliert)
Simulierter JSON-Auszug zum obigen Befehl. Erkennungen, Ersatzwerte und Ihr Guthaben können abweichen.
{
"kind": "PiiEntityRecognitionResults",
"results": {
"documents": [
{
"id": "1",
"redactedText": "Email ****************",
"entities": [
{
"text": "emma@example.com",
"category": "Email",
"offset": 6,
"length": 16,
"confidenceScore": 1.0
}
],
"warnings": []
}
],
"errors": [],
"modelVersion": "shinrai-v1.3"
}
}Synchrone Text-PII erlaubt bis zu 5 Dokumente mit je 5.120 Graphemclustern. Asynchrone Jobs erlauben bis zu 25 Dokumente und insgesamt 125.000 Unicode-8-Textelemente bei maximal 1 MiB pro Anfrage. Fragen Sie die zurückgegebene operation-location-URL ab. Jobzugriff und Abbruch sind auf das erstellende Konto beschränkt; verschlüsselte Jobdaten laufen 24 Stunden nach Einreichung ab.
Offset-Modi umfassen UTF-16-Codeeinheiten, Unicode-Codepunkte und Unicode-8-Textelemente. Das tatsächliche Modell ist ShinrAI 1.3; datierte Azure-Modellkennungen werden abgelehnt. Das Modell deckt nicht alle Azure-PII-Kategorien oder Modalitäten ab. Nicht unterstützte Kategorien oder Optionen führen zu expliziten Fehlern. Dies ist ein Text-PII-Adapter; weitere Details stehen in der Release-Matrix. Eine Azure-weite Funktions- oder Vorhersagegleichheit wird nicht behauptet.
Unterstützte Azure-Kategorien und Optionen
Alle unterstützten Versionen bilden Person, Organization, Email, URL, PhoneNumber, IPAddress, Address, CreditCardNumber und InternationalBankingAccountNumber ab. Legacy v3.1 und 2023-04-01 bilden Geburtsdaten auf DateTime ab; dies ist keine allgemeine Datumserkennung. Der Vertrag 2026-05-01 bildet zusätzlich City, DateOfBirth, NationalId, ZipCode und LicensePlate ab.
Für 2026-05-01 werden Kategorie-Ein-/Ausschluss, Konfidenzschwellen, Werteausnahmen und Zeichen-/Entitäts-/keine Maskierung unterstützt. Die phi-Domäne, Kontextsynonyme, Abschalten der Detektorvalidierung und Azure-Synthetic-Replacement werden abgelehnt. Native Funde ohne verifizierte Zuordnung erzeugen ShinrAIUnmappedEntityTypes -Warnungen und werden bei der Azure-Maskierung ausgelassen; nutzen Sie die native API, wenn diese Funde erhalten bleiben müssen.
Akzeptierte Sprachcodes: de en fr es it pl pt ru uk tr ar he ja ko. Akzeptanz bedeutet nicht gleiche Erkennungsqualität. Asynchrone Jobs verwenden Batch-Gewichtung, synchrone Standard; jede asynchrone Aufgabe wird separat berechnet. Abfragen und Abbruch sind kostenlos.
Lokale Python- und JavaScript-SDK-Tests bestehen für den implementierten Teilumfang. Azure-Referenzvergleich und der .NET-Client bleiben Gegenstand der Release-Verifikation. Microsofts Text-PII-Vertrag.