View a markdown version of this page

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

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

Ambil catatan memori

Anda dapat mengambil memori yang diekstraksi menggunakan RetrieveMemoryRecords API. 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 ini membutuhkan parameter kunci berikut:

ID Memori

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

ruang nama

Namespace yang tepat tempat catatan memori disimpan. Operasi mengembalikan catatan memori berpaginasi dalam ruang nama yang cocok dengan namespace yang disediakan.

NamaSpacePATH

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

Kriteria penelusuran

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 untuk 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 vektor penyematan. Skor ini tidak mewakili kecocokan persentase, tetapi 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 dipaginasi, dengan default maksimum 100 hasil per halaman. Anda dapat menggunakan nextToken parameter untuk mengambil halaman tambahan hasil.

Praktik terbaik

Saat mengambil memori, pertimbangkan praktik terbaik berikut:

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

  • 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 mem memoryStrategyId filter berdasarkan kapan 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.