View a markdown version of this page

OpenSearch 代理程式技能 - Amazon OpenSearch Service

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

OpenSearch 代理程式技能

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

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

您可以使用客服人員技能做什麼

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 儲存庫。

先決條件

先決條件因技能而異。若要使用完整集合,您需要:

  • 支援客服人員技能的編碼代理程式 (Claude Code、Cursor 或 Kiro)。

  • npx上使用 Node.jsPATH,以執行skills安裝程式。

  • uv 和 Python 3.11 或更新版本。技能uv用於在隔離的環境中執行指令碼。

  • 如果您計劃使用可啟動本機叢集的技能 (例如 opensearch-launchpad),則已安裝並執行 Docker

  • AWS 如果您計劃使用aws-setup技能,則設定具有適當許可的憑證。如需必要許可的指引,請參閱 身分型政策

安裝和使用技能

透過您使用 叫用的 skills 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)。對於 OpenSearch Serverless,它涵蓋了建立集合、設定資料存取和加密政策,以及擷取資料 (請參閱 Amazon OpenSearch Serverless)。針對執行中叢集的互動式查詢,請將技能與 配對OpenSearch MCP 伺服器

安全考量

當您安裝和執行技能時,您的代理程式會執行其描述的指令碼和命令。像對待任何第三方開發人員工具一樣對待技能:

  • 安裝之前,請先檢閱來源儲存庫中的技能SKILL.md檔案。

  • 在開發或沙盒環境中執行技能,然後再指向生產資源。

  • 執行aws-setup技能時使用最低權限的 IAM 登入資料,範圍為您要部署的 AWS 帳戶 和 AWS 區域 。

  • 在承諾長期基礎設施之前,請檢閱技能建立的任何 AWS 資源。技能可以代表您佈建網域、集合、IAM 角色和聯網資源。

其他資源