View a markdown version of this page

OpenSearch 特工技能 - 亚马逊 OpenSearch 服务

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

OpenSearch 特工技能

如今,开发人员可以使用 IDEs像 Kiro、Claude Code 和 Cursor 这样的代理在几分钟内将想法变成工作原型。但是,无论你是在尝试新想法、构建概念验证还是运行生产系统,体验都会很快变得更加复杂。搜索结果表现不如预期,延迟峰值需要仔细研究日志,然后部署以 AWS 引入需要深厚专业知识的配置决策。将高级意图转化为查询 DSLs、索引配置和多步骤工作流程仍然需要大量时间,即使有 AI 代理在你身边。

OpenSearch Agent Skills 通过提供技能库来解决这个问题,这些技能库可以将 OpenSearch 情报直接带入你的特工。每项技能都概括了特定工作流程的领域知识、最佳实践和多步骤执行逻辑,因此您的代理不仅可以获得结果,还可以了解结果是如何实现的。技能适用于任何支持特工技能标准的编码代理,包括 Kiro、Claude Code 和 Cursor。

你可以用特工技能做什么

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存储库。

先决条件

先决条件因技能而异。要使用完整集合,您需要:

  • 支持特工技能(Claude Code、Cursor 或 Kiro)的编码代理。

  • Node.js npx 在你的PATH,运行skills安装程序。

  • uv还有 Python 3.11 或更高版本。用于uv在隔离环境中运行脚本的技能。

  • 如果您计划使用启动本地集群的技能(例如opensearch-launchpad),则已安装并运行 Dock er。

  • AWS 如果您计划使用该aws-setup技能,请配置相应权限的证书。有关所需权限的指导,请参阅基于身份的策略

安装和使用技能

技能通过 skillsCLI 进行安装,您可以使用 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 服务产品系列的专门指南。对于 Amazon S OpenSearch ervice 托管域,该技能将指导您创建域、配置访问策略和连接应用程序(参见Introduction)。对 OpenSearch 于 Serverless,它包括创建集合、配置数据访问和加密策略以及摄取数据(请参阅)。Amazon OpenSearch 无服务器要对正在运行的集群进行交互式查询,请将技能与OpenSearch MCP 服务器

安全注意事项

安装和运行技能时,您的代理会执行其描述的脚本和命令。像对待任何第三方开发者工具一样对待技能:

  • 安装之前,请查看源存储库中的技能SKILL.md文件。

  • 在将技能指向生产资源之前,先在开发或沙盒环境中运行技能。

  • 运行aws-setup技能时使用权限最低的 IAM 证书,其范围限于 AWS 账户 和您打算 AWS 区域 部署的位置。

  • 在投入使用寿命较长的基础设施之前,请先查看该技能创造的所有 AWS 资源。技能可以代表您配置域名、集合、IAM 角色和网络资源。

其他资源