サービス API のバージョン管理

現行 API バージョン: 2022-08-10

API 要求には、version=YYYY-MM-DD という形式で日付を取得する version パラメーターが必要です。 API 要求ごとに version パラメーターを送信します。

後方互換性のある方法で API を変更する場合、IBM は新規マイナー・バージョンをリリースします。 新規バージョンでの変更を利用するには、version パラメーターの値を新しい日付に変更します。 当該バージョンに更新する準備ができていない場合は、バージョン日付を変更しないでください。

エンティティー・タイプ (バージョン 1) の非推奨の発表

エンティティー・タイプ (バージョン 1) は推奨されません。 2023 年 7 月 11 日以降、 v1 エンティティー・タイプ・システムは使用できなくなります。 v2 エンティティー・タイプ・システムに切り替えることを検討してください。 より汎用的な v2 エンティティー・タイプ・システムを他の機能 (コンセプトやカテゴリーなど) と一緒に使用することにより、より柔軟に同様の結果を得ることができます。 v2 エンティティー・タイプについて詳しくは、 エンティティー・タイプ (バージョン 2)を参照してください。

2023 年 6 月 9 日

廃止されたカスタム評判機能

カスタム・センチメント機能は廃止されました。 カスタム評判モデルは、作成することも、Analyze API 呼び出しで使用することもできなくなりました。 堅固かつ強力なテキスト分類機能を引き続きお客様に提供するために、 IBM は最近、新しい 単一ラベル・テキスト分類機能の一般出荷可能日を発表しました。 この新機能には、拡張された言語サポートと、カスタム評判分類器の作成に適したトレーニング・データのカスタマイズが含まれています。

2023年2月16日

カスタム分類のトレーニング・プロセスの更新

カスタム分類のトレーニング・プロセスが更新されました。これには、前処理ステージの改善、基礎となるライブラリーの更新、およびマイナー・バグの修正が含まれます。

2023 年 2 月 2 日

追加言語のセンチメント・サポート

すべてのパブリック・サービス・インスタンスで、チェコ語、デンマーク語、フィンランド語、ヘブライ語、ヒンディ語、ノルウェー語ブークモール、ノルウェー語、ポーランド語、ルーマニア語、スロバキア語、スウェーデン語、トルコ語の評判がサポートされるようになりました。 詳しくは、 言語サポートを参照してください。

2023 年 1 月 11 日

改善された英語および韓国語エンティティー・モデル

一部のエンティティーが正しく返されないバージョン 2 エンティティー・タイプ・システムを使用する英語モデルと韓国語モデルのバグが修正されました。

2022 年 11 月 3 日

センチメントとカスタム・センチメントのエラー処理と検証の改善

要求に、評判機能のエラーと、別の機能に対する有効な機能要求の両方が含まれている場合、応答は、評判機能に対する警告とともに 200 を返します。

文書内で検出された少なくとも 1 つのターゲットを含むカスタム・センチメントの要求は、検出されたターゲットのセンチメント分析とともに 200 を返すようになりました。

エラー・ログが sentiment request must specify at least one of: document, targets から sentiment request must specify at least one of: document or targets に変更されました。

2022 年 9 月 1 日

改善されたカテゴリーおよびカスタム・カテゴリー (ベータ) モデル

カテゴリー および カスタム・カテゴリー (ベータ) のモデルで、より現代的な語彙がサポートされるようになりました。 例えば、「Covid-19」などの新しい単語を解釈できます。

2022 年 8 月 10 日

追加言語のエンティティー・サポート

チェコ語、デンマーク語、フィンランド語、ヘブライ語、ヒンディ語、ノルウェー語ブークモール、ノルウェー語ニーノスク、ポーランド語、ルーマニア語、スロバキア語、トルコ語のすべてのパブリック・サービス・インスタンスおよびプレミアム・サービス・インスタンスで、エンティティーのサポートが利用可能になりました。 詳しくは、 言語サポートを参照してください。

バージョン 2 エンティティーのサポート (ロシア語およびスウェーデン語)

バージョン 2 エンティティー・タイプのサポートは、すべてのパブリック・サービス・インスタンスおよびプレミアム・サービス・インスタンスについて、ロシア語およびスウェーデン語で利用できるようになりました。 詳しくは、エンティティー・タイプ・システムを参照してください。

2022 年 8 月 3 日

単一ラベル分類のサポート

分類により、ユーザーは、単一のラベル分類器をトレーニングするために、モデルの作成時または更新時に model_type トレーニング・パラメーターを渡すことができるようになりました。 詳しくは、 分類のトレーニング・パラメーター を参照してください。

2022 年 7 月 11 日

