自然言語理解
Yahoo!音声アシストでも使われている自然言語理解Web APIを利用して、アプリケーションを作成できます。
日本語文を解析し、情報の抽出を行う機能を提供します。
リクエストURL
JSON
https://jlp.yahooapis.jp/NLUService/V1/analyze
リクエストパラメータ
仕様
| パラメータ | 値 | 説明 |
|---|---|---|
| appid（必須） | string | アプリケーションID。詳細はこちらをご覧ください。 |
| intext（必須） | string | 解析対象のテキストです。 |
| sample<n> | string | カスタムルール。詳細はカスタムルールの追加 仕様をご覧ください。 |
| dict<n> | string | カスタム辞書。詳細はカスタム辞書の追加 仕様をご覧ください。 |
過去のリクエスト履歴を引き継ぐ場合
レスポンスフィールドに含まれるパラメータの末尾に_prev<n>をつけ、そのままリクエストパラメータとしてすべて含めてください。リクエスト履歴は過去3回分まで引き継がれます。 詳細はサンプルコードを参考にしてください。
| パラメータ | 値 | 例 |
|---|---|---|
| param_place_prev1 | string | 新宿 |
| ... |
サンプルリクエストURL
https://jlp.yahooapis.jp/NLUService/V1/analyze?appid=<あなたのアプリケーションID>&intext=%E6%96%B0%E5%AE%BF%E3%81%AE%E5%A4%A9%E6%B0%97サンプルコード
自然言語理解を使用したサンプルコードです。
レスポンスフィールド
詳細はこちらをご覧ください。
共通フィールド
| フィールド | 例 | 説明 |
|---|---|---|
| result | 解析結果のすべてを含みます。 | |
| result/intext | 新宿の天気 | リクエストの入力テキスト。 |
| result/method | WEATHER | 応答ドメインの種類。TRANSIT（乗り換え）、WEATHER（天気）、SAY（雑談）など。 |
| result/status | 200 | 応答ステータスの種類。
|
特定のレスポンスのみに存在するフィールド (抜粋)
| フィールド | 例 | 入力テキスト例 | 説明 |
|---|---|---|---|
| result/param_method_subcat | FROMTO | 東京から京都まで | 応答ドメインのサブカテゴリ |
| result/param_from | 東京 | 東京から京都まで | TRANSITやMAPなどで起点となる場所 |
| result/param_to | 京都 | 東京から京都まで | TRANSITやMAPなどで終点となる場所 |
| result/param_place | 新宿 | 新宿の天気 | WEATHERやMAPなどで対象となる場所 |
| result/param_text | 眠いときが寝どきです。 | 眠い | SAYなどでの応答文 |
| result/param_query | トゲアリトゲナシトゲトゲ | トゲアリトゲナシトゲトゲを検索 | SEARCHなどでの検索クエリ |
サンプルレスポンス
以下は、intext=新宿の天気 のリクエストに対するレスポンスです。
{
"result": {
"intext": "新宿の天気",
"method": "WEATHER",
"nvm_that": "新宿",
"param_method_subcat": "GENERAL",
"param_place": "新宿",
"status": "200",
"var_intext": "新宿の天気",
"var_intext_normalized": "新宿の天気",
"var_intext_timestamp": "1514364931",
"var_test_btsc": "31"
}
}エラー
自然言語理解はYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。
利用制限
自然言語理解Web APIは、24時間以内で1つのアプリケーションIDにつき50000件のリクエストが上限となっています。また、1リクエストの最大サイズを100KBに制限しています。詳しくは「利用制限」をご参照ください。
自然言語理解
- 出力仕様
- その他の仕様
- チュートリアル
- サンプルコード