透過搜尋分析取得洞見

注意

功能支援會因索引類型和正在使用的搜尋 API 而有所不同。若要查看您正在使用的索引類型和搜尋 API 是否支援此功能，請參閱索引類型。

您可以使用 Amazon Kendra 搜尋分析來深入了解搜尋應用程式如何成功或不成功地協助您的使用者尋找資訊。

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

您可以在自己的自訂儀表板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。您也可以在導覽面板上選取分析，在主控台中檢視此指標。

零點擊率

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

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

零搜尋結果率

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

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

即時回答率

傳回即時回答或常見問答集的查詢比例。這可協助您了解即時答案在提供資訊中的角色。

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

點按零次的熱門查詢

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

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

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

零搜尋結果的熱門查詢

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

指標包括查詢導致零搜尋結果的次數、查詢零搜尋結果的比例，以及查詢相較於所有查詢的搜尋次數比例。

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

在文件上按一下

搜尋結果中最多點擊的前 100 個文件。這可協助您了解在使用者查詢資訊時，哪些文件或搜尋結果與您的使用者最相關。

指標包括按一下文件的次數、從使用者收到的類似文件數量（翻滾）、從使用者收到的不喜歡文件數量（翻滾）。

若要使用 GetSnapshots API 在文件上按一下上方擷取資料，請將指定metricType為 DOCS_BY_CLICK_COUNT。您也可以在主控台的導覽面板上選取分析，然後選取查詢清單下的按一下前文件，以在主控台中檢視此指標。

查詢總數

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

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

文件總數

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

若要使用 GetSnapshots API 擷取總文件上的資料，請將指定metricType為 AGG_QUERY_DOC_METRICS。您也可以在導覽面板上選取分析，在主控台中檢視此指標。

擷取指標資料的範例

下列程式碼是擷取上個月熱門查詢資料的範例。

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% 的即時回答率和高點擊率可提供有關可用區域的詳細資訊，作為回答的一部分。這表示您在此區域的產品或服務具有興趣和需求。

視覺化和報告搜尋分析

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

主控台提供指標的儀表板，您可以在其中選取您有興趣檢視的圖形和頂端清單。您可以在分析首頁上選取匯出，以 CSV 格式匯出儀表板上顯示的指標。您可以在商業文件或簡報中包含這些報告。

您可以視覺化下列指標：