View a markdown version of this page

OpenSearch Fähigkeiten der Agenten - OpenSearch Amazon-Dienst

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

OpenSearch Fähigkeiten der Agenten

Entwickler können heute mithilfe von Tools IDEs wie Kiro, Claude Code und Cursor innerhalb von Minuten von der Idee zum funktionierenden Prototyp übergehen. Aber ganz gleich, ob Sie mit einer neuen Idee experimentieren, einen Machbarkeitsnachweis erstellen oder Produktionssysteme ausführen, die Erfahrung wird schnell komplexer. Die Suchergebnisse verhalten sich nicht wie erwartet, Latenzspitzen erfordern das Durchforsten von Protokollen und die Bereitstellung, um Konfigurationsentscheidungen einzuführen, die AWS fundiertes Fachwissen erfordern. Die Umsetzung von allgemeinen Absichten in Abfragen DSLs, Indexkonfigurationen und mehrstufige Workflows nimmt immer noch viel Zeit in Anspruch — selbst mit einem KI-Agenten an Ihrer Seite.

OpenSearch Agent Skills löst dieses Problem, indem es eine Sammlung von Fähigkeiten bereitstellt, die OpenSearch Informationen direkt in Ihren Agenten einbringen. Jede Fähigkeit beinhaltet Fachwissen, bewährte Methoden und mehrstufige Ausführungslogik für einen bestimmten Arbeitsablauf. So erhält Ihr Agent nicht nur Ergebnisse, sondern versteht auch, wie diese erzielt wurden. Skills funktionieren mit jedem Coding-Agenten, der den Agent Skills-Standard unterstützt, einschließlich Kiro, Claude Code und Cursor.

Was Sie mit Agent Skills machen können

Diese opensearch-launchpad Fähigkeit bietet eine absichtsorientierte Erfahrung bei der Entwicklung und Weiterentwicklung von Suchanwendungen. Sie übersetzt Anforderungen in natürlicher Sprache oder Beispieldaten in einen vollständig konfigurierten OpenSearch Index — mit optimierten Mappings, Ingest-Pipelines und ML-Modellintegrationen für Schlüsselwort-, semantische und hybride Suchen — und bietet eine funktionierende Sucherfahrung, die getestet und wiederholt werden kann.

Beispielaufforderung:

Build a semantic search application for product documentation

Der Agent konfiguriert die Indexzuordnungen, richtet ein Einbettungsmodell und eine Ingest-Pipeline ein und gibt eine funktionierende Such-API und Benutzeroberfläche zurück, sodass Sie Schritt für Schritt durch jede Entscheidung geführt werden.

Untersuchen Sie Vorfälle mit Protokollanalysen

Diese log-analytics Fähigkeit bringt Agentenintelligenz in Observability-Workflows. Anstatt PPL-Abfragen (Piped Processing Language) manuell zu erstellen oder Protokolldaten dienstübergreifend zusammenzufügen, drücken Sie Ihre Absicht aus und der Skill kümmert sich um die Komplexität — von der Fehlermustererkennung über die Anomalieanalyse bis hin zur Korrelation der Ursache.

Beispiel für eine Aufforderung:

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

Der Agent führt PPL-Abfragen durch, um Fehlermuster aufzudecken und Volumenanomalien zu protokollieren, und korreliert dann Protokollfehler mit bestimmten IDs Traces, um die Ursachenanalyse zu beschleunigen — ohne dass Sie die PPL-Syntax beherrschen oder die Trace-Daten manuell durchsuchen müssen.

Untersuchen Sie verteilte Traces

Der trace-analytics Skill untersucht verteilte Spuren direkt im Inneren OpenSearch. Sie identifiziert Zeitspannen, Fehlerspannen und Serviceabhängigkeiten und korreliert Logs und Traces mithilfe von Trace, IDs um die Ursachen im gesamten Observability-Stack aufzudecken.

Beispiel für eine Aufforderung:

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

Der Agent erstellt eine Service-Map, identifiziert die langsamen Zeitspannen und lokalisiert den Engpass, ohne dass Sie die Trace-Daten manuell zwischen den Services durchsuchen müssen.

Bereitstellen auf OpenSearch AWS

Dieser aws-setup Skill führt Ihren Agenten durch die Bereitstellung einer OpenSearch Service-Domain oder einer OpenSearch serverlosen Sammlung, die Konfiguration von Zugriffs- und Verschlüsselungsrichtlinien und die Verbindung Ihrer Anwendung — mit separaten Anleitungen für verwaltete Domänen und serverlose Sammlungen.

Beispiel für eine Aufforderung:

Set up an OpenSearch Serverless collection for my search application

Der Agent kümmert sich um die Bereitstellung, Richtlinienkonfiguration und Validierung und führt Sie durch jeden Schritt.

Verfügbare Fähigkeiten

Die Fähigkeiten sind nach Kategorien geordnet. Sie können die gesamte Sammlung oder einzelne Fähigkeiten installieren:

