--- sourceDocument: Yokohama 対話型インターフェース sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/conversational-interfaces Release : - yokohama ft:locale : - ja-JP ft:publication_title : - Yokohama 対話型インターフェース ft:clusterId : - convint bundleId : - convint workflow : - Platform --- # NLU システムエンティティ # NLU システムエンティティ {#ariaid-title1} * リリースバージョン: Yokohama * * 更新日 2025年01月30日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：11分 グローバルに定義された NLU エンティティを使用して、仮想エージェント が会話から抽出できるシステム情報を識別します。エンティティは、トピックの「ノードレス」入力変数として定義できます。これらの変数は、NLU サービスプロバイダー予測からスロット入力するか、トピックのスコープ外で指定できます。 NLU モデルでは、システムエンティティはデフォルトで有効になっています。これらは、NLU ワークベンチ のこのモデルの \[エンティティ\] タブで表示できます。 ## GLOBAL.DATE システムエンティティ {#nlu-system-entities__section_cqn_53d_lpb} DAY サブタイプは、特定の日付を正確に表す日付文字列を返します。 {#nlu-system-entities__table_lcl_cjd_lpb__entry__2} | 使用法 | 例 | |-|-| | フォーマット | YYYY-MM-DD | | 正規表現 | \\\\d\\\\d\\\\d\\\\d-\\\\d\\\\d-\\\\d\\\\d | | 入力例 | Smith 氏は 2019 年 2 月 4 日金曜日に出発しました。 | | 正規化値 | 2019-02-04 | | コード例 | { "name": "DATE", "value": "...", "score": 1.0, "normalization": "2019-02-04" } | [表 : 1. GLOBAL.DATE SubType = DAY の使用法] {#nlu-system-entities__table_lcl_cjd_lpb} WEEK サブタイプは、年の特定の週の日付文字列を返します。 {#nlu-system-entities__table_crg_tjd_lpb__entry__2} | 使用法 | 例 | |-|-| | フォーマット | YYYY'W'WW | | 正規表現 | \\\\d\\\\d\\\\d\\\\d\\\\dW\\\\d\\\\d | | 入力例 | Smith 氏は 1999 年の第 3 週に出発しました。 | | 正規化値 | 1999W3 | | コード例 | { "name": "entity:GLOBAL.DATE", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.DATE", "subType": "WEEK", "value":"1999W3"} } | [表 : 2. GLOBAL.DATE SubType = WEEK の使用法] {#nlu-system-entities__table_crg_tjd_lpb} MONTH サブタイプは、年の特定の月の日付文字列を返します。 {#nlu-system-entities__table_edh_sld_lpb__entry__2} | 使用法 | 例 | |-|-| | フォーマット | YYYY'M'MM | | 正規表現 | \\\\d\\\\d\\\\d\\\\dM\\\\d\\\\d | | 入力例 | Smith 氏は 1999 年 2 月に出発しました。 | | 正規化値 | 1999M02 | | コード例 | { "name": "entity:GLOBAL.DATE", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.DATE", "subType": "MONTH", "value": "1999M02"} } | [表 : 3. GLOBAL.DATE SubType = MONTH の使用法] {#nlu-system-entities__table_edh_sld_lpb} YEAR サブタイプは、特定の年の日付文字列を返します。 {#nlu-system-entities__table_pxj_1md_lpb__entry__2} | 使用法 | 例 | |-|-| | フォーマット | YYYY | | 正規表現 | \\\\d\\\\d\\\\d\\\\d | | 入力例 | Smith 氏は 1999 年に出発しました。 | | 正規化値 | 1999 | | コード例 | { "name": "entity:GLOBAL.DATE", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.DATE", "subType": "YEAR", "value": "1999"} } | [表 : 4. GLOBAL.DATE SubType = YEAR の使用法] {#nlu-system-entities__table_pxj_1md_lpb} SEASON サブタイプは、年の特定の季節の日付文字列を返します。 {#nlu-system-entities__table_s1q_fpd_lpb__entry__2} | 使用法 | 例 | |-|-| | フォーマット | 次のいずれかになります。 * 冬：YYYYWI * 春：YYYYSP * 夏：YYYYSU * 秋：YYYYFA {#nlu-system-entities__ul_m4j_jpd_lpb} | | 正規表現 | 次のいずれかになります。 * 冬：\\\\d\\\\d\\\\d\\\\dWI * 春：\\\\d\\\\d\\\\d\\\\dSP * 夏：\\\\d\\\\d\\\\d\\\\dSU * 秋：\\\\d\\\\d\\\\d\\\\dFA {#nlu-system-entities__ul_cnh_npd_lpb} | | 入力例 | Smith 氏は 1999 年の秋に出発しました。 | | 正規化値 | 1999FA | | コード例 | { "name": "entity:GLOBAL.DATE", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.DATE", "subType": "SEASON", "value": "1999FA"} } | [表 : 5. GLOBAL.DATE SubType = SEASON の使用法] {#nlu-system-entities__table_s1q_fpd_lpb} ## GLOBAL.TIME システムエンティティ {#nlu-system-entities__section_rrk_kqd_lpb} TIME サブタイプは、1 時間と 1 分を正確に表す時間文字列を返します。 {#nlu-system-entities__table_zrm_mqd_lpb__entry__2} | 使用法 | 例 | |-|-| | フォーマット | 'T'HH:mm | | 正規表現 | T\\\\d\\\\d:\\\\d\\\\d | | 入力例 | Smith 氏は 3 時 10 分前に出発しました。 | | 正規化値 | T02:50 | | コード例 | { "name": "entity:GLOBAL.TIME", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.TIME","subType": "TIME", "value": "T02:50"} } | [表 : 6. GLOBAL.TIME SubType = TIME の使用法] {#nlu-system-entities__table_zrm_mqd_lpb} PARTSOFDAY サブタイプは、その日の部分を指定する時間文字列を返します。 {#nlu-system-entities__table_thr_wqd_lpb__entry__2} | 使用法 | 例 | |-|-| | フォーマット | 次のいずれかになります。 * 朝：TMO * 午後：TAF * 夕方：TEV * 夜：TNI {#nlu-system-entities__ul_xl5_crd_lpb} | | 正規表現 | 次のいずれかになります。 * 朝：TMO * 午後：TAF * 夕方：TEV * 夜：TNI {#nlu-system-entities__ul_omc_grd_lpb} | | 入力例 | Smith 氏は朝に出発しました。 | | 正規化値 | TMO | | コード例 | { "name": "entity:GLOBAL.TIME", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.TIME", "subType": "PARTSOFDAY", "value": "TMO"} } | [表 : 7. GLOBAL.TIME SubType = PARTSOFDAY の使用法] {#nlu-system-entities__table_thr_wqd_lpb} ## GLOBAL.DATE_TIME システムエンティティ {#nlu-system-entities__section_rkt_pbc_3vb} DATE_TIME サブタイプは、特定の日付を正確に表す日付文字列と、時間と分を正確に表す時間文字列を返します。 {#nlu-system-entities__table_wsh_ybc_3vb__entry__2} | 使用法 | 例 | |-|-| | フォーマット | YYYY-MM-DD'T'HH:mm | | 正規表現 | \\\\d\\\\d\\\\d\\\\d-\\\\d\\\\d-\\\\d\\\\dT\\\\d\\\\d:\\\\d\\\\d | | 入力例 | Mr. Smith leaves on October 31st at 5:00 p.m. | | 正規化値 | 2022-10-31T17:00 | | コード例 | { "name": "DATE_TIME", "value": "October 31st at 5:00 p.m", "normalization": "2022-10-31T17:00","confidence": "1" } | [表 : 8. GLOBAL.DATE_TIME SubType = DATETIME の使用法] {#nlu-system-entities__table_wsh_ybc_3vb} ## GLOBAL.DURATION システムエンティティ {#nlu-system-entities__section_qhq_jrd_lpb} このエンティティは、アクティビティの期間を指定する期間文字列を返します。 {#nlu-system-entities__table_gf3_mrd_lpb__entry__2} | 使用法 | 例 | |-|-| | フォーマット | 次のいずれかになります。 * 秒：'s'ss * 分：'m'mm * 時間：'h'hh * 日：'D'DD * 週：'W'WW * 月：'M'MM * 年：'Y'YY {#nlu-system-entities__ul_dkp_qrd_lpb} | | 正規表現 | 次のいずれかになります。 * 秒：s\\\\d\\\\d * 分：m\\\\d\\\\d * 時間：h\\\\d\\\\d * 日：D\\\\d\\\\d * 週：W\\\\d\\\\d * 月：M\\\\d\\\\d * 年：Y\\\\d\\\\d {#nlu-system-entities__ul_bcb_yrd_lpb} | | 入力例 | Smith 氏は Boston に 48 時間滞在しました。 | | 正規化値 | h48 | | コード例 | { "name": "entity:GLOBAL.DURATION", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.DURATION", "value": "h48"} } | [表 : 9. GLOBAL.DURATION の使用法] {#nlu-system-entities__table_gf3_mrd_lpb} ## GLOBAL.LOCATION システムエンティティ {#nlu-system-entities__section_wpj_2sd_lpb} このエンティティは場所文字列を返します。 {#nlu-system-entities__table_wd5_cvd_lpb__entry__2} | 使用法 | 例 | |-|-| | フォーマット | 文字列値。例：Santa Clara | | 正規表現 | 適用外です。 | | 入力例 | Smith 氏は Santa Clara で働いています。 | | 正規化値 | Santa Clara | | コード例 | { "name": "entity:GLOBAL.LOCATION", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.LOCATION", "value":"Santa Clara"} } | [表 : 10. GLOBAL.LOCATION の使用法] {#nlu-system-entities__table_wd5_cvd_lpb} ## GLOBAL.PERSON システムエンティティ {#nlu-system-entities__section_b1x_jvd_lpb} このエンティティは名前文字列を返します。 {#nlu-system-entities__table_og1_nvd_lpb__entry__2} | 使用法 | 例 | |-|-| | フォーマット | 文字列値。例：Joe Smith | | 正規表現 | 適用外です。 | | 入力例 | Joe Smith は Santa Clara で働いています。 | | 正規化値 | Joe Smith | | コード例 | { "name": "entity:GLOBAL.PERSON", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.PERSON", "value":"Joe Smith"} } | [ ] {#nlu-system-entities__table_og1_nvd_lpb} ## GLOBAL.MONEY システムエンティティ {#nlu-system-entities__section_xkc_5vd_lpb} このエンティティは通貨文字列を返します。 {#nlu-system-entities__table_c1b_wvd_lpb__entry__2} | 使用法 | 例 | |-|-| | フォーマット | 文字列値。例：USD 2000 | | 正規表現 | 適用外です。 | | 入力例 | $2,000 未満のラップトップを表示してください。 | | 正規化値 | USD 2000 注: 正規化値は、ソース通貨の 3 文字の ISO 3166 国コードを使用します。 | | コード例 | { "name": "entity:GLOBAL.MONEY", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.MONEY", "value":"2000", "currency":"USD"} } | [表 : 11. GLOBAL.MONEY の使用法] {#nlu-system-entities__table_c1b_wvd_lpb} ## GLOBAL.NUMBER システムエンティティ {#nlu-system-entities__section_fn2_ywd_lpb} このエンティティは数値を返します。 {#nlu-system-entities__table_jxp_byd_lpb__entry__2} | 使用法 | 例 | |-|-| | フォーマット | 文字列値。例：5.0 | | 正規表現 | 適用外です。 | | 入力例 | 自分のアカウントで前の 5 つのトランザクションを確認したい。 | | 正規化値 | 5.0 | | コード例 | { "name": "entity:GLOBAL.NUMBER", "value": "...", "score": 1.0, "normalization": {"numericValue":"5", "normalizedValue": "5"} } | [ ] {#nlu-system-entities__table_jxp_byd_lpb} ## GLOBAL.SOFTWARE {#nlu-system-entities__section_cr2_scy_brb} ソフトウェア文字列を返します。 {#nlu-system-entities__table_oq4_vcy_brb__entry__2} | 使用法 | 例 | |-|-| | フォーマット | 文字列値。例：Java | | 正規表現 | 適用外です。 | | 入力例 | Java をインストールするにはどうすればよいですか？ | | 正規化値 | Java | | コード例 | { "name": "entity:GLOBAL.SOFTWARE", "value": "Java", "score": 0.99930537, "normalization": {"type":"entity:GLOBAL.SOFTWARE", "subType":"SOFTWARE", "value":"Java"} } | [ ] {#nlu-system-entities__table_oq4_vcy_brb} ## GLOBAL.HARDWARE {#nlu-system-entities__section_bdt_xcy_brb} ハードウェア文字列を返します。 {#nlu-system-entities__table_dfl_ycy_brb__entry__2} | 使用法 | 例 | |-|-| | フォーマット | 文字列値。例：プリンター | | 正規表現 | 適用外です。 | | 入力例 | プリンターを注文するにはどうすればよいですか？ | | 正規化値 | プリンター | | コード例 | { "name": "entity:GLOBAL.HARDWARE", "value": "printer", "score": 1.0, "normalization": {"type":"entity:GLOBAL.HARDWARE", "subType":"HARDWARE", "value":"printer"} } | [ ] {#nlu-system-entities__table_dfl_ycy_brb} ## Software システムエンティティを使用した NLU 予測結果の例 {#nlu-system-entities__section_hlp_xdy_brb} {"status":"success", "response":{ "utterance":"How do I install Java?", "intents":[ { "intentName":"test intent", "nluModelName":"ml_x_snc_global_global_268a97a9dbd23c107906265d1396191a", "score":0.90401393, "intents":[ ], "entities":[ { "name":"entity:GLOBAL.SOFTWARE", "value":"Java", "score":0.99930537, "normalization":{ "type":"entity:GLOBAL.SOFTWARE", "subType":"SOFTWARE", "value":"Java" }, "startingPosition":-1 } ] } ], "properties":{ "all:ml_x_snc_global_global_268a97a9dbd23c107906265d1396191a":"0.55", "entity:all":"0.01", "inference.sspace.time":"4", "inference.time":"33", "intent:all":"0.01", "nluPlatformLanguage":"en", "nluPlatformVersion":"rome.0" } } } ## DATE システムエンティティを使用した NLU 予測結果の例 {#nlu-system-entities__section_f4c_gxd_lpb} { "utterance": "We should meet next Sunday at Starbucks.", "intents": [ { "intentName": "intent:Desire.Desire", "score": 0.83452, "entities": [] }, { "intentName": "intent:Meeting.MeetRequest", "score": 0.8919042, "entities": [ { "entityName": "entity:Meeting.MeetRequest.Where", "value": "Starbucks", "score": 1 }, { "entityName": "entity:GLOBAL.DATE", "value": "Sunday", "normalization": { "type": "DATE", "subType": "DAY", "value": "1999-10-01" }, "score": 0.87 } ] } ] } **関連概念** * [ドメインセパレーションと 仮想エージェント](https://servicenow-prod.fluidtopics.net/Lewo3OW~vQA13_TMeyJCUQ "ドメインセパレーションは、仮想エージェント アプリケーションでサポートされています。 ドメインセパレーションでは、データ、プロセス、および管理タスクをドメインと呼ばれる論理的なグループに分けることができます。どのユーザーがデータを表示できるか、データにアクセスできるかなど、このアプリケーションのいくつかの側面を制御できます。") * [仮想エージェント インタラクションレコード](https://servicenow-prod.fluidtopics.net/P5Xqji70SlUrCvIzi~7FSg "仮想エージェント の会話が発生するたびに、インタラクションレコードは、インタラクション [interaction] テーブルで会話全体をキャプチャします。レコードには、会話で使用されるすべてのトピック要素と、ライブエージェントの転送が含まれます。") * [仮想エージェント スクリプト](https://servicenow-prod.fluidtopics.net/REB1hgd8nxeXvKa95iuQeQ "ServiceNow 仮想エージェント スクリプトのメソッドと変数を使用して、応答、トリガー、フロースクリプトなどのチャットスクリプトを記述します。変数は、ライブサポートトピックと会話のコンテキストを提供することもできます。") **関連資料** * [仮想エージェント ロール](https://servicenow-prod.fluidtopics.net/4GKzLAparb9phKHDHClMtA#VA-roles "仮想エージェントは、仮想エージェントのアドミニストレーターとして操作するユーザーに複数のロールを追加します。") * [仮想エージェント トピックの入力データタイプ](https://servicenow-prod.fluidtopics.net/lIzc7~fASmemPyUH1PPSeA "一般的に使用される Glide 仮想エージェント (com.glide.cs.chatbot) のデータタイプの入力は、スクリプトを記述せずに仮想エージェントデザイナーで定義できます。カスタムコントロールまたはトピックブロックの [開始] ノードで入力データタイプを定義します。") * [仮想エージェントの URL パラメーター](https://servicenow-prod.fluidtopics.net/iF6b22ketWYR2ORY0L4Zlg "仮想エージェントには、アドミニストレーターがインスタンス URL に追加して、ページコンテンツのレンダリング方法を制御できるさまざまなシステムパラメーターが用意されています。") * [仮想エージェントのレイテンシフィードバック](https://servicenow-prod.fluidtopics.net/n86YeDc3BRBSzsVN5dSrRw "com.glide.cs.message.processing.enabledシステムプロパティは、生成 AI 大規模言語モデル (LLM) が 仮想エージェント チャットウィジェットとNow Assistパネルで要求を処理しているときは常に要求者に通知します。")