View a markdown version of this page

OpenSearch Competenze degli agenti - OpenSearch Servizio Amazon

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 risolve questo problema fornendo un archivio di competenze che apportano l'intelligenza direttamente al tuo agente. OpenSearch Ogni competenza racchiude conoscenze di dominio, best practice e logica di esecuzione in più fasi per un flusso di lavoro specifico, in modo che l'agente non solo ottenga risultati, ma comprenda anche come sono stati raggiunti. Le competenze funzionano con qualsiasi agente di codifica che supporti lo standard Agent Skills, inclusi Kiro, Claude Code e Cursor.

Cosa puoi fare con Agent Skills

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-skillsrepository.

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 npx on yourPATH, per eseguire il programma di installazione. skills

  • uve Python 3.11 o successivo. Competenze utilizzate uv per eseguire script in ambienti isolati.

  • Docker installato e funzionante, se prevedi di utilizzare competenze che generano un cluster locale (comeopensearch-launchpad).

  • AWS credenziali configurate con le autorizzazioni appropriate se prevedi di utilizzare la skill. aws-setup Per indicazioni sulle autorizzazioni richieste, consulta. Policy basate sull’identità

Installa e usa le competenze

Le competenze vengono installate tramite la skillsCLI, con cui si richiama. npx 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:

-a agent-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.md file della skill nel repository dei sorgenti prima 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-setup skill, 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