Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
OpenSearch Competenze degli agenti
Oggi gli sviluppatori possono passare dall'idea al prototipo funzionante in pochi minuti utilizzando agenti IDEs come Kiro, Claude Code e Cursor. Ma che stiate sperimentando una nuova idea, costruendo un proof of concept o utilizzando sistemi di produzione, l'esperienza diventa rapidamente più complessa. I risultati della ricerca non si comportano come previsto, i picchi di latenza richiedono l'analisi dei log e l'implementazione AWS introduce decisioni di configurazione che richiedono competenze approfondite. La traduzione degli intenti di alto livello in query DSLs, configurazioni di indici e flussi di lavoro in più fasi richiede ancora molto tempo, anche con un agente AI al tuo fianco.
OpenSearch Agent Skills
Cosa puoi fare con Agent Skills
Crea un'applicazione di ricerca locale
Questa opensearch-launchpad abilità offre un'esperienza orientata agli intenti per la creazione e l'iterazione di applicazioni di ricerca. Traduce i requisiti del linguaggio naturale o i dati di esempio in un OpenSearch indice completamente configurato, con mappature ottimizzate, pipeline di inserimento e integrazioni di modelli ML per la ricerca basata su parole chiave, semantica e ibrida, e produce un'esperienza di ricerca funzionante pronta per essere testata e rielaborata.
Richiesta di esempio:
Build a semantic search application for product documentation
L'agente configura le mappature degli indici, imposta un modello di incorporamento e una pipeline di importazione e restituisce un'API di ricerca e un'interfaccia utente funzionanti, che ti guidano attraverso ogni decisione lungo il percorso.
Analizza gli incidenti con l'analisi dei log
Questa log-analytics competenza apporta l'intelligenza agentica ai flussi di lavoro di osservabilità. Invece di creare manualmente interrogazioni PPL (Piped Processing Language) o mettere insieme i dati di log dei vari servizi, l'utente esprime le proprie intenzioni e l'abilità si occupa della complessità, dal rilevamento dei pattern di errore all'analisi delle anomalie fino alla correlazione delle cause principali.
Richiesta di esempio:
Investigate why my service is returning 500s and correlate with recent traces
L'agente esegue query PPL per evidenziare i modelli di errore e registrare le anomalie del volume, quindi correla gli errori di registro con una traccia specifica IDs per un'analisi più rapida della causa principale, senza che sia necessario padroneggiare la sintassi PPL o navigare manualmente tra i dati di traccia.
Analizza le tracce distribuite
L'trace-analyticsabilità analizza le tracce distribuite direttamente all'interno OpenSearch. Identifica gli intervalli di lentezza, gli intervalli di errore e le dipendenze dei servizi e mette in correlazione i log e le tracce utilizzando le cause principali da tracciare IDs alla superficie nell'intero stack di osservabilità.
Richiesta di esempio:
Which service is causing the p99 latency regression in the checkout flow?
L'agente crea una mappa dei servizi, identifica gli intervalli di rallentamento e individua il punto debole, senza richiedere la navigazione manuale dei dati di tracciamento tra i servizi.
OpenSearch Esegui la distribuzione su AWS
Questa aws-setup competenza guida l'agente nella procedura di provisioning di un dominio di OpenSearch servizio o di una raccolta OpenSearch Serverless, nella configurazione delle politiche di accesso e crittografia e nel collegamento dell'applicazione, con guide separate per i domini gestiti e le raccolte serverless.
Richiesta di esempio:
Set up an OpenSearch Serverless collection for my search application
L'agente gestisce il provisioning, la configurazione delle politiche e la convalida, guidando l'utente in ogni fase.
Competenze disponibili
Le competenze sono organizzate per categoria. Puoi installare la raccolta completa o le competenze individuali:
| Categoria | Abilità | Cosa fa |
|---|---|---|
| Cerca | opensearch-launchpad |
Scaffolds è un'applicazione di ricerca partendo da zero. Copre la ricerca BM25 lessicale, la ricerca semantica, la ricerca ibrida e la ricerca agentica. Include guide alla selezione dei modelli, strategie di valutazione e dati di esempio. |
| Osservabilità | log-analytics |
Interroga e analizza i log utilizzando il linguaggio PPL (Piped Processing Language). Aiuta l'agente a rilevare modelli di errore, anomalie superficiali e correlare gli eventi tra gli indici. |
| Osservabilità | trace-analytics |
Indaga sulle tracce distribuite. Identifica gli intervalli di tempo lenti, crea mappe dei servizi e traccia le chiamate agli strumenti degli agenti AI attraverso il sistema. |
| Cloud | aws-setup |
OpenSearch AWS Si distribuisce a. Include guide dedicate per i domini Amazon OpenSearch Service e le raccolte OpenSearch Serverless, che coprono il provisioning, le politiche di accesso e la configurazione di rete. |
Il progetto è in fase di sviluppo attivo. Per l'elenco delle competenze e le indicazioni sui contributi più recenti, consulta il opensearch-agent-skills
Prerequisiti
I prerequisiti variano in base all'abilità. Per utilizzare la collezione completa è necessario:
-
Un agente di codifica che supporta Agent Skills (Claude Code, Cursor o Kiro).
-
Node.js
con npxon yourPATH, per eseguire il programma di installazione.skills -
uve Python 3.11 o successivo. Competenze utilizzate uvper eseguire script in ambienti isolati. -
Docker
installato e funzionante, se prevedi di utilizzare competenze che generano un cluster locale (come opensearch-launchpad). -
AWS credenziali configurate con le autorizzazioni appropriate se prevedi di utilizzare la skill.
aws-setupPer indicazioni sulle autorizzazioni richieste, consulta. Policy basate sull’identità
Installa e usa le competenze
Le competenze vengono installate tramite la skillsnpx Il programma di installazione rileva l'agente e colloca i file delle competenze nella posizione corretta.
Per installare l'intera collezione:
npx skills add opensearch-project/opensearch-agent-skills
Per installare una singola abilità, usa il @skill-name suffisso. Il --full-depth flag include tutto il materiale di riferimento di cui l'agente potrebbe aver bisogno per le domande successive:
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
Opzioni di installazione comuni:
-aagent-name-
Installazione su un agente specifico, ad esempio
-a claude-code. -g-
Installa globalmente in modo che la competenza sia disponibile per tutti i progetti sul tuo computer.
--all-
Installa su ogni agente rilevato dalla CLI sul tuo computer.
Dopo l'installazione, riavvia l'agente in modo che raccolga i nuovi file delle abilità. Quindi prova a visualizzare un messaggio come «Voglio creare un'app di ricerca ibrida con OpenSearch». L'agente legge le istruzioni di abilità ed esegue direttamente gli script richiesti.
L'aws-setupabilità include guide dedicate per entrambe le famiglie di prodotti OpenSearch Service. Per i domini gestiti da Amazon OpenSearch Service, la competenza prevede la creazione di un dominio, la configurazione delle politiche di accesso e la connessione dell'applicazione (vediIntroduction). Per OpenSearch Serverless, include la creazione di una raccolta, la configurazione delle politiche di accesso e crittografia ai dati e l'acquisizione di dati (vedi). Amazon OpenSearch Serverless Per le query interattive su un cluster in esecuzione, abbina le competenze a. OpenSearch Server MCP
Considerazioni relative alla sicurezza
Quando installi ed esegui una skill, il tuo agente esegue gli script e i comandi che descrive. Tratta le competenze come faresti con qualsiasi strumento di sviluppo di terze parti:
-
Controlla il
SKILL.mdfile della skill nel repository dei sorgentiprima dell'installazione. -
Esegui le competenze in un ambiente di sviluppo o sandbox prima di destinarle alle risorse di produzione.
-
Utilizza credenziali IAM con privilegi minimi quando esegui la
aws-setupskill, in base all'ambito e dove intendi implementarla. Account AWS Regione AWS -
Esamina tutte AWS le risorse create dalla skill prima di impegnarti in un'infrastruttura di lunga durata. Le competenze possono fornire domini, raccolte, ruoli IAM e risorse di rete per tuo conto.
Risorse aggiuntive
-
opensearch-agent-skills
su GitHub : Fonte, problemi e guida per gli sviluppatori per la creazione di nuove competenze. -
Specifiche Agent Skills
: lo standard aperto implementato dalle competenze. -
OpenSearch Server MCP— Il server MCP complementare per le interrogazioni interattive su un cluster in esecuzione.