透過搜尋分析獲得洞察

您可以使用 Amazon Kendra 搜尋 Analytics 來深入瞭解搜尋應用程式如何成功或未成功協助使用者尋找資訊。

Amazon Kendra Analytics (分析) 提供使用者如何與搜尋應用程式互動的快照，以及搜尋應用程式設定的有效性。您可以使用 GetSnapshotsAPI 或在主控台的導覽面板上選取 Analytics 來檢視指標資料。

您可以在自己的定制儀表板GetSnapshots上呈現由生成的數據。或者，您可以使用控制台中提供的指標儀表板，其中包括視覺化圖形。透過視覺化儀表板，您可以尋找一段時間內的使用者行為趨勢或模式，或是顯示搜尋應用程式組態的問題。例如，顯示每天查詢數量一致且穩定增加的折線圖可能表示採用率和使用量有所增加。另一方面，突然下降可能表明存在必須調查的問題。

您可以使用指標在不同資料點之間建立連線，以解決使用者如何查詢資訊或發現商機的問題。例如，文檔「AI 如何工作？」是搜尋結果中點擊次數最多的文件，搜尋最多的查詢是「機器學習如何運作？」。這會通知您使用者使用的慣用條款和語言。您可以將這些字詞整合到文件中，或針對這些字詞使用自訂同義詞，讓您的文件更容易搜尋到您的使用者。

搜尋量度

有 10 個指標可用於分析搜尋應用程式的效能或使用者搜尋的資訊。若要擷取指標資料，請指定呼叫時要擷取的測量結果資料的字串名稱GetSnapshots。

您也必須提供時間間隔或時間範圍，才能檢視測量結果資料。時間間隔會使用索引的時區。您可以在下列時間範圍中檢視資料：

THIS_WEEK: 本週，從星期日開始，在目前日期的前一天結束。
ONE_WEEK_AGO: 前一週，從星期日開始，在下一個星期六結束。
TWO_WEEKS_AGO: 前一週的前一週，從星期日開始，在下一個星期六結束。
THIS_MONTH：當月，從當月的第一天開始，到目前日期的前一天結束。
ONE_MONTH_AGO：上個月，從每月的第一天開始，到該月的最後一天結束。
TWO_MONTHS_AGO: 上個月的前一個月，從該月的第一天開始，到該月的最後一天結束。

在控制台中，支持的時間窗口是本週，上週，本月，上個月。

點擊率

在搜尋結果中導致點進至文件的查詢比例。這可協助您瞭解搜尋應用程式組態是否可協助您的使用者尋找與其查詢相關的資訊。對於傳回即時答案的查詢，使用者可能不需要按一下文件以取得更多資訊。如需詳細資訊，請參閱即時答案率。您必須致電SubmitFeedback以確保收集點擊回饋。

若要使用 GetSnapshots API 擷取點進率的資料，請指定metricType為AGG_QUERY_DOC_METRICS。您也可以在主控台中選取導覽面板上的 Analytics 來檢視此量度。

零點擊率

在搜尋結果中導致零點擊的查詢比例。這可以幫助您了解內容中的差距，從而提供無關的搜索結果。對於傳回即時答案的查詢，使用者可能不需要按一下文件以取得更多資訊。如需詳細資訊，請參閱即時答案率。此外，您的搜尋設定 (例如調整組態) 也會影響搜尋結果中傳回文件的方式。

若要使用 GetSnapshots API 擷取零點擊率的資料，請指定metricType為AGG_QUERY_DOC_METRICS。您也可以在主控台中選取導覽面板上的 Analytics 來檢視此量度。

零搜索結果率

導致搜尋結果為零的查詢比例。這可以幫助您了解內容中的差距，而不會提供相關的搜索結果。

若要使用 GetSnapshots API 擷取搜尋結果率為零的資料，請指定metricType為AGG_QUERY_DOC_METRICS。您也可以在主控台中選取導覽面板上的 Analytics 來檢視此量度。

即時答案率

返回具有即時答案或常見問題解答的查詢比例。這有助於您了解即時答案在提供信息方面的作用。

若要使用 GetSnapshots API 擷取即時回答率的資料，請指定metricType為AGG_QUERY_DOC_METRICS。您也可以在主控台中選取導覽面板上的 Analytics 來檢視此量度。

零點擊的熱門查詢

在搜尋結果中導致零點擊的前 100 名查詢。這可協助您瞭解內容中的任何差距，因為缺少與某些查詢相關的文件，或者您的搜尋應用程式組態會傳回不相關的搜尋結果。對於傳回即時答案的查詢，使用者可能不需要按一下文件以取得更多資訊。如需詳細資訊，請參閱即時答案率。

指標包括查詢導致零點按次數的次數、查詢的零點按比例、查詢的即時答案比例，以及查詢前 10 個搜尋結果的平均信賴度。

若要使用 GetSnapshots API 以零點選的方式擷取熱門查詢的資料，請指定metricType為QUERIES_BY_ZERO_CLICK_RATE。您也可以在主控台中選取導覽面板上的 Analytics，然後選取 [查詢清單] 下的 [前零點擊查詢]，在主控台中檢視此量度。

搜尋結果為零的熱門查詢

導致搜尋結果為零的前 100 個查詢。這有助於您了解內容中的任何差距，其中沒有與某些查詢相關的文檔。或者，您的使用者可能會使用可能不會導致搜尋結果的特殊字詞進行查詢，並提示您建立自訂同義字來處理此問題。

