View a markdown version of this page

Ambil catatan memori - Batuan Dasar Amazon AgentCore
Parameter yang diperlukanFormat responsPraktik terbaik

Ambil catatan memori

Anda dapat mengambil memori yang diekstraksi menggunakan API. RetrieveMemoryRecords Operasi ini memungkinkan Anda mencari catatan memori yang diekstraksi berdasarkan kueri semantik, sehingga mudah untuk menemukan informasi yang relevan dari memori agen Anda.

Parameter yang diperlukan

RetrieveMemoryRecordsOperasi membutuhkan parameter kunci berikut:

MemoryID

Pengidentifikasi sumber daya memori yang berisi catatan yang ingin Anda ambil.

namespace

Namespace yang tepat di mana catatan memori disimpan. Operasi mengembalikan catatan memori paginasi di ruang nama yang cocok dengan namespace yang disediakan.

NamespacePath

Jalur namespace tempat catatan memori disimpan. Operasi mengembalikan catatan memori paginasi di bawah hierarki ruang nama yang disediakan yang dimulai dengan jalur yang disediakan.

SearchCriteria

Struktur yang berisi parameter pencarian:

  • SearchQuery - Teks kueri semantik yang digunakan untuk menemukan memori yang relevan (hingga 10.000 karakter).

  • memori StrategyId (opsional) - Membatasi pencarian ke memori yang dibuat oleh strategi tertentu.

  • TopK - Jumlah maksimum hasil yang paling relevan untuk dikembalikan (default: 10, maksimum: 100).

Format respons

Operasi mengembalikan daftar ringkasan catatan memori yang cocok dengan kriteria pencarian Anda. Setiap ringkasan mencakup skor relevansi, yang diturunkan dari kesamaan kosinus dari vektor penyematan. Skor ini tidak mewakili persentase kecocokan, melainkan mengukur seberapa dekat dua vektor sejajar dalam ruang dimensi tinggi. Skor yang lebih tinggi menunjukkan relevansi yang lebih besar dari catatan memori dengan permintaan pencarian. Hasilnya diberi paginasi, dengan maksimum default 100 hasil per halaman. Anda dapat menggunakan nextToken parameter untuk mengambil halaman hasil tambahan.

Praktik terbaik

Saat mengambil ingatan, pertimbangkan praktik terbaik berikut:

  • Buat kueri penelusuran khusus yang menjelaskan dengan jelas informasi yang Anda cari.

  • Gunakan topK parameter untuk mengontrol jumlah hasil berdasarkan kebutuhan aplikasi Anda.

  • Saat bekerja dengan memori besar, terapkan pagination untuk memproses semua hasil yang relevan secara efisien.

  • Pertimbangkan untuk memfilter memoryStrategyId saat Anda membutuhkan memori dari strategi ekstraksi tertentu.

Setelah diambil, catatan memori ini dapat dimasukkan ke dalam konteks agen Anda, memungkinkan respons yang lebih personal dan sadar kontekstual.