View a markdown version of this page

OpenSearch Compétences des agents - Amazon OpenSearch Service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

OpenSearch Compétences des agents

Les développeurs d'aujourd'hui peuvent passer d'une idée à un prototype fonctionnel en quelques minutes à l'aide d'agentic IDEs comme Kiro, Claude Code et Cursor. Mais qu'il s'agisse d'expérimenter une nouvelle idée, d'élaborer une preuve de concept ou d'exécuter des systèmes de production, l'expérience devient rapidement plus complexe. Les résultats de recherche ne se comportent pas comme prévu, les pics de latence nécessitent de fouiller dans les journaux et le déploiement implique AWS des décisions de configuration qui nécessitent une expertise approfondie. La traduction d'une intention de haut niveau en configurations de requêtes DSLs, d'index et en flux de travail en plusieurs étapes prend encore beaucoup de temps, même avec un agent d'intelligence artificielle à vos côtés.

OpenSearch Agent Skills répond à ce problème en fournissant un référentiel de compétences qui fournissent OpenSearch des informations directement à votre agent. Chaque compétence englobe les connaissances du domaine, les meilleures pratiques et la logique d'exécution en plusieurs étapes pour un flux de travail spécifique. Ainsi, votre agent obtient non seulement des résultats, mais comprend également comment ils ont été atteints. Les compétences fonctionnent avec n'importe quel agent de codage compatible avec le standard Agent Skills, notamment Kiro, Claude Code et Cursor.

Ce que vous pouvez faire avec Agent Skills

Cette opensearch-launchpad compétence apporte une expérience axée sur l'intention pour créer et itérer des applications de recherche. Il traduit les exigences du langage naturel ou des échantillons de données en un OpenSearch index entièrement configuré (avec des mappages optimisés, des pipelines d'ingestion et des intégrations de modèles ML pour la recherche par mots clés, sémantique et hybride) et produit une expérience de recherche fonctionnelle prête à être testée et répétée.

Exemple d'invite :

Build a semantic search application for product documentation

L'agent configure les mappages d'index, met en place un modèle d'intégration et un pipeline d'ingestion, et renvoie une API de recherche et une interface utilisateur fonctionnelles, vous guidant dans chaque décision.

Étudier les incidents grâce à l'analyse des journaux

Cette log-analytics compétence apporte l'intelligence agentique aux flux de travail d'observabilité. Au lieu de créer manuellement des requêtes PPL (Piped Processing Language) ou de rassembler les données des journaux de différents services, vous exprimez votre intention et la compétence gère la complexité, qu'il s'agisse de la détection des modèles d'erreur, de l'analyse des anomalies ou de la corrélation des causes premières.

Exemple d'invite :

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

L'agent exécute des requêtes PPL pour identifier les modèles d'erreurs et les anomalies du volume des journaux, puis met en corrélation les erreurs de journal avec des traces spécifiques IDs pour accélérer l'analyse des causes profondes, sans que vous ayez à maîtriser la syntaxe PPL ou à parcourir manuellement les données de suivi.

Étudier les traces distribuées

La trace-analytics compétence examine les traces distribuées directement à l'intérieur OpenSearch. Il identifie les lenteurs, les intervalles d'erreur et les dépendances entre les services, et met en corrélation les journaux et les traces à l'aide du suivi IDs pour identifier les causes profondes dans l'ensemble de la pile d'observabilité.

Exemple d'invite :

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

L'agent crée une carte des services, identifie les périodes lentes et identifie les goulots d'étranglement, sans que vous ayez à parcourir manuellement les données de suivi entre les services.

Déployer OpenSearch vers AWS

Cette aws-setup compétence explique à votre agent comment configurer un domaine de OpenSearch service ou une collection OpenSearch sans serveur, configurer des politiques d'accès et de chiffrement et connecter votre application, grâce à des guides distincts pour les domaines gérés et les collections sans serveur.

Exemple d'invite :

Set up an OpenSearch Serverless collection for my search application

L'agent gère le provisionnement, la configuration des politiques et la validation, en vous guidant à chaque étape.

Compétences disponibles

Les compétences sont organisées par catégorie. Vous pouvez installer la collection complète ou des compétences individuelles :

