View a markdown version of this page

OpenSearch Keterampilan Agen - OpenSearch Layanan Amazon

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

OpenSearch Keterampilan Agen

Pengembang saat ini dapat beralih dari ide ke prototipe kerja dalam hitungan menit menggunakan agen IDEs seperti Kiro, Claude Code, dan Cursor. Tetapi apakah Anda sedang bereksperimen dengan ide baru, membangun bukti konsep, atau menjalankan sistem produksi, pengalaman dengan cepat menjadi lebih kompleks. Hasil penelusuran tidak berperilaku seperti yang diharapkan, lonjakan latensi memerlukan penggalian log, dan penerapan untuk AWS memperkenalkan keputusan konfigurasi yang membutuhkan keahlian mendalam. Menerjemahkan maksud tingkat tinggi ke dalam kueri DSLs, konfigurasi indeks, dan alur kerja multi-langkah masih membutuhkan waktu yang signifikan — bahkan dengan agen AI di sisi Anda.

OpenSearch Keterampilan Agen mengatasi hal ini dengan menyediakan gudang keterampilan yang membawa OpenSearch intelijen langsung ke agen Anda. Setiap keterampilan merangkum pengetahuan domain, praktik terbaik, dan logika eksekusi multi-langkah untuk alur kerja tertentu — sehingga agen Anda tidak hanya mendapatkan hasil, tetapi juga memahami bagaimana mereka dicapai. Keterampilan bekerja dengan agen pengkodean apa pun yang mendukung standar Keterampilan Agen, termasuk Kiro, Claude Code, dan Kursor.

Apa yang dapat Anda lakukan dengan Keterampilan Agen

opensearch-launchpadKeterampilan ini membawa pengalaman yang didorong oleh niat untuk membangun dan mengulangi aplikasi pencarian. Ini menerjemahkan persyaratan bahasa alami atau data sampel ke dalam OpenSearch indeks yang sepenuhnya dikonfigurasi — dengan pemetaan yang dioptimalkan, saluran pipa konsumsi, dan integrasi model ML untuk pencarian kata kunci, semantik, dan hibrida — dan menghasilkan pengalaman pencarian kerja yang siap untuk diuji dan diulang.

Contoh prompt:

Build a semantic search application for product documentation

Agen mengonfigurasi pemetaan indeks, menyiapkan model penyematan dan pipeline konsumsi, dan mengembalikan API dan UI pencarian yang berfungsi — memandu Anda melalui setiap keputusan di sepanjang jalan.

Selidiki insiden dengan analisis log

log-analyticsKeterampilan ini membawa kecerdasan agen ke alur kerja observabilitas. Alih-alih membuat kueri Piped Processing Language (PPL) secara manual atau menyatukan data log di seluruh layanan, Anda mengekspresikan maksud Anda dan keterampilan menangani kompleksitas — mulai dari deteksi pola kesalahan hingga analisis anomali hingga korelasi akar penyebab.

Contoh prompt:

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

Agen menjalankan kueri PPL untuk memunculkan pola kesalahan dan anomali volume log, kemudian menghubungkan kesalahan log dengan jejak IDs tertentu untuk analisis akar penyebab yang lebih cepat — tanpa mengharuskan Anda menguasai sintaks PPL atau menavigasi data jejak secara manual.

Selidiki jejak yang didistribusikan

trace-analyticsKeterampilan menyelidiki jejak yang didistribusikan langsung di dalam OpenSearch. Ini mengidentifikasi rentang lambat, rentang kesalahan, dan dependensi layanan, dan mengkorelasikan log dan jejak menggunakan jejak IDs ke permukaan akar penyebab di seluruh tumpukan observabilitas penuh.

Contoh prompt:

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

Agen membuat peta layanan, mengidentifikasi rentang lambat, dan menunjukkan kemacetan — tanpa mengharuskan Anda menavigasi data jejak secara manual di seluruh layanan.

Menyebarkan ke OpenSearch AWS

aws-setupKeterampilan ini memandu agen Anda melalui penyediaan domain OpenSearch Layanan atau koleksi OpenSearch Tanpa Server, mengonfigurasi kebijakan akses dan enkripsi, dan menghubungkan aplikasi Anda — dengan panduan terpisah untuk domain terkelola dan koleksi tanpa server.

Contoh prompt:

Set up an OpenSearch Serverless collection for my search application

Agen menangani penyediaan, konfigurasi kebijakan, dan validasi, memandu Anda melalui setiap langkah.

Keterampilan yang tersedia

Keterampilan diatur berdasarkan kategori. Anda dapat menginstal koleksi lengkap atau keterampilan individu:

