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

Cari catatan registri

Sebagai konsumen, Anda dapat mencari catatan registri yang disetujui menggunakan API SearchDiscoverableRegistryRecords data-plane. API menerima kueri bahasa alami, menerapkan pencarian hibrida yang menggabungkan pemahaman semantik dengan pencocokan kata kunci, dan mengembalikan hasil peringkat terbatas pada catatan yang revisi terbarunya memiliki status Dis etujui. Catatan dalam status D raf, Penund aan persetujuan, Dit olak, atau Tidak digunakan lagi tidak dikembalikan. Untuk menelusuri katalog tanpa kueri, gunakan ListDiscoverableRegistryRecords dan sebagai BatchGetDiscoverableRegistryRecord gantinya — lihat Menelus uri catatan yang disetujui.

Anda juga dapat memanggil API bidang data penemuan melalui titik akhir MCP registri (InvokeRegistryMcp) menggunakan klien apa pun. MCP-compatible Titik akhir mengeksposSearchDiscoverableRegistryRecords,ListDiscoverableRegistryRecords, dan BatchGetDiscoverableRegistryRecord sebagai alat MCP yang dapat Anda panggil secara langsung.

Parameter Permintaan

Filter metadata

Operator:$eq,$ne,$in. Logis:$and,$or. Bidang:name,recordType,recordVersion.

Contoh: {"recordType": {"$eq": "MCP"}}

Gabungan: {"$and": [{"recordType": {"$eq": "MCP"}}, {"recordVersion": {"$eq": "1.0"}}]}

Konsol

AWS CLI (Registri dengan Otorisasi Masuk berbasis IAM)

AWS SDK (Registri dengan Otorisasi Masuk berbasis IAM)

Klien HTTP (Registri dengan OAuth berbasis OAuth Inbound Authorization)

Pertama dapatkan token pembawa:

SECRET_HASH=$(echo -n "<username><appClientId>" | openssl dgst -sha256 -hmac "<appClientSecret>" -binary | base64)

aws cognito-idp initiate-auth \
  --client-id "<appClientId>" \
  --auth-flow USER_PASSWORD_AUTH \
  --auth-parameters USERNAME="<username>",PASSWORD='<password>',SECRET_HASH="$SECRET_HASH" \
  --region us-east-1 | jq -r '.AuthenticationResult.AccessToken'

Kemudian cari dengan token pembawa:

Konsistensi akhirnya dalam AWS Pencarian Pendaftaran Agen

AWS Agen Registry menggunakan model yang akhirnya konsisten untuk pengindeksan pencarian. Saat Anda menyetujui rekaman registri dengan menelepon UpdateRegistryRecordStatus atau melalui konsol, catatan tidak muncul SearchDiscoverableRegistryRecords atau InvokeRegistryMcp menghasilkan segera. Biasanya dibutuhkan beberapa detik untuk catatan yang disetujui untuk diindeks dan dapat ditemukan, tetapi dalam beberapa kasus dapat memakan waktu hingga beberapa menit.

Selama waktu ini, Anda mungkin mengamati perilaku berikut:

Hanya catatan dalam status Dis etujui yang disertakan dalam hasil yang dapat ditemukan. Catatan dalam status Draf, Persetujuan Tertunda, Ditolak, atau Tidak pernah dikembalikan oleh API bidang data yang dapat ditemukan atau oleh. InvokeRegistryMcp Anda dapat memverifikasi status rekaman saat ini dengan memanggilGetRegistryRecord, yang selalu mengembalikan revisi terbaru terlepas dari status pengindeksan.

Untuk menangani konsistensi akhir dalam aplikasi Anda, kami merekomendasikan hal berikut:

Untuk panduan umum tentang mengonfigurasi perilaku coba ulang di AWS SDK, lihat Perilaku coba ulang di Panduan Referensi AWS SDK dan Alat.

Bagaimana atribut rekaman memengaruhi relevansi pencarian

AWS Agen Registry menggunakan pencarian hybrid yang menggabungkan pemahaman semantik dengan pencocokan kata kunci untuk mengembalikan hasil yang relevan. Jika rekaman yang ingin Anda temukan tidak muncul di hasil penelusuran, memahami atribut rekaman mana yang memengaruhi pencarian dapat membantu.

Atribut rekaman mana yang digunakan untuk pencarian

Atribut berikut dari catatan registri Anda digunakan untuk menentukan relevansi pencarian:

Bagaimana permintaan pencarian diproses

Saat Anda memanggilSearchDiscoverableRegistryRecords, AWS Agen Registry menjalankan dua pencarian secara paralel terhadap kumpulan catatan yang diindeks yang sama dan menggabungkan hasilnya:

Jika Anda menyertakan filter metadata dalam permintaan Anda, filter diterapkan ke kedua penelusuran sebelum hasil dinilai dan diberi peringkat. Ini berarti filter mengurangi kumpulan kandidat yang digunakan oleh pencarian semantik dan kata kunci, daripada memfilter hasil setelah peringkat.

Bagaimana hasil diberi peringkat