改善された カスタム分類 モデル-日本語

日本語のカスタム分類モデルのトレーニングと推論の実行が高速化され、モデル結果が改善されました。

改善された カスタム・カテゴリー ・モデル

モデルには改善されたワード・フィルターが含まれているため、カテゴリーの決定が向上します。

2022 年 4 月 7 日

カテゴリーのバグの修正

バージョン 2 カテゴリー・タイプ・システムのバグが修正されました。

2022 年 2 月 14 日

感情のサポート

感情のサポートが、すべてのパブリック・サービス・インスタンス、フランス語で利用できるようになりました。 詳しくは、 言語サポートを参照してください。

エラー処理と感情の検証の改善

要求に感情機能のエラーと別の機能への有効な機能要求の両方が含まれている場合、応答は感情機能への警告とともに 200 を返します。

エラー・ログが emotion request must specify at least one of: document, targets から emotion request must specify at least one of: document or targets に変更されました。

ターゲット・リストに文字列ではないエレメントが含まれている感情機能を含む要求は、エラーを返します。

2021 年 12 月 1 日

トーン分析

トーン分析 が使用可能になりました (英語およびフランス語のみ)。 トーン分析機能は、テキストから excited、 frustrated、 impolite、 polite、 sad、 satisfied、および sympathetic のトーンを検出します。

2021 年 10 月 12 日

追加言語のキーワードおよびシンタックスのサポート

すべてのパブリック・サービス・インスタンスおよびプレミアム・サービス・インスタンスで、ヒンディ語、ルーマニア語、およびトルコ語のキーワードと構文がサポートされるようになりました。 さらに、サポートされるすべての言語で構文を使用できます。 詳しくは、 言語サポートを参照してください。

2021 年 8 月 15 日

カスタム分類の機能

カスタム分類 フィーチャーが一般出荷可能 (GA) になりました。

更新されたカテゴリー・ストック・モデル

IAB Tech Lab 2.0 分類法を使用するように カテゴリー在庫モデル が更新されました。

2021 年 5 月 5 日

拡張ルールのベータ版機能 (非推奨)

拡張ルール・ベータ機能は非推奨になりました。 2021 年 6 月 10 日現在、拡張ルール・モデルを Natural Language Understanding にデプロイすることはできません。既存のモデルは引き続き実行されます。 2021 年 6 月 24 日以降、Natural Language Understanding で実行される拡張ルール・モデルはありません。

2021 年 3 月 25 日

カスタム分類のベータ版機能

カスタム分類 (ベータ版) の機能を使用すると、独自のラベル付きデータを使用して、マルチラベル・テキスト分類器 (英語のみ) をトレーニングできます。

2021 年 2 月 18 日

カスタム・カテゴリーのベータ版の機能

カスタム・カテゴリー (ベータ) 機能により、ダラス・ロケーションにデプロイされたサービス・インスタンスを使用して、カスタム・カテゴリー・モデル (英語のみ) をトレーニングできます。

2020 年 12 月

2020 年 11 月

2020 年 9 月

2020 年 8 月

2020 年 7 月 8 日

アラビア語向けキーワードのサポート

すべてのパブリック・サービス・インスタンスおよびプレミアム・サービス・インスタンスで、アラビア語キーワードのサポートが使用可能になりました。 詳しくは、 言語サポートを参照してください。

2020 年 4 月 10 日

カスタム・センチメント (ベータ版)

カスタム・センチメント (ベータ版) が使用可能になりました。 ベータ版は英語をサポートし、ダラス・ロケーションのサービス・インスタンスでのみ使用可能です。 詳しくは、カスタム・センチメント・モデルの作成を参照してください。

2020 年 3 月

2019 年 12 月

2019 年 11 月

2019 年 10 月 10 日

センチメントの応答時間の改善

日本語と韓国語のセンチメント要求の応答時間が改善されました。

2019 年 9 月

2019 年 8 月 29 日

英語向けのセンチメント・サポートの改善

英語センチメントの精度が向上しました。

2019 年 7 月 12 日

バージョン日付 2019-07-12 以降を使用すると、以下の変更がアクティブになります。

精度が向上した新しい英語のエンティティー・モデル。

信頼性スコアは、英語のエンティティー結果で返されます。

2019 年 6 月

2019 年 5 月

2019 年 4 月 25 日

ルール・ベースのカスタム・モデル向けエンティティーの言及

ルール・ベースのカスタム・モデルで、エンティティー言及が有効になりました。 結果内で言及を表示するには、mentions エンティティー・オプションを true に設定します。

英語カテゴリーの結果の説明

英語カテゴリーの結果に関する説明がリリースされました。 各結果に関与しているソースの関連テキストを表示するには、explanation カテゴリー・オプションを true に設定します。

