検索でクエリを使用する

インサイトセクションまたはNLU受信トレイで会話を確認する、あるいはスキルストアでスキルをブラウズするときは、検索バーを使用して結果を絞り込むことができます。自然言語を使用して基本的な検索を実行することも、クエリ言語でクエリを作成することもできます。この種のクエリは、次の3つの基本的な部分で構成されています。

  • パラメーター
  • 演算子

簡単なクエリを作成するには、パラメーターと目的の値から始めて、その間に適切な演算子を配置します。追加の演算子を使用して2つ以上の単純なクエリを組み合わせると、より複雑なクエリを作成できます。

Akelaは、エージェントへの引き継ぎで終了したすべての会話を見つけたいと考えています。彼女は、パラメーターaction 、値のハンドオーバー、およびoperator =を使用します。

彼女の完全なクエリは次のようになります。

action = handover

残念ながら、このクエリは、Akelaが簡単に実行できないほど多くの結果を返しました。彼女は、この検索を絞り込んで、過去2週間の結果のみを表示することにしました。彼女はオリジナルに2番目の簡単なクエリを追加し、それらを演算子ANDと組み合わせます。

彼女の完全なクエリは次のようになります。

action = handover AND datetime > -14 days

サポートされているパラメーターと値

次のテーブルは、対応しているすべてのパラメーターとその使用方法、およびボットビルダーのどのセクションがそれぞれのパラメーターに対応しているかについての詳細です。

パラメーター 詳細 以下がサポートされています。
アクション

その名前ボットビルダーアクションに使用します。サポートされている値は次のとおりです。

  • 統合
  • ハンドオーバー
  • core_fallback
  • fill_slot
bot_message_count 会話に含まれるアウトバウンドメッセージの数。このパラメーターの値は、数値形式である必要があります。
カテゴリー リストアップされたボットスキルを、タグ付けされたカテゴリーでフィルタリングできるようにします。
チャネル

チャネルの名前、タイプ、またはID。設定したチャネルの結果のみが表示されますDigital Experience

サポートされている値は次のとおりです。

  • apple-business
  • facebook-dm
  • twitter-dm
  • vkontakte-dm
  • live-chat
  • チャット
  • slack
  • sms
  • チーム
  • telegram
  • viber
  • whatsapp
  • talk-to-your-bot
  • talk-to-your-bot-public
会話 会話のID。
顧客 顧客の名前またはID。
customer_contact コンタクトID(別名ケース ID)からCXoneDigital Experience
customer_message_count 会話に含まれるインバウンドメッセージの数。このパラメーターの値は、数値形式である必要があります。
日付

特定の時間を含まない日付。このパラメーターを使用すると、時間の任意の値は自動的に00:00:00に設定されます。このパラメーターの値は、絶対値または相対値にすることができます。

日付時刻

日時。このパラメーターの値は、絶対値または相対値にすることができます。

絶対日付でサポートされる形式は次のとおりです。

  • アメリカ合衆国— 1月2日は数値で01/02/2023と書かれています
  • ヨーロッパ— 1月2日は02/01/2023と数値で書かれています
  • 書面形式— 2023年1月2日または2023年1月2日

相対日付でサポートされている値は次のとおりです。

  • -(減算)—秒、分、日、月、年
  • +(追加)—秒、分、日、月、年
  • previous — 秒、分、時、日、月、年、平日、週、2週間、月曜日または月の形式の日の名前
  • next — 秒、分、時、日、月、年、平日、週、2週間、月曜日または月の形式の日の名前
  • tomorrow (now + 24時間)
  • yesterday (now - 24時間)
  • noon
  • afternoon
  • midnight
  • last — 月曜日または月曜日の形式の日の名前
  • first day of this/next — month
  • last day of this/next — month
全文 クエリ言語を使用してクエリを作成している場合、このパラメーターを使用すると、自然言語を追加できます。

インテント

作成したインテントの名前。

intent_confidence

自信があるボットビルダーインテントが正しく分類されているということです。フォールバックを設計する場合と同様に、サポートされる値の範囲は0〜0.99です。

is_reviewed 会話のステータスを確認します。このパラメーターの値は、 true (レビュー済み)またはfalse (レビュー済み)です。
言語 リストアップされたボットスキルを、設定されている言語でフィルタリングできるようにします。
message_count 会話に含まれる合計メッセージの数。この数には、インバウンドメッセージとアウトバウンドメッセージの両方が含まれます。このパラメーターの値は、数値形式である必要があります。
タグ 適用されているまたは適用されていないタグに基づいて会話を表示します。このパラメーターは利用可能なすべての演算子で機能します。

サポートされている演算子

次のテーブルは、対応しているすべての演算子を表示し、その意味を説明しています。

演算子 説明
= 「等しい」を表します
!= 「等しくない」を表します
< 「未満」を表します
<= 「以下」を表します
> 「より大きい」を表します
>= 「以上」を表します
AND

両側の値が一致する会話を返します。

たとえば、次のクエリは、エージェントに渡されたSMS会話を返します。

channel = sms AND action = handover

または

いずれかの側からの少なくとも1つの値が一致する会話を返します。

たとえば、次のクエリはすべてのSMS会話とすべてのWhatsApp会話を返します。

channel = sms OR channel = whatsapp

NOT

値が一致しない会話を返します。

たとえば、次のクエリは、SMSチャネルになかったすべての会話を返します。

NOT channel = sms

IN

値がリストの少なくとも1つのオプションと一致する会話を返します。

たとえば、次のクエリはSMSおよびWhatsAppチャネルのすべての会話を返します。

channel IN (sms, whatsapp)

( )

複雑なクエリを整理し、括弧内の項目が最初に処理されるという一般的な数学の概念に基づいて優先順位を割り当てるのに役立ちます。

たとえば、次のクエリは、エージェントに渡されたSMS会話と、4つを超えるメッセージを含むWhatsApp会話の両方を返します。

(action = handover AND channel = sms) OR (message_count < 4 AND channel = whatsapp)

追加のクエリー例

今日からのすべての会話:

datetime > midnight

特定の日のすべての会話:

datetime >= 2nd Jan 2021 AND datetime < 3rd Jan 2021

ライブエージェントに引き渡されたSMSチャネルでのすべての会話が発生しました。

channel = sms AND action = handover

SMSまたはWhatsappチャネルからのすべての会話:

channel = sms OR channel = whatsapp

過去30日間のWhatsAppまたはSMSチャネルでのすべての会話は、放棄されたと見なされるか(3メッセージ未満)、ライブエージェントにエスカレーションされました。

channel IN (whatsapp, sms) AND datetime > -30 days AND (message_count < 3 OR action = handover)