

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# habilidad amazon-opensearch-service
<a name="amazon-opensearch-service-skill"></a>

`amazon-opensearch-service`es una habilidad del kit de herramientas para agentes AWS que aporta la experiencia de Amazon OpenSearch Service directamente a tu agente de codificación de IA. Una habilidad es un paquete seleccionado de instrucciones, guiones y material de referencia que ayuda a un agente a completar una tarea correctamente, resumiendo los conocimientos del campo y las mejores prácticas que el modelo no tendría de otro modo. El agente utiliza la habilidad solo cuando se trata de una solicitud OpenSearch, por lo que añade capacidad sin ralentizar al agente en tareas no relacionadas con la suya.

La habilidad funciona con dominios de OpenSearch servicios gestionados y colecciones OpenSearch sin servidor.

## Capacidades
<a name="opensearch-skill-capabilities"></a>

La habilidad dirige cada solicitud a una de las cinco capacidades.

### Migración
<a name="opensearch-skill-migration"></a>

Planifique una migración de Solr, Elasticsearch o autogestionada a OpenSearch Amazon Service o OpenSearch Serverless. Esta habilidad evalúa la compatibilidad, traduce esquemas y consultas, recomienda cálculos de clases de instancias, recuentos y fragmentos, y describe un enfoque de transición.

```
Assess my Solr 8 catalog for migration to OpenSearch Service
```

**nota**  
La habilidad planifica la migración; no mueve los datos. Usa Migration Assistant for Amazon OpenSearch Service para el rellenado histórico y la transición en tiempo real.

### Operaciones
<a name="opensearch-skill-operations"></a>

Aprovisione y gestione dominios y colecciones: ciclo de vida, actualizaciones de versiones, niveles de almacenamiento (incluido el OR1), control de acceso detallado UltraWarm y supervisión.

```
Provision a production OpenSearch Service domain with three Availability Zones
```

### Search
<a name="opensearch-skill-search"></a>

Cree búsquedas por palabras clave (BM25), vectoriales, semánticas, híbridas y RAG. Esta habilidad ayuda con la configuración de índices, la selección del motor K-nn (FAISS HNSW frente a Lucene) y los conectores Amazon Bedrock para incrustaciones, e incluye ejemplos de consultas de DSL.

```
Build a hybrid search application with OpenSearch and Bedrock embeddings
```

### Análisis de registros
<a name="opensearch-skill-log-analytics"></a>

Busque y analice los registros con el lenguaje de procesamiento canalizado (PPL), configure los canales de OpenSearch ingestión, detecte anomalías y cree cuadros de mando. OpenSearch 

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

### Análisis de trazas
<a name="opensearch-skill-trace-analytics"></a>

Investigue los rastreos distribuidos OpenTelemetry : identifique los intervalos lentos y de error, cree mapas de servicios e ingiera los intervalos con Data Prepper.

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

## Cómo adquiere la habilidad el agente
<a name="opensearch-skill-delivery"></a>

La habilidad se proporciona a través del kit de herramientas para agentes para AWS. Tienes dos opciones:
+ **Instala el `aws-data-analytics` complemento (recomendado).** El complemento incluye la configuración del servidor AWS MCP y la OpenSearch habilidad en una sola instalación.
+ **Descúbralo en tiempo de ejecución a través del servidor AWS MCP.** Con el servidor AWS MCP configurado, su agente encontrará la habilidad que necesite utilizando la `search_documentation` herramienta del servidor y la cargará con `retrieve_skill` ella, sin necesidad de instalarla localmente.

## Utilizar la habilidad con y sin AWS Servidor MCP
<a name="opensearch-skill-with-without-mcp"></a>

La habilidad está diseñada para funcionar con el[Configure el AWS Servidor MCP](aws-mcp-server.md), que proporciona acceso autenticado a la API, ejecución de scripts en un entorno aislado y controles empresariales. Cuando el servidor AWS MCP está disponible, el agente utiliza su `call_aws` herramienta para ejecutar las operaciones. OpenSearch 

La habilidad también funciona sin el servidor AWS MCP. Todas las operaciones de la habilidad se ejecutan únicamente con la AWS CLI estándar (por ejemplo, `aws opensearch describe-domain` o`aws opensearchserverless create-collection`). La habilidad incluye instrucciones que funcionan con ambos enfoques.

## Requisitos previos
<a name="opensearch-skill-prerequisites"></a>
+ Un agente de codificación de IA compatible con el kit de herramientas para agentes AWS (como Claude Code o Codex).
+ AWS credenciales configuradas con permiso para las OpenSearch operaciones que pretende ejecutar. Para los dominios, consulte[Identity-based políticas](ac.md#ac-types-identity). Para Serverless, consulte[Control de acceso a datos para Amazon OpenSearch Serverless](serverless-data-access.md).
+ Para obtener la configuración recomendada, la[Configure el AWS Servidor MCP](aws-mcp-server.md).

## Consideraciones de seguridad
<a name="opensearch-skill-security"></a>

Cuando el agente ejecuta OpenSearch las operaciones, actúa con las credenciales que usted proporciona. El agente puede activar todo lo que esas credenciales estén autorizados a hacer en su nombre.
+ Utilice credenciales con privilegios mínimos que se ajusten a los índices y las acciones que necesite el agente. Evite reutilizar las credenciales de administrador.
+ Desarrollo y producción separados. Dirija al agente a los recursos no productivos para su exploración y solicite una confirmación explícita antes de realizar cambios en la producción.
+ Revise los recursos que el agente crea antes de comprometerse con una infraestructura duradera. Las capacidades de operaciones y migración pueden aprovisionar dominios, colecciones, funciones de IAM y recursos de red.
+ Revise el resultado de la herramienta. Las respuestas de la herramienta MCP se devuelven al modelo de lenguaje como contexto. Evite ejecutar operaciones con índices que contengan datos confidenciales que no desee que se expongan a su proveedor de modelos.