ShinrAISTACKITでホスティング

Azure Language PII互換性

対応するAzureのテキスト、会話、文書PIIワークロードをShinrAIへ移行します。

Azure Language PIIからの移行

ShinrAIのAPIキーを指定するヘッダーは Ocp-Apim-Subscription-Key です。クライアントの接続先をShinrAI APIのベースURLに変更してください。テキストPIIアダプターは以下のリクエスト・レスポンス契約に対応します。モデルの予測やAzureの全機能への対応は別の事項です。

Azure互換のテキストPIIエンドポイント
契約エンドポイント
最新・同期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契約.

レコードの例を見る →