2019 年 3 月 19 日

Knowledge Studio で作成されたカスタム・カテゴリー・モデル

Knowledge Studio を使用して作成したカスタム・カテゴリー・モデルに関する試験的サポートが導入されました。

スペイン語向けのキーワードと概念の改善

スペイン語のキーワードと概念が向上しました。

2019 年 1 月 10 日

バージョン日付パラメーターが指定されていない要求にはエラーが返されます

バージョン日付パラメーターを含まない List models および Delete model 要求は、成功した応答の代わりに 400 エラーを返すようになりました。

エンティティーのパフォーマンスの改善

英語以外の言語でのエンティティーのパフォーマンスが向上しました。

2018 年 12 月

2018 年 11 月

2018 年 10 月 30 日

サービス・インスタンスに使用される IAM

2018 年 10 月 30 日より、ドイツと米国南部地域で作成される新しいサービス・インスタンスは ID およびアクセス管理 (IAM) 認証 を使用します。

2018 年 9 月 21 日

言語サポートの改善

フランス語の関係とポルトガル語の概念のサポートが追加されました。

フランス語とポルトガル語のキーワードをターゲットにした評判オプションのサポートが追加されました。

フランス語のキーワードが向上しました。

韓国語の評判が向上しました。

ポルトガル語のキーワードと評判が向上しました。

最新のエンティティー・タイプ・システムを使用したポルトガル語の新しいエンティティー・モデルがリリースされました。 最新のタイプ・システムの詳細については、エンティティーのタイプとサブタイプ (バージョン 2)ページを参照してください。 アプリケーションが新しいタイプ・システムに対応している場合は、新しいモデルを使用するように、要求内のバージョン日付パラメーターを 2018-09-21 に変更してください。

2018 年 6 月

2018 年 5 月

2018 年 4 月

2018 年 3 月 16 日

言語サポートの改善

ドイツ語のカテゴリー、関係、および意味役割のサポートが追加されました。

ドイツ語の関係には新しい関係タイプ・システムが使用されます。 詳しくは、「関係タイプ (バージョン 2)」ページを参照してください。

ドイツ語のキーワードと評判が向上しました。

日本語カテゴリーと概念のサポートが追加されました。

言語検出が向上しました。

Web ページ・クリーニングが向上しました。

フランス語とドイツ語のエンティティー・モデルが向上しました。 これらのモデルは新しいエンティティー・タイプ・システムを使用します。 「エンティティーのタイプとサブタイプ (バージョン 2)」ページで、新しいエンティティーのタイプとサブタイプを確認してください。 アプリケーションが新しいタイプ・システムに対応している場合は、新しいモデルを使用するように、要求内のバージョン日付パラメーターを 2018-03-16 に変更してください。 バージョン 1 タイプ・システムと バージョン 2 タイプ・システムの違いは以下のとおりです。

• 新しいエンティティー・タイプ:
  • 日付
  • Duration
  • Auto
  • Money
  • Number*
  • Percent*
  • PhoneNumber*
  • 序数
  • 時刻
  • URL*
• 削除されたエンティティー・タイプ:
  • 解剖学
  • Award
  • 放送局
  • 会社
  • Crime
  • ドラッグ
  • HealthCondition
  • ムービー
  • MusicGroup
  • NaturalEvent
  • PrintMedia
  • 数量
  • Sport
  • SportingEvent
  • TelevisionShow
  • 車両
• 新しいエンティティー・サブタイプ:
  • 数量

* このエンティティー・タイプはフランス語テキストでまだ検出できません。

2018 年 1 月

2017 年 12 月 15 日

言語サポートの改善

オランダ語 カスタム・モデル・サポートがエンティティーと関係で使用できるようになりました。

フランス語の言語サポートに概念が組み込まれました。

フランス語の評判モデルが向上し、より良い結果が出されるようになりました。

言語検出モデルが高速化され、全体的により多くの言語が検出されるようになりました。 言語の全リストについては、『検出可能言語』を参照してください。

• 以下の言語が新たにリストに加えられました。

  • ベラルーシ語 (be)
  • ビハール語 (bh)
  • ディベヒ語 (dv)
  • ガリシア語 (gl)
  • ガンダ語 (lg)
  • イヌクティトゥト語 (iu)
  • ジャワ語 (jv)
  • カンナダ語 (kn)
  • クメール語 (km)
  • キニヤルワンダ語 (rw)
  • ラオス語 (lo)
  • マラヤーラム語 (ml)
  • マラーティー語 (mr)
  • オリヤー語 (or)
  • パンジャブ語 (pa)
  • スコッチ・ゲール語 (gd)
  • シンハラ語 (si)
  • タミール語 (ta)
  • テルグ語 (te)
  • イディッシュ語 (yi)