Catégorie Compétence Ce qu'il fait
Recherche opensearch-launchpad Échafaude une application de recherche à partir de zéro. Couvre la recherche BM25 lexicale, la recherche sémantique, la recherche hybride et la recherche agentique. Comprend des guides de sélection de modèles, des stratégies d'évaluation et des exemples de données.
Observabilité log-analytics Interroge et analyse les journaux à l'aide du langage PPL (Piped Processing Language). Aide l'agent à détecter les modèles d'erreur, les anomalies de surface et à corréler les événements entre les index.
Observabilité trace-analytics Étudie les traces distribuées. Identifie les périodes de lenteur, crée des cartes de service et trace les invocations d'outils d'agent AI dans votre système.
Cloud aws-setup Se déploie OpenSearch vers. AWS Comprend des guides dédiés aux domaines Amazon OpenSearch Service et aux collections OpenSearch sans serveur, couvrant le provisionnement, les politiques d'accès et la configuration du réseau.

Le projet est en cours de développement actif. Pour obtenir la dernière liste des compétences et les conseils en matière de contribution, consultez le opensearch-agent-skillsréférentiel.

Conditions préalables

Les prérequis varient en fonction des compétences. Pour utiliser la collection complète, vous devez :

  • Un agent de codage qui prend en charge les compétences des agents (Claude Code, Cursor ou Kiro).

  • Node.js avec npx sur votrePATH, pour exécuter le skills programme d'installation.

  • uvet Python 3.11 ou version ultérieure. Compétences utilisées uv pour exécuter des scripts dans des environnements isolés.

  • Docker est installé et fonctionne, si vous prévoyez d'utiliser des compétences permettant de créer un cluster local (par exempleopensearch-launchpad).

  • AWS informations d'identification configurées avec les autorisations appropriées si vous prévoyez d'utiliser la aws-setup compétence. Pour obtenir des conseils sur les autorisations requises, consultezPolitiques basées sur l’identité.

Compétences d'installation et d'utilisation

Les compétences s'installent via la skillsCLI, que vous invoquez avecnpx. Le programme d'installation détecte votre agent et place les fichiers de compétences au bon endroit.

Pour installer l'ensemble de la collection :

npx skills add opensearch-project/opensearch-agent-skills

Pour installer une seule compétence, utilisez le @skill-name suffixe. Le --full-depth drapeau inclut tous les documents de référence dont l'agent peut avoir besoin pour les questions de suivi :

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

Options d'installation courantes :

-a agent-name

Effectuez l'installation sur un agent spécifique, par exemple-a claude-code.

-g

Installez-le globalement afin que la compétence soit disponible dans tous les projets de votre machine.

--all

Effectuez l'installation sur chaque agent détecté par la CLI sur votre machine.

Après l'installation, redémarrez votre agent afin qu'il récupère les nouveaux fichiers de compétences. Essayez ensuite une invite telle que « Je souhaite créer une application de recherche hybride avec » OpenSearch. L'agent lit les instructions relatives aux compétences et exécute directement les scripts requis.

La aws-setup compétence inclut des guides dédiés aux deux familles OpenSearch de produits de service. Pour les domaines gérés par Amazon OpenSearch Service, la compétence couvre la création d'un domaine, la configuration des politiques d'accès et la connexion de votre application (voirIntroduction). Pour OpenSearch Serverless, cela couvre la création d'une collection, la configuration des politiques d'accès aux données et de chiffrement, ainsi que l'ingestion de données (voirAmazon OpenSearch sans serveur). Pour les requêtes interactives portant sur un cluster en cours d'exécution, associez les compétences auOpenSearch serveur MCP.

Considérations sur la sécurité

Lorsque vous installez et exécutez une compétence, votre agent exécute les scripts et les commandes qu'elle décrit. Traitez les compétences comme n'importe quel outil de développement tiers :

  • Consultez le SKILL.md fichier de la compétence dans le référentiel source avant de procéder à l'installation.

  • Exécutez les compétences dans un environnement de développement ou de sandbox avant de les orienter vers les ressources de production.

  • Utilisez les informations d'identification IAM dotées du moindre privilège lors de l'exécution de la aws-setup compétence, dans le périmètre Compte AWS et à l' Région AWS endroit où vous avez l'intention de déployer.

  • Passez en revue toutes les AWS ressources créées par la compétence avant de vous engager dans une infrastructure à long terme. Les compétences peuvent fournir des domaines, des collections, des rôles IAM et des ressources réseau en votre nom.

Ressources supplémentaires