量度包括查詢導致搜尋結果零的次數、查詢的搜尋結果為零的比例，以及搜尋查詢與所有查詢相比的次數比例。

若要使用 GetSnapshots API 擷取搜尋結果為零的熱門查詢資料，請指定metricType為QUERIES_BY_ZERO_RESULT_RATE。您也可以在主控台中選取導覽面板上的 Analytics，然後選取 [查詢清單] 下的 [前零結果查詢]，在主控台中檢視此量度。

點擊頂部的文檔

搜尋結果中點擊次數最多的 100 個文件。這有助於您瞭解哪些文件或搜尋結果在使用者查詢資訊時最相關。

指標包括文件被點擊的次數、文件從使用者收到的喜歡次數 (豎起大拇指)、文件從使用者那裡收到的不喜歡次數 (豎起大拇指)。

要使用 GetSnapshots API 檢索頂部單擊文檔的數據，請指定metricType為DOCS_BY_CLICK_COUNT。您也可以在主控台中檢視此量度，方法是選取主控台中導覽面板上的 Analytics，然後選取 [查詢清單] 下的 [點選最多的文件]。

查詢總數

您的使用者搜尋的查詢總數。這可協助您瞭解使用者與搜尋應用程式的互動程度。

若要使用 GetSnapshots API 擷取總查詢的資料，請指定metricType為AGG_QUERY_DOC_METRICS。您也可以在主控台中選取導覽面板上的 Analytics 來檢視此量度。

文件總數

索引中的文件總數。這有助於您將索引的大小與查詢總數進行比較，以檢查查詢量是否有適當數量的文檔。

若要使用 GetSnapshots API 擷取全部文件的資料，請指定metricType為AGG_QUERY_DOC_METRICS。您也可以在主控台中選取導覽面板上的 Analytics 來檢視此量度。

擷取測量結果資料的範例

下列程式碼是擷取上個月最常用查詢資料的範例。

Console

若要擷取上個月的前幾個查詢

在左側導覽窗格的 [索引] 下，選取您的索引，然後選取 [分析]。
在「分析」頁面上，選擇「本週」按鈕，將用於檢索數據的時間窗口更改為上個月。
在「分析」頁面的「查詢清單」下，選取「熱門查詢」。

CLI

若要擷取上個月的前幾個查詢


aws kendra get-snapshots \
--index-id index-id \
--interval "ONE_MONTH_AGO" \
--metric-type "QUERIES_BY_COUNT"

Python

若要擷取上個月的前幾個查詢


import boto3

kendra = boto3.client("kendra")

index_id = "index-id"
interval = "ONE_MONTH_AGO"
metric_type = "QUERIES_BY_COUNT"

snapshots_response = kendra.get_snapshots(
    IndexId = index_id,
    Interval = interval,
    MetricType = metric_type
)

print("Top queries data: " + snapshots_response["snapshotsData"])

Java

若要擷取上個月的前幾個查詢


package com.amazonaws.kendra;

import software.amazon.awssdk.services.kendra.KendraClient;
import software.amazon.awssdk.services.kendra.model.GetSnapshotsRequest;
import software.amazon.awssdk.services.kendra.model.GetSnapshotsResponse;

public class TopQueriesExample {
    public static void main(String[] args) {
        KendraClient kendra = KendraClient.builder().build();

        String indexId = "indexID";
        String interval = "ONE_MONTH_AGO";
        String metricType = "QUERIES_BY_COUNT";

        GetSnapshotsRequest getSnapshotsRequest = GetSnapshotsRequest
            .builder()
            .indexId(indexId)
            .interval(interval)
            .metricType(metricType)
            .build();

        GetSnapshotsResponse getSnapshotsResponse = kendra.getSnapshots(GetSnapshotsRequest);

        System.out.println(String.format("Top queries data: ", getSnapshotsResponse.snapshotsData()))

從指標到可行的洞察

可操作的見解是從原始數據中提取的有意義的信息片段，用於指導您的行動或決策。要從指標中提取含義並使用它們來推動可行的見解，重要的是不僅要隔離查看指標，還要在指標之間建立連接。

例如，無點擊次數的最佳查詢是「目前有哪些地區可用？」。但是，它也具有 100％的即時答案率。這表明您的使用者會收到此問題的答案，而不需要按一下搜尋結果或提供可用區域資訊的文件。如果您單獨查看零點擊，則無法獲得完整的故事，並且可能會對搜索應用程序配置在處理此查詢時的成功做出錯誤的結論。

另一個可操作洞察的例子是發現商機。企業通常會尋找通過分析搜索指標來增加客戶的機會。點擊次數最多的文檔是「可用區域」。除此之外，大多數搜尋最熱門的查詢都與 Oceanic 地區產品可用性相關問題，其中 100% 即時回答率和較高的點擊率，以取得有關可用區域的更多資訊，作為答案的一部分。這表明在這個地區對您的產品或服務有興趣和需求。

視覺化和報告搜尋分析

有五個指標包含趨勢資料，供您視覺化並尋找一段時間內的趨勢或模式。如果您使用主控台，則會提供趨勢資料的圖形。如果您使用 API，您可以擷取趨勢資料以建立自己的圖形或視覺效果。控制台中的大多數圖表都會在您選擇的時間範圍內繪製每日數據點。

控制台提供指標的儀表板，您可以在其中選擇您感興趣查看的圖形和頂級列表。您可以選取 Analytics (分析) 首頁上的「匯出」，以 CSV 格式匯出儀表板上顯示的指標。您可以在業務文件或簡報中包含這些報告。

您可以視覺化以下指標：