Kategori Keterampilan Apa yang dilakukannya
Pencarian opensearch-launchpad Perancah aplikasi pencarian dari awal. Meliputi pencarian BM25 leksikal, pencarian semantik, pencarian hibrida, dan pencarian agen. Termasuk panduan pemilihan model, strategi evaluasi, dan data sampel.
Observabilitas log-analytics Kueri dan analisis log menggunakan Piped Processing Language (PPL). Membantu agen mendeteksi pola kesalahan, anomali permukaan, dan menghubungkan peristiwa di seluruh indeks.
Observabilitas trace-analytics Menyelidiki jejak yang didistribusikan. Mengidentifikasi rentang lambat, membangun peta layanan, dan melacak pemanggilan alat agen AI melalui sistem Anda.
Cloud aws-setup Menyebarkan OpenSearch ke AWS. Termasuk panduan khusus untuk domain OpenSearch Layanan Amazon dan koleksi OpenSearch Tanpa Server, yang mencakup penyediaan, kebijakan akses, dan konfigurasi jaringan.

Proyek ini sedang dalam pengembangan aktif. Untuk daftar keterampilan dan panduan kontribusi terbaru, lihat opensearch-agent-skillsrepositori.

Prasyarat

Prasyarat bervariasi menurut keterampilan. Untuk menggunakan koleksi lengkap yang Anda butuhkan:

  • Agen pengkodean yang mendukung Keterampilan Agen (Claude Code, Cursor, atau Kiro).

  • Node.js dengan npx pada AndaPATH, untuk menjalankan skills installer.

  • uvdan Python 3.11 atau yang lebih baru. Keterampilan digunakan uv untuk menjalankan skrip di lingkungan yang terisolasi.

  • Docker diinstal dan dijalankan, jika Anda berencana untuk menggunakan keterampilan yang memutar cluster lokal (sepertiopensearch-launchpad).

  • AWS kredensil yang dikonfigurasi dengan izin yang sesuai jika Anda berencana untuk menggunakan keterampilan tersebut. aws-setup Untuk panduan tentang izin yang diperlukan, lihatKebijakan berbasis identitas.

Instal dan gunakan keterampilan

Keterampilan dipasang melalui skillsCLI, yang Anda panggil. npx Pemasang mendeteksi agen Anda dan menempatkan file keterampilan di lokasi yang benar.

Untuk menginstal seluruh koleksi:

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

Untuk menginstal keterampilan tunggal, gunakan @skill-name sufiks. --full-depthBendera mencakup semua bahan referensi yang mungkin diperlukan agen untuk pertanyaan lanjutan:

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

Opsi pemasangan umum:

-a agent-name

Instal ke agen tertentu, misalnya-a claude-code.

-g

Instal secara global sehingga keterampilan tersedia di semua proyek di komputer Anda.

--all

Instal ke setiap agen yang terdeteksi CLI pada mesin Anda.

Setelah instalasi, restart agen Anda sehingga mengambil file keterampilan baru. Kemudian coba prompt seperti “Saya ingin membangun aplikasi pencarian hybrid dengan OpenSearch.” Agen membaca instruksi keterampilan dan menjalankan skrip yang diperlukan secara langsung.

aws-setupKeterampilan ini mencakup panduan khusus untuk kedua keluarga produk OpenSearch Layanan. Untuk domain terkelola OpenSearch Layanan Amazon, keterampilan berjalan melalui pembuatan domain, mengonfigurasi kebijakan akses, dan menghubungkan aplikasi Anda (lihatIntroduction). Untuk OpenSearch Tanpa Server, ini mencakup pembuatan koleksi, mengonfigurasi akses data dan kebijakan enkripsi, dan menelan data (lihat). Amazon Tanpa OpenSearch Server Untuk kueri interaktif terhadap cluster yang sedang berjalan, pasangkan keterampilan dengan. OpenSearch Server MCP

Pertimbangan keamanan

Ketika Anda menginstal dan menjalankan keterampilan, agen Anda mengeksekusi skrip dan perintah yang dijelaskan. Perlakukan keterampilan seperti yang Anda lakukan pada alat pengembang pihak ketiga:

  • Tinjau SKILL.md file keterampilan di repositori sumber sebelum menginstal.

  • Jalankan keterampilan dalam lingkungan pengembangan atau kotak pasir sebelum mengarahkannya ke sumber daya produksi.

  • Gunakan kredensil IAM dengan hak istimewa paling sedikit saat menjalankan aws-setup keterampilan, cakupan ke dan di mana Anda ingin menerapkan. Akun AWS AWS Region

  • Tinjau AWS sumber daya apa pun yang diciptakan keterampilan sebelum berkomitmen pada infrastruktur berumur panjang. Keterampilan dapat menyediakan domain, koleksi, peran IAM, dan sumber daya jaringan atas nama Anda.

Sumber daya tambahan