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

# OpenSearch 特工技能
<a name="opensearch-agent-skills"></a>

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

[OpenSearch Agent Skills 通过提供技能](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 索引（具有优化的映射、采集管道以及用于关键字、语义和混合搜索的机器学习模型集成），并生成可供测试和迭代的工作搜索体验。

提示示例：

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

代理配置索引映射，设置嵌入模型和采集管道，并返回有效的搜索 API 和 UI，引导您完成每个决策。

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

该`log-analytics`技能为可观察性工作流程带来了代理智能。与其手动制作管道处理语言 (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 服务域或 OpenSearch 无服务器集合、配置访问和加密策略以及连接应用程序，以及针对托管域和无服务器集合的单独指南。

提示示例：

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

代理负责配置、策略配置和验证，指导您完成每个步骤。

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

技能是按类别组织的。你可以安装完整的集合或个人技能：


| 类别 | 技能 | 作用 | 
| --- | --- | --- | 
| Search | opensearch-launchpad | 从头开始搭建搜索应用程序。涵盖 BM25 词法搜索、语义搜索、混合搜索和代理搜索。包括模型选择指南、评估策略和样本数据。 | 
| 可观测性 | log-analytics | 使用管道处理语言 (PPL) 查询和分析日志。帮助代理检测错误模式、表面异常以及跨索引关联事件。 | 
| 可观测性 | trace-analytics | 调查分布式痕迹。识别慢速跨度，构建服务地图，并通过系统跟踪 AI 代理工具的调用。 | 
| 云 | aws-setup | 部署 OpenSearch 到。 AWS包括 Amazon Serv OpenSearch ice 域和 OpenSearch 无服务器集合的专用指南，涵盖配置、访问策略和网络配置。 | 

该项目正在积极开发中。有关最新的技能列表和贡献指南，请参阅[opensearch-agent-skills](https://github.com/opensearch-project/opensearch-agent-skills)存储库。

## 先决条件
<a name="agent-skills-prerequisites"></a>

先决条件因技能而异。要使用完整集合，您需要：
+ 支持特工技能（Claude Code、Cursor 或 Kiro）的编码代理。
+ [Node.js](https://nodejs.org/) `npx` 在你的`PATH`，运行`skills`安装程序。
+ [https://docs.astral.sh/uv/getting-started/installation/](https://docs.astral.sh/uv/getting-started/installation/)还有 Python 3.11 或更高版本。用于`uv`在隔离环境中运行脚本的技能。
+ 如果您计划使用启动本地集群的技能（例如`opensearch-launchpad`），则已安装并运行 [Dock](https://docs.docker.com/get-docker/) er。
+ AWS 如果您计划使用该`aws-setup`技能，请配置相应权限的证书。有关所需权限的指导，请参阅[基于身份的策略](ac.md#ac-types-identity)。

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

技能通过 [https://agentskills.io](https://agentskills.io)CLI 进行安装，您可以使用 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](what-is.md)）。对 OpenSearch 于 Serverless，它包括创建集合、配置数据访问和加密策略以及摄取数据（请参阅）。[Amazon OpenSearch 无服务器](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>
+ [opensearch-agent-skills](https://github.com/opensearch-project/opensearch-agent-skills)on GitHub — 创作新技能的来源、问题和开发者指南。
+ [代理技能规范](https://agentskills.io/specification) — 技能实施的开放标准。
+ [OpenSearch MCP 服务器](opensearch-mcp-server.md)— 配套的 MCP 服务器，用于对正在运行的集群进行交互式查询。