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

# OpenSearch 代理程式技能
<a name="opensearch-agent-skills"></a>

現今的開發人員可以使用 Kiro、Claude Code 和 Cursor 等代理 IDEs，在幾分鐘內從想法到工作原型。但是，無論您是試驗新想法、建立概念驗證或執行生產系統，體驗都會快速變得更複雜。搜尋結果的行為不如預期，延遲峰值需要挖掘日誌，並且部署 AWS 引入需要深度專業知識的組態決策。將高階意圖轉譯為查詢 DSLs、索引組態和多步驟工作流程仍需要很長的時間，即使您的 AI 代理器也一樣。

[OpenSearch 代理程式技能](https://github.com/opensearch-project/opensearch-agent-skills)透過提供將 OpenSearch 情報直接帶入您的代理程式的技能儲存庫來解決此問題。每項技能都會封裝特定工作流程的網域知識、最佳實務和多步驟執行邏輯，因此您的代理程式不僅能取得結果，還能了解它們的實現方式。技能可與支援[客服人員技能標準](https://agentskills.io/specification)的任何編碼代理程式搭配使用，包括 Kiro、Claude Code 和 Cursor。

## 您可以使用客服人員技能做什麼
<a name="agent-skills-use-cases"></a>

### 建置本機搜尋應用程式
<a name="agent-skills-use-case-search"></a>

此`opensearch-launchpad`技能為在搜尋應用程式上建置和反覆運算帶來了意圖驅動的體驗。它將自然語言需求或範例資料轉譯為完全設定的 OpenSearch 索引 - 具有關鍵字、語意和混合搜尋的最佳化映射、擷取管道和 ML 模型整合 - 並產生準備好測試和迭代的工作搜尋體驗。

範例提示：

```
Build a semantic search application for product documentation
```

代理程式會設定索引映射、設定內嵌模型和擷取管道，並傳回有效的搜尋 API 和 UI – 逐步引導您完成每個決策。

### 使用日誌分析調查事件
<a name="agent-skills-use-case-logs"></a>

此`log-analytics`技能將代理程式智慧帶入可觀測性工作流程。您不會手動製作 Piped Processing Language (PPL) 查詢或將日誌資料拼湊到各服務，而是表達意圖，而技能會處理複雜性，從錯誤模式偵測到異常分析，再到根本原因相互關聯。

範例提示：

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

代理程式會執行 PPL 查詢以呈現錯誤模式和日誌磁碟區異常，然後將日誌錯誤與特定追蹤 IDs 建立關聯，以加快根本原因分析速度，而不需要您主控 PPL 語法或手動導覽追蹤資料。

### 調查分散式追蹤
<a name="agent-skills-use-case-traces"></a>

此`trace-analytics`技能會直接在 OpenSearch 中調查分散式追蹤。它識別慢範圍、錯誤範圍和服務相依性，並使用追蹤 IDs 將日誌和追蹤關聯到整個可觀測性堆疊的表面根本原因。

範例提示：

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

代理程式會建置服務映射、識別緩慢的跨度，並找出瓶頸，而無需手動導覽跨服務追蹤資料。

### 將 OpenSearch 部署到 AWS
<a name="agent-skills-use-case-aws"></a>

此`aws-setup`技能會逐步引導您的代理程式佈建 OpenSearch Service 網域或 OpenSearch Serverless 集合、設定存取和加密政策，以及透過受管網域和無伺服器集合的個別指南來連接您的應用程式。

範例提示：

```
Set up an OpenSearch Serverless collection for my search application
```

代理程式會處理佈建、政策組態和驗證，引導您完成每個步驟。

## 可用的技能
<a name="agent-skills-available"></a>

技能會依類別進行組織。您可以安裝完整的集合或個別技能：


| Category | 技能 | 它的功能 | 
| --- | --- | --- | 
| 搜尋 | opensearch-launchpad | Scaffold 會從頭開始搜尋應用程式。涵蓋 BM25 語彙搜尋、語意搜尋、混合搜尋和客服人員搜尋。包括模型選擇指南、評估策略和範例資料。 | 
| 可觀測性 | log-analytics | 使用 Piped Processing Language (PPL) 查詢和分析日誌。協助代理程式偵測錯誤模式、表面異常，以及跨索引關聯事件。 | 
| 可觀測性 | trace-analytics | 調查分散式追蹤。識別慢速跨度、建置服務地圖，並透過您的系統追蹤 AI 代理器工具叫用。 | 
| 雲端 | aws-setup | 將 OpenSearch 部署到 AWS。包含 Amazon OpenSearch Service 網域和 OpenSearch Serverless 集合的專用指南，涵蓋佈建、存取政策和網路組態。 | 

專案正在作用中開發中。如需最新的技能清單和貢獻指引，請參閱 [opensearch-agent-skills](https://github.com/opensearch-project/opensearch-agent-skills) 儲存庫。

## 先決條件
<a name="agent-skills-prerequisites"></a>

先決條件因技能而異。若要使用完整集合，您需要：
+ 支援客服人員技能的編碼代理程式 (Claude Code、Cursor 或 Kiro)。
+ 在 `npx`上使用 [Node.js](https://nodejs.org/)`PATH`，以執行`skills`安裝程式。
+ [https://docs.astral.sh/uv/getting-started/installation/](https://docs.astral.sh/uv/getting-started/installation/) 和 Python 3.11 或更新版本。技能`uv`用於在隔離的環境中執行指令碼。
+ 如果您計劃使用可啟動本機叢集的技能 （例如 `opensearch-launchpad`)，則已安裝並執行 [Docker](https://docs.docker.com/get-docker/)。
+ AWS 如果您計劃使用`aws-setup`技能，則設定具有適當許可的憑證。如需必要許可的指引，請參閱 [身分型政策](ac.md#ac-types-identity)。

## 安裝和使用技能
<a name="agent-skills-install"></a>

透過您使用 叫用的 [https://agentskills.io](https://agentskills.io) CLI 安裝技能`npx`。安裝程式會偵測您的代理程式，並將技能檔案放在正確的位置。

若要安裝整個集合：

```
npx skills add opensearch-project/opensearch-agent-skills
```

若要安裝單一技能，請使用尾`@skill-name`碼。`--full-depth` 旗標包含客服人員在後續問題中可能需要的所有參考資料：

```
npx skills add opensearch-project/opensearch-agent-skills@opensearch-launchpad --full-depth
npx skills add opensearch-project/opensearch-agent-skills@log-analytics --full-depth
npx skills add opensearch-project/opensearch-agent-skills@trace-analytics --full-depth
npx skills add opensearch-project/opensearch-agent-skills@aws-setup --full-depth
```

常見的安裝選項：

**`-a {{agent-name}}`**  
安裝 至特定代理程式，例如 `-a claude-code`。

**`-g`**  
全域安裝 ，讓您的機器上的所有專案都能使用這項技能。

**`--all`**  
將 安裝到 CLI 在機器上偵測到的每個代理程式。

安裝後，重新啟動您的代理程式，讓它取得新的技能檔案。然後嘗試提示，例如*「我想要使用 OpenSearch."* 客服人員會讀取技能指示，並直接執行所需的指令碼。

此`aws-setup`技能包含兩個 OpenSearch Service 產品系列的專用指南。對於 Amazon OpenSearch Service 受管網域，技能會逐步解說建立網域、設定存取政策，以及連接應用程式 （請參閱 [Introduction](what-is.md))。對於 OpenSearch Serverless，它涵蓋了建立集合、設定資料存取和加密政策，以及擷取資料 （請參閱 [Amazon OpenSearch Serverless](serverless.md))。針對執行中叢集的互動式查詢，請將技能與 配對[OpenSearch MCP 伺服器](opensearch-mcp-server.md)。

## 安全考量
<a name="agent-skills-security"></a>

當您安裝和執行技能時，您的代理程式會執行其描述的指令碼和命令。像對待任何第三方開發人員工具一樣對待技能：
+ 安裝之前，請先檢閱[來源儲存庫](https://github.com/opensearch-project/opensearch-agent-skills)中的技能`SKILL.md`檔案。
+ 在開發或沙盒環境中執行技能，然後再指向生產資源。
+ 執行`aws-setup`技能時使用最低權限的 IAM 登入資料，範圍為您要部署的 AWS 帳戶 和 AWS 區域 。
+ 在承諾長期基礎設施之前，請檢閱技能建立的任何 AWS 資源。技能可以代表您佈建網域、集合、IAM 角色和聯網資源。

## 其他資源
<a name="agent-skills-more-information"></a>
+ GitHub 上的 [opensearch-agent-skills](https://github.com/opensearch-project/opensearch-agent-skills) – 撰寫新技能的來源、問題和開發人員指南。
+ [客服人員技能規格](https://agentskills.io/specification) – 技能實作的開放標準。
+ [OpenSearch MCP 伺服器](opensearch-mcp-server.md) – 針對執行中叢集進行互動式查詢的配套 MCP 伺服器。