Hasil dari pencarian semantik dan kata kunci digabungkan menjadi satu daftar peringkat dan dikembalikan dalam urutan relevansi, dengan catatan yang paling relevan terlebih dahulu. Posisi akhir setiap hasil ditentukan oleh relevansinya di kedua pencarian — catatan yang berperingkat tinggi dalam hasil semantik dan kata kunci akan muncul lebih tinggi daripada catatan yang berperingkat tinggi hanya dalam satu. Dalam pencarian kata kunci, nama catatan memiliki pengaruh terkuat pada peringkat, diikuti oleh deskripsi dan konten deskriptor, yang berkontribusi sama. Karena kedua mode pencarian selalu berjalan dan berkontribusi pada peringkat akhir, cara Anda menulis kueri memengaruhi permukaan catatan mana. Panduan berikut dapat membantu Anda mendapatkan hasil yang lebih baik tergantung pada niat Anda.

Menulis permintaan pencarian yang efektif

Ketika Anda mengetahui nama atau pengidentifikasi yang tepat, gunakan kueri singkat dan spesifik. Pencarian kata kunci mencocokkan teks yang tepat dengan nama catatan, deskripsi, dan konten deskriptor. Kueri pendek seperti “weather-api-v2" atau “pdf-processing” efektif untuk menemukan catatan berdasarkan nama.

Saat Anda menjelajahi berdasarkan kemampuan atau kasus penggunaan, gunakan deskripsi bahasa alami tentang apa yang Anda butuhkan. Pencarian semantik memahami maksud konseptual, sehingga kueri seperti “temukan alat yang dapat memesan penerbangan” atau “ekstrak data terstruktur dari dokumen PDF” dapat mencocokkan catatan yang relevan meskipun kata-kata yang tepat tersebut tidak muncul dalam metadata catatan.

Hindari pencampuran batasan seperti filter dengan maksud deskriptif dalam kueri yang sama. Kueri seperti “temukan semua server MCP untuk prakiraan cuaca” mengirimkan seluruh kalimat melalui pencarian semantik dan kata kunci. Komponen semantik menafsirkan kalimat lengkap sebagai maksud konseptual, yang dapat menampilkan catatan yang terkait secara konseptual tetapi tidak cocok dengan atribut spesifik yang ingin Anda batasi. Sebagai gantinya, gunakan filter metadata untuk batasan berbasis atribut dan jaga agar kueri tetap fokus pada topik. Lihat Kapan menggunakan filter metadata versus teks kueri.

Menulis catatan yang dapat ditemukan

Kapan menggunakan filter metadata versus teks kueri

Gunakan filter metadata jika maksud Anda membatasi hasil dengan atribut yang diketahui seperti jenis rekaman, nama, atau versi. Jangan menyematkan batasan seperti filter dalam teks kueri itu sendiri. Misalnya, jika Anda ingin menemukan semua server MCP yang terkait dengan cuaca, gunakan filter metadata untuk jenis rekaman dan kueri untuk topik:

{
  "searchQuery": "weather forecast",
  "filters": {
    "recordType": { "$eq": "MCP" }
  }
}

Hindari menempatkan batasan ke dalam teks kueri seperti “temukan semua server MCP untuk prakiraan cuaca”. Karena kueri yang lebih panjang condong ke pencocokan semantik, kata-kata “server MCP” ditafsirkan sebagai bagian dari maksud konseptual daripada sebagai filter yang tepat. Hal ini dapat menyebabkan komponen semantik mengembalikan catatan yang secara konseptual terkait dengan kalimat lengkap tetapi tidak cocok dengan atribut spesifik yang ingin Anda filter — misalnya, mengembalikan catatan agen tentang cuaca bersama catatan server MCP. Hal yang sama berlaku untuk batasan berbasis atribut apa pun. Jika Anda ingin rekaman dengan nama, versi, atau jenis tertentu, gunakan filter metadata yang sesuai daripada menyertakan istilah tersebut dalam kueri.

Anda dapat memfilter pada bidang berikut:

Filter mendukung operator $eq (sama), $ne (tidak sama), dan $in (cocok dengan nilai apa pun dalam daftar), dan dapat digabungkan menggunakan $or logika $and dan.

Misalnya, untuk mencari server MCP terkait cuaca saja:

{
  "searchQuery": "weather forecast",
  "filters": {
    "recordType": { "$eq": "MCP" }
  }
}

Untuk mengecualikan jenis sumber daya tertentu:

{
  "searchQuery": "<your query>",
  "filters": {
    "recordType": { "$ne": "CUSTOM" }
  }
}

Untuk mencocokkan salah satu dari beberapa versi:

{
  "filters": {
    "recordVersion": { "$in": ["1.0", "1.1", "2.0"] }
  }
}

Pencarian hanya mengembalikan catatan yang disetujui

Hanya catatan dalam status Disetujui yang muncul di hasil pencarian dan melalui titik akhir MCP. Catatan dalam status Draf, Persetujuan Tertunda, Ditolak, atau Tidak digunakan lagi tidak dikembalikan. Jika catatan yang baru disetujui tidak muncul dalam hasil, lihat Konsistensi akhir dalam pencarian Registri AWS Agen.