Kategorie Fähigkeit Was es macht
Suchen opensearch-launchpad Erstellt eine Suchanwendung von Grund auf neu. Deckt die BM25 lexikalische Suche, die semantische Suche, die Hybridsuche und die Agentensuche ab. Enthält Anleitungen zur Modellauswahl, Bewertungsstrategien und Beispieldaten.
Beobachtbarkeit log-analytics Fragt Protokolle mithilfe der Piped Processing Language (PPL) ab und analysiert sie. Hilft dem Agenten, Fehlermuster zu erkennen, Anomalien aufzudecken und Ereignisse indexübergreifend zu korrelieren.
Beobachtbarkeit trace-analytics Untersucht verteilte Traces. Identifiziert langsame Zeitspannen, erstellt Service Maps und verfolgt Aufrufe von KI-Agent-Tools in Ihrem System.
Cloud aws-setup Wird bereitgestellt auf. OpenSearch AWS Enthält spezielle Anleitungen für Amazon OpenSearch Service-Domains und OpenSearch serverlose Sammlungen, die sich mit Bereitstellung, Zugriffsrichtlinien und Netzwerkkonfiguration befassen.

Das Projekt befindet sich in aktiver Entwicklung. Die aktuelle Liste der Fähigkeiten und Anleitungen zu Beiträgen finden Sie im opensearch-agent-skillsRepository.

Voraussetzungen

Die Voraussetzungen variieren je nach Fähigkeit. Um die gesamte Sammlung nutzen zu können, benötigen Sie:

  • Ein Programmieragent, der Agent Skills unterstützt (Claude Code, Cursor oder Kiro).

  • Node.js mit npx auf IhremPATH, um das skills Installationsprogramm auszuführen.

  • uvund Python 3.11 oder höher. Fähigkeitenuv, die zum Ausführen von Skripten in isolierten Umgebungen verwendet werden.

  • Docker ist installiert und läuft, wenn Sie Skills verwenden möchten, die einen lokalen Cluster einrichten (z. B.opensearch-launchpad).

  • AWS Anmeldeinformationen, die mit den entsprechenden Berechtigungen konfiguriert sind, falls Sie den aws-setup Skill verwenden möchten. Hinweise zu den erforderlichen Berechtigungen finden Sie unterIdentitätsbasierte Richtlinien.

Fähigkeiten installieren und verwenden

Skills werden über die skillsCLI installiert, mit npx der Sie sie aufrufen. Das Installationsprogramm erkennt Ihren Agenten und platziert die Skill-Dateien am richtigen Ort.

So installieren Sie die gesamte Sammlung:

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

Verwenden Sie das @skill-name Suffix, um einen einzelnen Skill zu installieren. Die --full-depth Markierung enthält das gesamte Referenzmaterial, das der Agent möglicherweise für weitere Fragen benötigt:

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

Allgemeine Installationsoptionen:

-a agent-name

Installieren Sie beispielsweise auf einem bestimmten Agenten-a claude-code.

-g

Installieren Sie global, sodass der Skill für alle Projekte auf Ihrem Computer verfügbar ist.

--all

Installieren Sie es auf jedem Agenten, den die CLI auf Ihrem Computer erkennt.

Starten Sie Ihren Agenten nach der Installation neu, damit er die neuen Skill-Dateien aufnimmt. Versuchen Sie es dann mit einer Aufforderung wie „Ich möchte eine Hybrid-Such-App mit erstellen“ OpenSearch. Der Agent liest die Skill-Anweisungen und führt die erforderlichen Skripts direkt aus.

Der aws-setup Skill umfasst spezielle Anleitungen für beide OpenSearch Service-Produktfamilien. Bei von Amazon OpenSearch Service verwalteten Domains führt der Skill die Erstellung einer Domain, die Konfiguration von Zugriffsrichtlinien und die Verbindung Ihrer Anwendung durch (sieheIntroduction). Bei OpenSearch Serverless umfasst es das Erstellen einer Sammlung, das Konfigurieren von Datenzugriffs- und Verschlüsselungsrichtlinien sowie das Erfassen von Daten (sieheAmazon OpenSearch Serverlos). Kombinieren Sie bei interaktiven Abfragen für einen laufenden Cluster die Fähigkeiten mit dem. OpenSearch MCP-Server

Sicherheitsüberlegungen

Wenn Sie einen Skill installieren und ausführen, führt Ihr Agent die darin beschriebenen Skripts und Befehle aus. Behandeln Sie Skills wie jedes Entwicklertool eines Drittanbieters:

  • Prüfen Sie vor der Installation die SKILL.md Skill-Datei im Quell-Repository.

  • Führen Sie Skills in einer Entwicklungs- oder Sandbox-Umgebung aus, bevor Sie sie auf Produktionsressourcen verweisen.

  • Verwenden Sie IAM-Anmeldeinformationen mit den geringsten Rechten, wenn Sie den aws-setup Skill ausführen, und zwar für den Bereich und den Ort, an dem AWS-Konto Sie ihn einsetzen möchten. AWS-Region

  • Prüfen Sie alle AWS Ressourcen, die durch den Skill geschaffen werden, bevor Sie sich für eine langlebige Infrastruktur entscheiden. Skills können in Ihrem Namen Domänen, Sammlungen, IAM-Rollen und Netzwerkressourcen bereitstellen.

Weitere Ressourcen