透過搜尋分析取得洞見

注意

功能支援會因索引類型和正在使用的搜尋 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_COUNT。您也可以在主控台的導覽面板上選取分析，然後選取查詢清單下的熱門查詢，以在主控台中檢視此指標。

零點擊的熱門查詢

在搜尋結果中導致零次點擊的前 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

擷取上個月的熱門查詢

1. 在左側導覽窗格中的索引下，選取您的索引，然後選取分析。

2. 在分析頁面上，選取本週按鈕，將擷取資料的時間範圍變更為上個月。

3. 在分析頁面的查詢清單下，選取熱門查詢。

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 格式匯出儀表板上顯示的指標。您可以在商業文件或簡報中包含這些報告。

您可以視覺化下列指標：

查詢圖表總數

每日發出查詢數量的折線圖。圖形可協助您視覺化每日使用者互動中的模式。一些範例包括使用者參與度的穩定增加或減少，或由於搜尋應用程式當機或網站發生問題而導致的急劇下降至 0 個查詢。

如果您使用 API，您可以透過指定 來擷取這些資料TREND_QUERY_DOC_METRICS。您可以使用資料來建立自己的圖形，或使用主控台中提供的圖形。

點擊率圖表

每日點擊次數比例的折線圖。圖形可協助您以每日點擊率視覺化模式。一些範例包括點擊率穩定增加或減少，或即時答案減少可能會影響點擊率增加。

如果您使用 API，您可以透過指定 來擷取這些資料TREND_QUERY_DOC_METRICS。您可以使用資料來建立自己的圖形，或使用主控台中提供的圖形。

零點擊率圖表

每日零次點擊比例的折線圖。圖形可協助您以每日零點擊率視覺化模式。一些範例包括零點擊率穩定增加或減少，或即時答案增加，可能會影響零點擊增加。

如果您使用 API，您可以透過指定 來擷取這些資料TREND_QUERY_DOC_METRICS。您可以使用資料來建立自己的圖形，或使用主控台中提供的圖形。

零搜尋結果率圖表

每日零搜尋結果比例的折線圖。圖形可協助您將模式視覺化為每日零搜尋結果率。一些範例包括零搜尋結果率穩定增加或減少，或索引中可能影響零搜尋結果增加的文件數量大幅減少。

如果您使用 API，您可以透過指定 來擷取這些資料TREND_QUERY_DOC_METRICS。您可以使用資料來建立自己的圖形，或使用主控台中提供的圖形。

即時回答率圖表

查詢比例的折線圖，其中包含即時答案或傳回的常見問答集。圖形可協助您以每日即時回答率視覺化模式。一些範例包括問題回答類型查詢的穩定增加或減少，或可能影響即時答案增加的點擊率減少。

如果您使用 API，您可以透過指定 來擷取這些資料TREND_QUERY_DOC_METRICS。您可以使用資料來建立自己的圖形，或使用主控台中提供的圖形。