Azure Language PII互換性
対応するAzureのテキスト、会話、文書PIIワークロードをShinrAIへ移行します。
Azure Language PIIからの移行
ShinrAIのAPIキーを指定するヘッダーは Ocp-Apim-Subscription-Key です。クライアントの接続先をShinrAI APIのベースURLに変更してください。テキストPIIアダプターは以下のリクエスト・レスポンス契約に対応します。モデルの予測やAzureの全機能への対応は別の事項です。
| 契約 | エンドポイント |
|---|---|
| 最新・同期 | POST /language/:analyze-text?api-version=2023-04-01 または 2026-05-01 |
| 最新・非同期 | POST /language/analyze-text/jobs?api-version=2023-04-01 または 2026-05-01 |
| レガシー・同期 | POST /text/analytics/v3.1/entities/recognition/pii |
| レガシー・非同期 | 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"}}'
出力例(シミュレーション)
上のコマンドに対応する、シミュレーションによるJSON応答の抜粋です。実際の検出結果、置換値、残高は異なる場合があります。
{
"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"
}
}同期テキストPIIは、各5.120書記素クラスタまでの文書を最大5件処理できます。非同期ジョブは最大25文書、合計125.000 Unicode 8テキスト要素に対応し、リクエスト上限は1 MiBです。返されたoperation-location URLでポーリングしてください。ジョブの参照・取消は作成元アカウントに限定され、暗号化されたジョブデータは送信から24時間後に失効します。
オフセットにはUTF-16コード単位、Unicodeコードポイント、Unicode 8テキスト要素を選択できます。実際のモデルはShinrAI 1.3で、日付付きAzureモデルIDは拒否されます。現在のモデルはAzure PIIの全カテゴリ・モダリティには対応していません。未対応のカテゴリやオプションは明示的なエラーになります。これはテキストPIIアダプターです。詳細はリリース互換表をご覧ください。Azure全体の機能や予測の同等性を意味しません。
対応するAzureカテゴリ・オプション
対応する全バージョンでPerson、Organization、Email、URL、PhoneNumber、IPAddress、Address、CreditCardNumber、InternationalBankingAccountNumberをマッピングします。レガシーv3.1と2023-04-01では生年月日をDateTimeに割り当てますが、一般的な日付検出ではありません。2026-05-01ではCity、DateOfBirth、NationalId、ZipCode、LicensePlateも対応します。
2026-05-01では、カテゴリの包含・除外、信頼度閾値、値の除外、文字・エンティティ・無マスクの制御に対応します。phiドメイン、文脈同義語、検出検証の無効化、Azureの合成置換は拒否されます。検証済みの対応がないネイティブ検出は ShinrAIUnmappedEntityTypes 警告を生成し、Azureのマスク処理から除外されます。これらの検出を保持する必要がある場合は、ネイティブAPIを使用してください。
受け付ける言語コード: de en fr es it pl pt ru uk tr ar he ja ko。対応は検出品質が同等であることを意味しません。非同期ジョブはBatch、同期はStandardの係数で計算し、非同期タスクごとに課金します。ポーリングと取消は無料です。
実装済みの範囲ではローカルのPython・JavaScript SDKテストが合格しています。Azureとの参照比較と.NETクライアントはリリース検証の対象として残っています。 MicrosoftのテキストPII契約.