本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 測試和查詢多模式知識庫
<a name="kb-multimodal-test-and-query"></a>

擷取多模式內容之後，您可以使用主控台或 API 來測試和查詢您的知識庫。可用的查詢類型取決於您選擇的處理方法。

------
#### [ Console ]

**從主控台測試您的知識庫**

1. 從您的知識庫詳細資訊頁面，捲動至**測試知識庫**區段。

1. 選擇您的查詢類型：
   + **僅限標準擷取：**從單一知識庫中的資料來源查詢和擷取資訊。
   + **擷取和回應產生：**使用基礎模型查詢單一知識庫，並根據擷取的結果產生回應。
**注意**  
如果您有多模態內容，則必須使用 BDA 剖析器來擷取和產生回應。

1. 視需要設定其他選項：
   + **來源區塊：**指定要傳回的來源區塊數量上限
   + **搜尋類型：**選取搜尋類型以自訂查詢策略
   + **中繼資料篩選條件：**套用篩選條件以縮小搜尋結果
   + **護欄：**選取現有的護欄或建立新的護欄

1. 輸入文字查詢或上傳映像 （僅限Nova 多模態內嵌） 以搜尋您的多模態內容。使用附件按鈕上傳影像以進行視覺相似性搜尋。

1. 檢閱結果，其中包括：
   + 擷取具有相關性分數的內容區塊
   + 來源檔案參考和時間戳記 （適用於音訊/視訊）
   + 中繼資料，包括檔案類型和處理資訊
   + 對於多媒體內容，播放控制項會根據擷取的時間戳記使用自動區段定位

------
#### [ API ]

下列範例示範如何使用 Amazon Bedrock Agent 執行期 API 以程式設計方式查詢您的多模式知識庫：

**文字查詢範例**  
使用文字輸入搜尋：

```
aws bedrock-agent-runtime retrieve \
--knowledge-base-id <knowledge-base-id> \
--retrieval-query text="robot automation in manufacturing"
```

**影像查詢範例 （僅限Nova 多模態內嵌）**  
使用上傳的映像進行搜尋：

```
{
    "knowledgeBaseId": "<knowledge-base-id>",
    "retrievalQuery": {
        "imageQuery": {
            "inlineContent": {
                "mimeType": "image/jpeg",
                "data": "<base64-encoded-image>"
            }
        }
    }
}
```

------

## 支援的查詢類型
<a name="kb-multimodal-query-types"></a>

**文字查詢**  
同時支援 Nova 多模式內嵌和 BDA 方法。使用自然語言文字搜尋，尋找所有媒體類型的相關內容。

**映像查詢**  
僅支援 Nova 多模式內嵌。上傳映像以在知識庫中尋找視覺上相似的內容。

## 了解回應中繼資料
<a name="kb-multimodal-response-metadata"></a>

多模式查詢回應包含多媒體內容的其他中繼資料：

**來源屬性**  
原始檔案位置 (sourceUri) 和多模態儲存位置 (supplementalUri)，以提供可靠的存取

**暫時中繼資料**  
音訊和視訊區段的開始和結束時間戳記，可精確導覽相關內容

**內容類型資訊**  
檔案格式、處理方法和模式指標，可協助應用程式適當處理不同的內容類型

**向量資料庫中繼資料結構**  
處理和儲存多模態內容時，向量資料庫中會使用下列中繼資料結構：
+ **文字欄位：**對於使用 Nova Multimodal Embeddings 處理的多媒體檔案，此欄位包含空字串，因為內容內嵌為原生多媒體而非文字
+ **中繼資料欄位：**包含結構化資訊，包括來源詳細資訊和相關內容參考：

  ```
  {
    "source": {
      "sourceType": "S3",
      "s3Location": {
        "uri": "s3://source-bucket/path/to/file.mp4"
      }
    },
    "relatedContent": [{
      "type": "S3",
      "s3Location": {
        "uri": "s3://multimodal-storage-bucket/processed/file.mp4"
      }
    }]
  }
  ```
+ **自動建立的欄位：**用於篩選和識別的其他欄位：
  + `x-amz-bedrock-kb-source-uri`：用於篩選操作的原始來源 URI
  + `x-amz-bedrock-kb-data-source-id`：用於追蹤內容原始伺服器的資料來源識別符
  + `x-amz-bedrock-kb-chunk-start-time-in-millis`：音訊和視訊區段的啟動時間戳記，以毫秒為單位
  + `x-amz-bedrock-kb-chunk-end-time-in-millis`：音訊和視訊區段的結束時間戳記，以毫秒為單位
  + `x-amz-bedrock-kb-source-file-mime-type`：來源檔案的 MIME 類型
  + `x-amz-bedrock-kb-source-file-modality`：來源檔案的模式 (TEXT、IMAGE、AUDIO、VIDEO)

**重要**  
應用程式必須使用提供的時間戳記，從音訊和視訊檔案擷取和播放特定區段。知識庫會傳回完整檔案的參考，而不是預先分段的剪輯。