本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
OpenSearch 代理程式技能
現今的開發人員可以使用 Kiro、Claude Code 和 Cursor 等代理 IDEs,在幾分鐘內從想法到工作原型。但是,無論您是試驗新想法、建立概念驗證或執行生產系統,體驗都會快速變得更複雜。搜尋結果的行為不如預期,延遲峰值需要挖掘日誌,並且部署 AWS 引入需要深度專業知識的組態決策。將高階意圖轉譯為查詢 DSLs、索引組態和多步驟工作流程仍需要很長的時間,即使您的 AI 代理器也一樣。
OpenSearch 代理程式技能
您可以使用客服人員技能做什麼
建置本機搜尋應用程式
此opensearch-launchpad技能為在搜尋應用程式上建置和反覆運算帶來了意圖驅動的體驗。它將自然語言需求或範例資料轉譯為完全設定的 OpenSearch 索引 - 具有關鍵字、語意和混合搜尋的最佳化映射、擷取管道和 ML 模型整合 - 並產生準備好測試和迭代的工作搜尋體驗。
範例提示:
Build a semantic search application for product documentation
代理程式會設定索引映射、設定內嵌模型和擷取管道,並傳回有效的搜尋 API 和 UI – 逐步引導您完成每個決策。
使用日誌分析調查事件
此log-analytics技能將代理程式智慧帶入可觀測性工作流程。您不會手動製作 Piped Processing Language (PPL) 查詢或將日誌資料拼湊到各服務,而是表達意圖,而技能會處理複雜性,從錯誤模式偵測到異常分析,再到根本原因相互關聯。
範例提示:
Investigate why my service is returning 500s and correlate with recent traces
代理程式會執行 PPL 查詢以呈現錯誤模式和日誌磁碟區異常,然後將日誌錯誤與特定追蹤 IDs 建立關聯,以加快根本原因分析速度,而不需要您主控 PPL 語法或手動導覽追蹤資料。
調查分散式追蹤
此trace-analytics技能會直接在 OpenSearch 中調查分散式追蹤。它識別慢範圍、錯誤範圍和服務相依性,並使用追蹤 IDs 將日誌和追蹤關聯到整個可觀測性堆疊的表面根本原因。
範例提示:
Which service is causing the p99 latency regression in the checkout flow?
代理程式會建置服務映射、識別緩慢的跨度,並找出瓶頸,而無需手動導覽跨服務追蹤資料。
將 OpenSearch 部署到 AWS
此aws-setup技能會逐步引導您的代理程式佈建 OpenSearch Service 網域或 OpenSearch Serverless 集合、設定存取和加密政策,以及透過受管網域和無伺服器集合的個別指南來連接您的應用程式。
範例提示:
Set up an OpenSearch Serverless collection for my search application
代理程式會處理佈建、政策組態和驗證,引導您完成每個步驟。
可用的技能
技能會依類別進行組織。您可以安裝完整的集合或個別技能:
| 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
先決條件
先決條件因技能而異。若要使用完整集合,您需要:
安裝和使用技能
透過您使用 叫用的 skillsnpx。安裝程式會偵測您的代理程式,並將技能檔案放在正確的位置。
若要安裝整個集合:
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
常見的安裝選項:
-aagent-name-
安裝 至特定代理程式,例如
-a claude-code。 -g-
全域安裝 ,讓您的機器上的所有專案都能使用這項技能。
--all-
將 安裝到 CLI 在機器上偵測到的每個代理程式。
安裝後,重新啟動您的代理程式,讓它取得新的技能檔案。然後嘗試提示,例如「我想要使用 OpenSearch." 客服人員會讀取技能指示,並直接執行所需的指令碼。
此aws-setup技能包含兩個 OpenSearch Service 產品系列的專用指南。對於 Amazon OpenSearch Service 受管網域,技能會逐步解說建立網域、設定存取政策,以及連接應用程式 (請參閱 Introduction)。對於 OpenSearch Serverless,它涵蓋了建立集合、設定資料存取和加密政策,以及擷取資料 (請參閱 Amazon OpenSearch Serverless)。針對執行中叢集的互動式查詢,請將技能與 配對OpenSearch MCP 伺服器。
安全考量
當您安裝和執行技能時,您的代理程式會執行其描述的指令碼和命令。像對待任何第三方開發人員工具一樣對待技能:
-
安裝之前,請先檢閱來源儲存庫
中的技能 SKILL.md檔案。 -
在開發或沙盒環境中執行技能,然後再指向生產資源。
-
執行
aws-setup技能時使用最低權限的 IAM 登入資料,範圍為您要部署的 AWS 帳戶 和 AWS 區域 。 -
在承諾長期基礎設施之前,請檢閱技能建立的任何 AWS 資源。技能可以代表您佈建網域、集合、IAM 角色和聯網資源。
其他資源
-
GitHub 上的 opensearch-agent-skills
– 撰寫新技能的來源、問題和開發人員指南。 -
客服人員技能規格
– 技能實作的開放標準。 -
OpenSearch MCP 伺服器 – 針對執行中叢集進行互動式查詢的配套 MCP 伺服器。