--- 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 --- # カスタムチャット統合のデフォルトの入力リッチコントロールと出力リッチコントロール # カスタムチャット統合のデフォルトの入力リッチコントロールと出力リッチコントロール {#ariaid-title1} * リリースバージョン: Yokohama * * 更新日 2025年01月30日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：8分 入力リッチコントロールと出力リッチコントロールは、カスタムアダプター構成 \[sys_cs_custom_adapter_config\] テーブルのカスタムチャット統合にマップされる必要があります。リッチコントロールに送信トランスフォーマー実装がない場合、応答がエンドユーザーに返されず、そのユーザーのチャットエクスペリエンスが不十分になる可能性があります。 次のデフォルトのリッチコントロールは、入力および出力リッチコントロールにマップされます。uiType パラメーターは、仮想エージェントデザイナー で会話をビルドするために使用されるトピックコントロールを参照します。 {#default-rich-controls-va-cccif__table_rqm_lvn_qmb__entry__2} | リッチコントロール | 説明 | |-|-| | ActionRichControl | このコンポーネントは、会話で発生するさまざまなイベントやアクションを処理します。アクションによっては、すべてのチャネルに適用されない場合があります。たとえば、 StartSpinnerActionMsg は SMS では無視されます。 ServiceNow® 仮想エージェントは、このフレームワークで次のタイプのアクションメッセージを生成します。カスタムチャットインターフェイスは、特定のアクションメッセージタイプのみを認識します。 * SeparatorActionMsg \|\|actionMsg instanceof * SystemActionMsg \|\|actionMsg instanceof * TopicFinishedActionMsg \|\|actionMsg instanceof * SwitchToVirtualAgentActionMsg \|\|actionMsg instanceof * SwitchConversationActionMsg \|\|actionMsg instanceof * ChatSubHeaderActionMsg \|\|actionMsg instanceof * StartSpinnerActionMsg \|\|actionMsg instanceof EndSpinnerActionMsg * SubscribetoSupportQueue \|\|actionMsg instanceof * SubscribeToChatPresence \|\|actionMsg instanceof * SwitchToLiveAgentActionMsg \|\|actionMsg instanceof {#default-rich-controls-va-cccif__ul_odf_ykm_hmb} ActionRichControl は、これらのメッセージを actionMsg 要素内で折り返します。したがって、ActionRichControl の 1 つの送信トランスフォーマーで、これらのメッセージをすべて処理できます。このコンポーネントには着信トランスフォーマーは必要ありません。 | | agentInfo パラメーター | リッチコントロールがライブエージェントから送信される場合、agentInfo 属性がリッチコントロールに追加されます。 例： { uiType: "someType", group: "someGroup" agentInfo: { sentFromAgent: true } // please note that this object may contain more info in subsequent releases. ... } | | DefaultPicker | [ファイルピッカー](https://servicenow-prod.fluidtopics.net/Q~xXNKBqzCr511uoho4aVA "仮想エージェントトピックでファイルピッカーのユーザー入力コントロールを使用して、ユーザーに画像または任意タイプのファイルをアップロードするよう求めます。ユーザーが画像ファイルをアップロードすると、画像はすぐに仮想エージェントクライアントに表示されます。")、トピックピッカー、および[ブール](https://servicenow-prod.fluidtopics.net/X~lAOSqzrSITlzHzE9W23g "仮想エージェントトピックでブールユーザー入力コントロールを使用して、ユーザーに「はい / いいえ」プロンプトを表示します。")コントロールにマップします。 例： { uiType: "Picker/TopicPicker/Boolean", group: "DefaultPicker", nluTextEnabled: true/false, promptMsg: "", // optional (needed for TopicPicker) label: "The question for the list", // always filled itemType: "Picture/List" // needed to user key to expect picture attached options: [ { label: "display label prompt", value: "the value required to satisfy the question", description: "a description of value_1 item" attachment: "www.foo", enabled: true/false }, ... ] } オプションの order パラメーターを使用すると、昇格されたトピックを表示する順序を指定できます。たとえば、次のようになります： "options": [ { label: "Check IT Ticket Status", value: "55720b465bf0201024f11fc40a81c72d", order: 100, enabled: true }, { label: "Live Agent Support", value: "ce2ee85053130010cf8cddeeff7b12bf", order: 200, enabled: true }, { label: "Open IT Ticket 2", value: "2a46cffbc7602010v088bbf603c260a7", order: 300, enabled: true } ] | | DefaultText | [入力テキスト](https://servicenow-prod.fluidtopics.net/N6miRZHIAxXKVguMG6~WHg "仮想エージェントトピック内のテキストユーザー入力コントロールは、ユーザーにテキスト文字列の入力を求めます。")、[出力テキスト](https://servicenow-prod.fluidtopics.net/IcpV6b41U5ukQUvd5gZ2XQ "仮想エージェントトピックでテキストボット応答コントロールを使用して、ボット応答をテキストとして表示します。テキストエディターコントロールを使用して、テキストボット応答の書式を設定できます。たとえば、テキストを太字または斜体にしたり、リンク、箇条書き、絵文字を含めたりすることができます。")、およびファイルのアップロードコントロールにマップします。 例： { uiType: "InputText/OutputText/FileUpload/Picture", group: "DefaultText", required: true/false, nluTextEnabled: true/false, itemType: "file/image/inputtext/outputtext", maskType: "SECURE/SENSITIVE/NONE" // null except for InputText/OutputText label: "The Question?" } | | DefaultDate | [日付/時刻](https://servicenow-prod.fluidtopics.net/iXTnduUQSMtWs82a80k1Uw "日時ユーザー入力コントロールを仮想エージェントトピックで使用し、ユーザーがカレンダーの日付、時刻 (時および分)、またはその両方を選択できるようにします。")コントロールにマップします。 { uiType: "Date/DateTime/Time", group: "DefaultDate", required: true/false, nluTextEnabled: true/false, label: "The Question?" } | | DefaultOutputLink | マップ先[リンク応答](https://servicenow-prod.fluidtopics.net/5zIsqkiBn45upKiNZiYilw "仮想エージェント トピックでリンクボット応答コントロールを使用して、ボット応答を表示します。応答には、アイテムへの単一の URL リンクまたは最大 3 つのアイテムへの複数の URL リンクのいずれかを含むヘッダープロンプトを含めます。")コントロール。 例： { uiType: "OutputLink", group: "DefaultOutputLink", label: "link label", header: "link header", type: "link", value: { action: "www.foo", } } } | | DefaultOutputImage | マップ先[画像の応答](https://servicenow-prod.fluidtopics.net/whD~fcwOslx6f6nrEZDpFw "仮想エージェント トピックで画像ボット応答コントロールを使用して、URL リンクから画像をアップロードして表示します。イメージのアスペクト比によって、ボット チャット バブルで画像のサイズがどのようになるかが決まります。")コントロール。 例： { uiType: "OutputImage", group: "DefaultOutputImage", value: "www.foo" } | | DefaultOutputCard | マップ先[カード応答](https://servicenow-prod.fluidtopics.net/DEaNnFfm5JUhDmEJPTYtJw "仮想エージェントトピックでカードボット応答コントロールを使用して、インスタンス上のレコードから選択した情報と、動画や画像などのリッチコンテンツをアップロードして表示します。")コントロール。 例： { uiType: "OutputCard", group: "DefaultOutputCard", templateName: "Card", data: "some json data string" } | | DefaultOutputHtml | マップ先 [HTML 応答](https://servicenow-prod.fluidtopics.net/JKFU4xOHdi1WvoPsZCAZvA "HTML ボット応答コントロールを使用して、仮想エージェントボット応答で静的 HTML テキストを表示します。")コントロール。 例： { uiType: "OutputHtml", group: "DefaultOutputHtml", style: "inline", height: 100, width: 100, value: "
html
" } | | DefaultOutputTable | マップ先[テーブル応答](https://servicenow-prod.fluidtopics.net/nlmKfaKLDJkuzoo3orWukQ "仮想エージェントトピックでテーブルボット応答コントロールを使用して、ボット応答をテーブルとして表示します。")コントロール。 例： { uiType: "OutputTable", group: "DefaultOutputTable", label: "Table Title", headers: ["Column 1", "Column 2"], navigationBtnLabel: "See next", data: [ ["foo1", "foo2"], ["bar1", "bar2"] ] } | | DefaultGroupedPartsOutputControl | マップ先[複数回答](https://servicenow-prod.fluidtopics.net/uCzKHmD7ii~ZpRKkXq64pQ "仮想エージェント トピックで複数回答ボット応答コントロールを使用し、2 つ以上の出力を順次表示します。出力は、テキスト、画像、リンク、または HTML にすることができます。ユーザーは、用意されたナビゲーションボタンを使用して、ある出力から次の出力に移動できます。")コントロール。 例： { uiType: "GroupedPartsOutputControl", group: "DefaultGroupedPartsOutputControl" groupPartType: "Link", header: "header message", values: [ { action: "www.foo", description: "description", label: "link_1 label", context: "ITSM" }, ... ] } | | DefaultMultiPartOutput | マップ先[複数回答](https://servicenow-prod.fluidtopics.net/uCzKHmD7ii~ZpRKkXq64pQ "仮想エージェント トピックで複数回答ボット応答コントロールを使用し、2 つ以上の出力を順次表示します。出力は、テキスト、画像、リンク、または HTML にすることができます。ユーザーは、用意されたナビゲーションボタンを使用して、ある出力から次の出力に移動できます。")コントロール。 例： { uiType: "MultiPartOutput", group: "DefaultMultiPartOutput" navigationBtnLabel: "Go next", content: { uiType: "OutputHtml", style: "inline", type: "html", height: 100, width: 100, value: "
html
" } } | | DefaultCustomControl | マップ先[カスタムコントロール](https://servicenow-prod.fluidtopics.net/UjAxWSLbnU1ukO8rKgVY5A "仮想エージェントトピックまたはトピックブロックでカスタムコントロールユーティリティを使用して、カスタム入力コントロールやカスタム応答コントロールを参照します。カスタムコントロールは、仮想エージェントデザイナーで提供されるコントロールを補完します。")。 例： { uiType: "CustomControl", group: "DefaultCustomControl", name: "The name of the Custom Control (sys_cs_custom_control.name)", required: true/false, uxComponentDefinitionSysId: "seismicComponentId" // or null if not isInput: true/false, // whether to wait for a response value or if just output serializedControlData: "User defined JSON from generateControlData function"; } | [表 : 1. デフォルトの入力リッチコントロールと出力リッチコントロール] {#default-rich-controls-va-cccif__table_rqm_lvn_qmb}