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.
OpenSearch Habilidades de agente
Los desarrolladores de hoy en día pueden pasar de una idea a un prototipo funcional en cuestión de minutos utilizando agentes IDEs como Kiro, Claude Code y Cursor. Sin embargo, ya sea que esté experimentando con una nueva idea, creando una prueba de concepto o ejecutando sistemas de producción, la experiencia se vuelve rápidamente más compleja. Los resultados de búsqueda no se comportan como se esperaba, los picos de latencia requieren revisar los registros y la implementación implica tomar decisiones AWS de configuración que requieren una gran experiencia. Traducir la intención de alto nivel en consultas DSLs, configuraciones de indexación y flujos de trabajo de varios pasos sigue llevando mucho tiempo, incluso con un agente de IA a tu lado.
OpenSearch Agent Skills
¿Qué puedes hacer con Agent Skills
Cree una aplicación de búsqueda local
Esta opensearch-launchpad habilidad aporta una experiencia basada en la intención a la creación e iteración de aplicaciones de búsqueda. Traduce los requisitos del lenguaje natural o los datos de muestra en un OpenSearch índice completamente configurado (con mapeos optimizados, flujos de ingesta e integraciones de modelos de aprendizaje automático para búsquedas por palabras clave, semánticas e híbridas) y genera una experiencia de búsqueda funcional lista para ser probada e iterada.
Ejemplo de mensaje:
Build a semantic search application for product documentation
El agente configura las asignaciones de índices, establece un modelo de incrustación y una canalización de ingesta, y devuelve una interfaz de usuario y una API de búsqueda que funcionan, lo que le explica cada decisión tomada a lo largo del proceso.
Investigue los incidentes mediante el análisis de registros
Esta log-analytics habilidad aporta la inteligencia de los agentes a los flujos de trabajo de observabilidad. En lugar de crear consultas con lenguaje de procesamiento canalizado (PPL) manualmente o agrupar los datos de registro de todos los servicios, usted expresa su intención y la habilidad maneja la complejidad, desde la detección de patrones de error hasta el análisis de anomalías y la correlación entre las causas principales.
Ejemplo de mensaje:
Investigate why my service is returning 500s and correlate with recent traces
El agente ejecuta consultas de PPL para detectar patrones de error y anomalías en el volumen del registro y, a continuación, correlaciona los errores de registro con un rastreo específico IDs para analizar la causa raíz más rápido, sin necesidad de dominar la sintaxis del PPL ni navegar manualmente por los datos de rastreo.
Investigue los rastros distribuidos
La trace-analytics habilidad investiga los rastros distribuidos directamente en su interior OpenSearch. Identifica los intervalos lentos, los intervalos de error y las dependencias de los servicios, y correlaciona los registros y las trazas mediante el rastreo IDs para descubrir las causas fundamentales en todo el conjunto de observabilidad.
Ejemplo de mensaje:
Which service is causing the p99 latency regression in the checkout flow?
El agente crea un mapa de servicios, identifica los períodos de lentitud y localiza los cuellos de botella, sin necesidad de navegar manualmente por los datos de rastreo entre los servicios.
Implemente en OpenSearch AWS
Esta aws-setup habilidad ayuda a su agente a aprovisionar un dominio de OpenSearch servicio o una colección OpenSearch sin servidor, configurar las políticas de acceso y cifrado y conectar su aplicación, con guías independientes para los dominios administrados y las colecciones sin servidor.
Ejemplo de mensaje:
Set up an OpenSearch Serverless collection for my search application
El agente se encarga del aprovisionamiento, la configuración de las políticas y la validación, y lo guía en cada paso.
Habilidades disponibles
Las habilidades están organizadas por categoría. Puede instalar la colección completa o las habilidades individuales:
| Categoría | Habilidad | ¿Qué hace? |
|---|---|---|
| Search | opensearch-launchpad |
Organiza una aplicación de búsqueda desde cero. Abarca la búsqueda BM25 léxica, la búsqueda semántica, la búsqueda híbrida y la búsqueda por agentes. Incluye guías de selección de modelos, estrategias de evaluación y ejemplos de datos. |
| Observabilidad | log-analytics |
Consulta y analiza los registros mediante el lenguaje de procesamiento canalizado (PPL). Ayuda al agente a detectar patrones de error y anomalías superficiales y a correlacionar eventos en todos los índices. |
| Observabilidad | trace-analytics |
Investiga las trazas distribuidas. Identifica los intervalos lentos, crea mapas de servicios y rastrea las invocaciones de las herramientas de los agentes de IA en todo el sistema. |
| Cloud | aws-setup |
Se despliega OpenSearch en. AWS Incluye guías específicas para los dominios de Amazon OpenSearch Service y las colecciones OpenSearch Serverless, que abarcan el aprovisionamiento, las políticas de acceso y la configuración de la red. |
El proyecto está en desarrollo activo. Para obtener la lista de habilidades y la guía de contribuciones más recientes, consulte el opensearch-agent-skills
Requisitos previos
Los requisitos previos varían según la habilidad. Para utilizar la colección completa, necesita:
-
Un agente de codificación compatible con Agent Skills (Claude Code, Cursor o Kiro).
-
Node.js
con npxsu archivoPATH, para ejecutar elskillsinstalador. -
uvy Python 3.11 o posterior. Habilidades utilizadas uvpara ejecutar scripts en entornos aislados. -
Docker
está instalado y en ejecución, si tiene pensado utilizar las habilidades necesarias para crear un clúster local (por ejemplo opensearch-launchpad). -
AWS credenciales configuradas con los permisos adecuados si planea usar la
aws-setuphabilidad. Para obtener información sobre los permisos necesarios, consultePolíticas basadas en identidades.
Habilidades de instalación y uso
Las habilidades se instalan a través de la skillsnpx la que se invoca. El instalador detecta el agente y coloca los archivos de habilidades en la ubicación correcta.
Para instalar la colección completa:
npx skills add opensearch-project/opensearch-agent-skills
Para instalar una sola habilidad, utilice el @skill-name sufijo. La --full-depth bandera incluye todo el material de referencia que el agente pueda necesitar para las preguntas de seguimiento:
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
Opciones de instalación comunes:
-aagent-name-
Instálelo en un agente específico, por ejemplo
-a claude-code. -g-
Instálelo de forma global para que la habilidad esté disponible en todos los proyectos de su máquina.
--all-
Instálelo en todos los agentes que la CLI detecte en su máquina.
Tras la instalación, reinicie el agente para que recoja los nuevos archivos de habilidades. A continuación, prueba con un mensaje como «Quiero crear una aplicación de búsqueda híbrida con» OpenSearch. El agente lee las instrucciones de habilidad y ejecuta directamente los scripts necesarios.
La aws-setup habilidad incluye guías específicas para ambas familias OpenSearch de productos de Service. En el caso de los dominios gestionados por Amazon OpenSearch Service, la habilidad explica cómo crear un dominio, configurar las políticas de acceso y conectar la aplicación (consulteIntroduction). En el OpenSearch caso de Serverless, abarca la creación de una recopilación, la configuración de las políticas de acceso y cifrado de datos y la ingesta de datos (consulteAmazon OpenSearch Serverless). Para realizar consultas interactivas en un clúster en ejecución, combine las habilidades con las. OpenSearch Servidor MCP
Consideraciones de seguridad
Al instalar y ejecutar una habilidad, el agente ejecuta los scripts y comandos que describe. Trate las habilidades como lo haría con cualquier herramienta de desarrollo de terceros:
-
Revise el
SKILL.mdarchivo de la habilidad en el repositorio de código fuenteantes de instalarla. -
Ejecute sus habilidades en un entorno de desarrollo o sandbox antes de centrarlas en los recursos de producción.
-
Utilice las credenciales de IAM con privilegios mínimos al ejecutar la
aws-setuphabilidad, con el alcance Cuenta de AWS y Región de AWS el lugar en que desee implementarla. -
Revise todos AWS los recursos que la habilidad genere antes de comprometerse con una infraestructura duradera. Skills puede aprovisionar dominios, colecciones, funciones de IAM y recursos de red en su nombre.
Recursos adicionales
-
opensearch-agent-skills
en GitHub : la fuente, los números y la guía para desarrolladores para crear nuevas habilidades. -
Especificación de las habilidades de los agentes
: el estándar abierto que implementan las habilidades. -
OpenSearch Servidor MCP— El servidor MCP complementario para consultas interactivas en un clúster en ejecución.