本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
OpenSearch 特工技能
如今,开发人员可以使用 IDEs像 Kiro、Claude Code 和 Cursor 这样的代理在几分钟内将想法变成工作原型。但是,无论你是在尝试新想法、构建概念验证还是运行生产系统,体验都会很快变得更加复杂。搜索结果表现不如预期,延迟峰值需要仔细研究日志,然后部署以 AWS 引入需要深厚专业知识的配置决策。将高级意图转化为查询 DSLs、索引配置和多步骤工作流程仍然需要大量时间,即使有 AI 代理在你身边。
OpenSearch Agent Skills 通过提供技能
你可以用特工技能做什么
构建本地搜索应用程序
该opensearch-launchpad技能为搜索应用程序的构建和迭代带来了意图驱动的体验。它将自然语言要求或样本数据转换为完全配置的 OpenSearch 索引(具有优化的映射、采集管道以及用于关键字、语义和混合搜索的机器学习模型集成),并生成可供测试和迭代的工作搜索体验。
提示示例:
Build a semantic search application for product documentation
代理配置索引映射,设置嵌入模型和采集管道,并返回有效的搜索 API 和 UI,引导您完成每个决策。
使用日志分析调查事件
该log-analytics技能为可观察性工作流程带来了代理智能。与其手动制作管道处理语言 (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 服务域或 OpenSearch 无服务器集合、配置访问和加密策略以及连接应用程序,以及针对托管域和无服务器集合的单独指南。
提示示例:
Set up an OpenSearch Serverless collection for my search application
代理负责配置、策略配置和验证,指导您完成每个步骤。
可用技能
技能是按类别组织的。你可以安装完整的集合或个人技能:
| 类别 | 技能 | 作用 |
|---|---|---|
| Search | opensearch-launchpad |
从头开始搭建搜索应用程序。涵盖 BM25 词法搜索、语义搜索、混合搜索和代理搜索。包括模型选择指南、评估策略和样本数据。 |
| 可观测性 | log-analytics |
使用管道处理语言 (PPL) 查询和分析日志。帮助代理检测错误模式、表面异常以及跨索引关联事件。 |
| 可观测性 | trace-analytics |
调查分布式痕迹。识别慢速跨度,构建服务地图,并通过系统跟踪 AI 代理工具的调用。 |
| 云 | aws-setup |
部署 OpenSearch 到。 AWS包括 Amazon Serv OpenSearch ice 域和 OpenSearch 无服务器集合的专用指南,涵盖配置、访问策略和网络配置。 |
该项目正在积极开发中。有关最新的技能列表和贡献指南,请参阅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 服务产品系列的专门指南。对于 Amazon S OpenSearch ervice 托管域,该技能将指导您创建域、配置访问策略和连接应用程序(参见Introduction)。对 OpenSearch 于 Serverless,它包括创建集合、配置数据访问和加密策略以及摄取数据(请参阅)。Amazon OpenSearch 无服务器要对正在运行的集群进行交互式查询,请将技能与OpenSearch MCP 服务器。
安全注意事项
安装和运行技能时,您的代理会执行其描述的脚本和命令。像对待任何第三方开发者工具一样对待技能:
-
安装之前,请查看源存储库
中的技能 SKILL.md文件。 -
在将技能指向生产资源之前,先在开发或沙盒环境中运行技能。
-
运行
aws-setup技能时使用权限最低的 IAM 证书,其范围限于 AWS 账户 和您打算 AWS 区域 部署的位置。 -
在投入使用寿命较长的基础设施之前,请先查看该技能创造的所有 AWS 资源。技能可以代表您配置域名、集合、IAM 角色和网络资源。
其他资源
-
opensearch-agent-skills
on GitHub — 创作新技能的来源、问题和开发者指南。 -
代理技能规范
— 技能实施的开放标准。 -
OpenSearch MCP 服务器— 配套的 MCP 服务器,用于对正在运行的集群进行交互式查询。