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

# amazon-opensearch-service 技能
<a name="amazon-opensearch-service-skill"></a>

`amazon-opensearch-service` 是適用於 的 Agent Toolkit 中的一項技能 AWS ，可將 Amazon OpenSearch Service 專業知識直接帶入您的 AI 編碼代理程式。技能是精選的指示、指令碼和參考資料套件，可協助客服人員正確完成任務 – 封裝模型原本不具備的網域知識和最佳實務。只有當您的請求與 OpenSearch 有關時，代理程式才會載入技能，因此它會新增功能，而不會拖慢代理程式在不相關的工作上的速度。

此技能適用於受管 OpenSearch Service 網域和 OpenSearch Serverless 集合。

## 功能
<a name="opensearch-skill-capabilities"></a>

技能會將每個請求路由到五個功能之一。

### 移轉
<a name="opensearch-skill-migration"></a>

規劃從 Solr、Elasticsearch 或自我管理的 OpenSearch 遷移至 Amazon OpenSearch Service 或 Serverless。此技能會評估相容性、翻譯結構描述和查詢、建議執行個體類別、計數和碎片數學，並概述切換方法。

```
Assess my Solr 8 catalog for migration to OpenSearch Service
```

**注意**  
技能規劃遷移；不會移動資料。使用 Amazon OpenSearch Service 的遷移助理進行歷史回填和即時切換。

### 作業
<a name="opensearch-skill-operations"></a>

佈建和管理網域和集合 – 生命週期、版本升級、儲存層 （包括 UltraWarm 和 OR1)、精細存取控制和監控。

```
Provision a production OpenSearch Service domain with three Availability Zones
```

### 搜尋
<a name="opensearch-skill-search"></a>

組建關鍵字 (BM25)、向量、語意、混合和 RAG 搜尋。此技能有助於索引組態、k-NN 引擎選擇 (FAISS HNSW 與 Lucene)，以及用於內嵌的 Amazon Bedrock 連接器，並包含查詢 DSL 範例。

```
Build a hybrid search application with OpenSearch and Bedrock embeddings
```

### 日誌分析
<a name="opensearch-skill-log-analytics"></a>

使用 Piped Processing Language (PPL) 搜尋和分析日誌、設定 OpenSearch Ingestion 管道、偵測異常並建置 OpenSearch Dashboards。

```
Investigate why my service is returning 500s and correlate with recent traces
```

### 追蹤分析
<a name="opensearch-skill-trace-analytics"></a>

使用 OpenTelemetry 調查分散式追蹤 – 使用 Data Prepper 識別慢速和錯誤範圍、建置服務地圖和擷取範圍。

```
Which service is causing the p99 latency regression in the checkout flow?
```

## 客服人員如何取得技能
<a name="opensearch-skill-delivery"></a>

技能是透過 Agent Toolkit for 交付 AWS。您有兩種選擇：
+ **安裝 `aws-data-analytics` 外掛程式 （建議）。**外掛程式在單一安裝中綁定 AWS MCP Server 組態和 OpenSearch 技能。
+ **透過 AWS MCP 伺服器在執行時間探索它。**設定 AWS MCP 伺服器後，您的代理程式會使用伺服器的`search_documentation`工具隨需尋找技能，並使用 載入 – `retrieve_skill` 無需本機安裝。

## 使用搭配和不搭配 AWS MCP 伺服器的技能
<a name="opensearch-skill-with-without-mcp"></a>

技能旨在與 一起執行[設定 AWS MCP 伺服器](aws-mcp-server.md)，它提供經過驗證的 API 存取、沙盒化指令碼執行和企業控制。當 AWS MCP 伺服器可用時，代理程式會使用其`call_aws`工具來執行 OpenSearch 操作。

此技能也可在沒有 AWS MCP 伺服器的情況下運作。技能中的每個操作只會使用標準 AWS CLI 執行 （例如 `aws opensearch describe-domain`或 `aws opensearchserverless create-collection`)。技能包含使用這兩種方法的指示。

## 先決條件
<a name="opensearch-skill-prerequisites"></a>
+ 支援 Agent Toolkit for AWS （例如 Claude Code 或 Codex) 的 AI 編碼代理程式。
+ AWS 針對您要執行的 OpenSearch 操作，設定具有許可的憑證。如需網域，請參閱 [身分型政策](ac.md#ac-types-identity)。如需 Serverless，請參閱 [Amazon OpenSearch Serverless 的資料存取控制](serverless-data-access.md)。
+ 對於建議的設定，則為 [設定 AWS MCP 伺服器](aws-mcp-server.md)。

## 安全考量
<a name="opensearch-skill-security"></a>

當代理程式執行 OpenSearch 操作時，它會使用您提供的登入資料。代理程式可以代表您觸發任何這些登入資料。
+ 使用範圍限定為客服人員所需索引和動作的最低權限憑證。避免重複使用管理員登入資料。
+ 分開開發和生產。將代理程式指向非生產資源進行探索，並在生產變更之前要求明確確認。
+ 在遞交至長期基礎設施之前，請檢閱代理程式建立的資源。操作和遷移功能可以佈建網域、集合、IAM 角色和聯網資源。
+ 檢閱工具輸出。MCP 工具回應會傳回語言模型做為內容。避免針對包含您不希望向模型提供者公開之敏感資料的索引執行操作。