• 以下の言語は検出可能ではなくなりました。

  • ブルトン語 (br)
  • チャモロ語 (ch)
  • エスペラント語 (eo)
  • フェロー語 (fo)
  • ハウサ語 (ha)
  • ンデベレ語 (nr)
  • オジブワ語 (oj)

2017 年 11 月

2017 年 11 月 28 日

エンティティーの言及

オプション entities を追加することにより、"mentions": true 要求でエンティティー言及の場所を取得します。

• POST /analyze 要求本文の例:

  {
    "text": "Intel planned to announce Monday a laptop-computer chip that combines an Intel processor and an AMD graphics unit.",
    "features": {
      "entities": {
        "mentions": true
      }
    }
  }
  

• 応答の例:

  {
    "usage": {
      "text_units": 1,
      "text_characters": 114,
      "features": 1
    },
    "language": "en",
    "entities": [
      {
        "type": "Company",
        "text": "Intel",
        "relevance": 0.33,
        "mentions": [
          {
            "text": "Intel",
            "location": [
              0,
              5
            ]
          },
          {
            "text": "Intel",
            "location": [
              73,
              78
            ]
          }
        ],
        "disambiguation": {
          "subtype": [
            "OperatingSystemDeveloper",
            "ProcessorManufacturer",
            "SoftwareDeveloper"
          ],
          "name": "Intel",
          "dbpedia_resource": "http://dbpedia.org/resource/Intel"
        },
        "count": 2
      },
      {
        "type": "Company",
        "text": "AMD",
        "relevance": 0.33,
        "mentions": [
          {
            "text": "AMD",
            "location": [
              96,
              99
            ]
          }
        ],
        "disambiguation": {
          "subtype": [
            "ProcessorManufacturer"
          ],
          "name": "Advanced Micro Devices",
          "dbpedia_resource": "http://dbpedia.org/resource/Advanced_Micro_Devices"
        },
        "count": 1
      }
    ]
  }
  

2017 年 11 月 17 日

韓国語サポートの改善

韓国語サポート が拡張され、以下の機能が組み込まれました。

• エンティティー
• キーワード
• 意味役割

2017 年 7 月 30 日

処理される文字数の制限

オプションの limit_text_characters パラメーターを使用して処理対象の文字数を制限することにより、コストを制御することができます。 以下に例を示します。

{
  "text": "The United States of America, commonly known as the United States (U.S.) or America, is a federal republic composed of 50 states, a federal district, five major self-governing territories, and various possessions. Forty-eight of the fifty states and the federal district are contiguous and located in North America between Canada and Mexico. The state of Alaska is in the northwest corner of North America, bordered by Canada to the east and across the Bering Strait from Russia to the west.",
  "features": {
    "entities": {}
  },
  "limit_text_characters": 50,
  "return_analyzed_text": true
}

• 文字が 1 バイト文字かマルチバイト文字かにかかわらず、各文字は 1 文字とカウントされます。

• 計量については、1 つの Natural Language Understanding 項目は引き続き、1 テキスト単位あたり 1 つのフィーチャー (エンリッチメントとも呼ばれます) です。 1 テキスト単位は 10,000 文字以下です。

• 価格設定情報について詳しくは、IBM Cloud® カタログにある Natural Language Understanding を参照してください。

limit_text_characters パラメーターの追加のほかにも、テキスト・サイズ制限と切り捨てに対して以下の変更が行われました。

• 50,000 文字を超えるテキストはすべて、処理の前に切り捨てられます。 以前には、切り捨てはキロバイト (1 キロバイトは 1024 バイト) に基づいて行われていました。

• 50,000 文字を超えるテキストに対して切り捨てが行われると、応答で通知メッセージが返されます。

• カスタム・モデルのテキスト制限サイズが 10,000 文字から 50,000 文字に増加しました。

• 各要求で使用される Natural Language Understanding 項目数を明確にするために、応答に使用状況情報が追加されました。 以下に例を示します。

{
  "usage": {
    "text_units": 5,
    "text_characters": 41186,
    "features": 1
  },
  ...
}

2017 年 5 月 8 日

感情トーン・スコアの更新

感情トーン・スコア・モデルが更新されました。 トレーニング・データ・セットが拡張され、特徴量エンジニアリングが変更されました。その結果、モデルの IBM ベンチマーク・データ・セットの精度が高くなりました。

2017 年 3 月

2017 年 2 月 27 日

サービス GA

Natural Language Understanding サービスが一般出荷されました。