View a markdown version of this page

亚马逊 OpenSearch 服务技能 - 亚马逊 OpenSearch 服务
功能特工是如何获得技能的在有和不带的情况下使用技能 AWS MCP 服务器先决条件安全注意事项

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

亚马逊 OpenSearch 服务技能

amazon-opensearch-service是 Agent Toolkit 中的一项技能 AWS ，用于将 Amazon OpenSearch 服务专业知识直接带到你的 AI 编码代理中。技能是一个精心策划的指令、脚本和参考资料包，可帮助代理正确完成任务，封装了模型原本不具备的领域知识和最佳实践。只有在你的请求即将到来时，代理才会加载技能 OpenSearch，因此它可以在不减慢代理无关工作的速度的情况下增加能力。

该技能适用于托管 OpenSearch 服务域和 OpenSearch 无服务器集合。

功能

该技能会将每个请求路由到五个能力中的一个。

迁移

计划从 Solr、Elasticsearch 或自行管理迁移 OpenSearch 到 OpenSearch 亚马逊服务或无服务器。该技能评估兼容性、转换架构和查询、推荐实例类、计数和分片数学，并概述了切换方法。

Assess my Solr 8 catalog for migration to OpenSearch Service
注意

该技能计划迁移；它不移动数据。使用 Amazon S OpenSearch ervice 迁移助手进行历史回填和实时切换。

操作

配置和管理域和集合 — 生命周期、版本升级、存储层（包括 UltraWarm 和 OR1）、精细的访问控制和监控。

Provision a production OpenSearch Service domain with three Availability Zones

生成关键字 (BM25)、向量、语义、混合和 RAG 搜索。该技能有助于进行索引配置、k-nn 引擎选择（FAISS HNSW vs Lucene）以及用于嵌入的 Amazon Bedrock 连接器，并包括查询 DSL 示例。

Build a hybrid search application with OpenSearch and Bedrock embeddings

日志分析

使用管道处理语言 (PPL) 搜索和分析日志，设置 OpenSearch 摄取管道，检测异常并构建仪表板。 OpenSearch 

Investigate why my service is returning 500s and correlate with recent traces

追踪分析

使用以下方法调查分布式 OpenTelemetry 追踪：使用 Data Prepper 识别慢速和错误跨度、构建服务地图和采集跨度。

Which service is causing the p99 latency regression in the checkout flow?

特工是如何获得技能的

该技能是通过代理工具包提供的 AWS。你有两个选择：

  • 安装aws-data-analytics插件（推荐）。该插件将 AWS MCP 服务器配置和 OpenSearch 技能捆绑在一次安装中。

  • 在运行时通过 AWS MCP 服务器发现它。配置 AWS MCP 服务器后，您的代理将使用服务器的search_documentation工具按需查找技能并加载该技能，retrieve_skill无需在本地安装。

在有和不带的情况下使用技能 AWS MCP 服务器

该技能旨在与一起运行设置 AWS MCP 服务器，后者提供经过身份验证的 API 访问权限、沙盒脚本执行和企业控制。在 AWS MCP 服务器可用的地方，代理使用其call_aws工具来运行 OpenSearch 操作。

该技能也可以在没有 AWS MCP 服务器的情况下生效。技能中的每项操作都仅使用标准 AWS CLI 运行（例如，aws opensearch describe-domain或aws opensearchserverless create-collection）。该技能包括适用于这两种方法的指令。

先决条件

安全注意事项

代理运行 OpenSearch 操作时，它将使用您提供的凭据进行操作。这些凭证有权执行的任何操作，代理都可以代表您触发。

  • 使用限定为代理所需的索引和操作的最低权限凭证。避免重复使用管理员凭据。

  • 将开发和生产分开。将代理指向非生产资源进行勘探，并要求在生产变更之前进行明确确认。

  • 在承诺使用长寿命基础架构之前，请查看代理创建的资源。操作和迁移功能可以配置域、集合、IAM 角色和网络资源。

  • 查看工具输出。MCP 工具响应作为上下文返回到语言模型。避免对包含您不想向模型提供者公开的敏感数据的索引运行操作。