Compatibilité Azure Language PII
Migrez vers ShinrAI les charges PII Azure prises en charge pour le texte, les conversations et les documents.
Migration depuis Azure Language PII
Utilisez votre clé API ShinrAI dans Ocp-Apim-Subscription-Key et dirigez le client vers l’URL de base de l’API ShinrAI. L’adaptateur PII texte implémente les contrats ci-dessous ; les prédictions et la couverture complète d’Azure sont des sujets distincts.
| Contrat | Point de terminaison |
|---|---|
| Moderne synchrone | POST /language/:analyze-text?api-version=2023-04-01 ou 2026-05-01 |
| Moderne asynchrone | POST /language/analyze-text/jobs?api-version=2023-04-01 ou 2026-05-01 |
| Historique synchrone | POST /text/analytics/v3.1/entities/recognition/pii |
| Historique asynchrone | 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"}}'
Exemple de réponse (simulé)
Extrait JSON simulé pour la commande ci-dessus. Les détections, les valeurs de remplacement et votre solde peuvent différer.
{
"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"
}
}Le PII texte synchrone accepte jusqu’à 5 documents de 5.120 groupes de graphèmes chacun. Les tâches asynchrones acceptent jusqu’à 25 documents et 125.000 éléments de texte Unicode 8 au total, avec une limite de 1 MiB par requête. Interrogez l’URL operation-location renvoyée. L’accès et l’annulation sont réservés au compte créateur ; les données chiffrées expirent 24 heures après soumission.
Les positions peuvent utiliser les unités UTF-16, les points de code Unicode ou les éléments de texte Unicode 8. Le modèle réel est ShinrAI 1.3 ; les identifiants Azure datés sont rejetés. Le modèle ne couvre pas toutes les catégories ou modalités Azure PII. Les options ou catégories non prises en charge échouent explicitement. Cet adaptateur concerne le PII texte ; consultez la matrice de version. Il ne garantit pas la parité des fonctions ou prédictions avec tout Azure.
Catégories et options Azure prises en charge
Toutes les versions prises en charge mappent Person, Organization, Email, URL, PhoneNumber, IPAddress, Address, CreditCardNumber et InternationalBankingAccountNumber. Les versions v3.1 et 2023-04-01 mappent les dates de naissance à DateTime, sans détection générale des dates. Le contrat 2026-05-01 ajoute City, DateOfBirth, NationalId, ZipCode et LicensePlate.
Pour 2026-05-01, les contrôles incluent l’inclusion/exclusion de catégories, les seuils de confiance, les exclusions de valeurs et le masquage par caractère, entité ou sans masque. Le domaine phi, les synonymes contextuels, la désactivation de validation et le remplacement synthétique Azure sont rejetés. Les détections natives sans correspondance vérifiée produisent des avertissements ShinrAIUnmappedEntityTypes et sont omises du masquage Azure ; utilisez l’API native pour les conserver.
Codes de langue acceptés : de en fr es it pl pt ru uk tr ar he ja ko. L’acceptation ne garantit pas une qualité égale. Les tâches asynchrones utilisent le coefficient Batch, les synchrones Standard ; chaque tâche asynchrone est facturée séparément. Consultation et annulation sont gratuites.
Les tests SDK locaux Python et JavaScript réussissent pour le sous-ensemble implémenté. La comparaison avec Azure et le client .NET restent à vérifier pour la version. Contrat PII texte de Microsoft.