View a markdown version of this page

Buat AgentCore Memori - Batuan Dasar Amazon AgentCore

Buat AgentCore Memori

Anda dapat membuat AgentCore Memori dengan AgentCore CLI, AWS konsol, atau dengan operasi CreateMemory AWS SDK. Saat membuat memori, Anda dapat mengonfigurasi pengaturan seperti nama, deskripsi, pengaturan enkripsi, stempel waktu kedaluwarsa untuk acara mentah, dan strategi memori jika Anda ingin mengekstrak memori jangka panjang.

Saat membuat AgentCore Memori, pertimbangkan faktor-faktor berikut untuk mempertahankannya memenuhi kebutuhan aplikasi Anda:

Retensi peristiwa - Pilih berapa lama peristiwa mentah dipertahankan (hingga 365 hari) untuk memori jangka pendek.

catatan

eventExpiryDurationditerapkan per acara pada waktu penulisan. Memperbarui itu hanya mempengaruhi peristiwa yang dibuat setelah perubahan. Peristiwa yang disimpan sebelumnya mempertahankan kedaluwarsa aslinya dan tidak dapat diperpanjang, dan peristiwa yang kedaluwarsa tidak dapat dipulihkan.

Persyaratan keamanan — Jika aplikasi Anda menangani informasi sensitif, pertimbangkan untuk menggunakan kunci AWS KMS yang dikelola pelanggan untuk enkripsi. Layanan masih mengenkripsi data menggunakan kunci yang dikelola layanan, meskipun Anda tidak menyediakan kunci KMS yang dikelola pelanggan AWS .

Strategi memori — Tentukan bagaimana peristiwa diproses menjadi ingatan jangka panjang yang bermakna menggunakan strategi penggantian bawaan atau bawaan. Jika Anda tidak mendefinisikan strategi apa pun, hanya memori jangka pendek yang berisi peristiwa mentah yang disimpan. Untuk informasi lebih lanjut, lihat Menggunakan memori jangka panjang.

Konvensi penamaan — Gunakan nama yang jelas dan deskriptif yang membantu mengidentifikasi tujuan setiap AgentCore Memori, terutama jika aplikasi Anda menggunakan beberapa toko.

contoh
AgentCore CLI

  1. Perintah memori AgentCore CLI harus dijalankan di dalam proyek agentcore yang ada. Jika Anda belum memilikinya, buat proyek terlebih dahulu:

    agentcore create --name my-agent --no-agent
cd my-agent

    Buat memori dasar (hanya jangka pendek):

    agentcore add memory --name my_agent_memory
agentcore deploy

    Buat memori dengan strategi jangka panjang:

    agentcore add memory --name ShoppingSupportAgentMemory \
  --strategies SUMMARIZATION,USER_PREFERENCE
agentcore deploy

    Periksa status memori:

    agentcore status
Interactive

  1. Jalankan agentcore untuk membuka TUI, lalu pilih tambah dan pilih Memori:

  2. Masukkan nama memori:

    Wizard memori: masukkan nama

  3. Pilih durasi kedaluwarsa acara:

    Panduan memori: pilih durasi kedaluwarsa acara

  4. Pilih strategi memori untuk ekstraksi memori jangka panjang:

    Wizard memori: pilih strategi memori

  5. Tinjau konfigurasi dan tekan Enter untuk mengonfirmasi:

    Panduan memori: tinjau konfigurasi
AWS SDK

  1. Untuk informasi lebih lanjut, lihat AWS SDK.

    import boto3
import time

# Initialize the Boto3 clients for control plane and data plane operations
control_client = boto3.client('bedrock-agentcore-control')
data_client = boto3.client('bedrock-agentcore')

print("Creating a new memory resource...")

# Create the memory resource with defined strategies
response = control_client.create_memory(
    name="ShoppingSupportAgentMemory",
    description="Memory for a customer support agent.",
    memoryStrategies=[
        {
            'summaryMemoryStrategy': {
                'name': 'SessionSummarizer',
                'namespaceTemplates': ['/summaries/{actorId}/{sessionId}/']
            }
        },
        {
            'userPreferenceMemoryStrategy': {
                'name': 'UserPreferenceExtractor',
                'namespaceTemplates': ['/users/{actorId}/preferences/']
            }
        }
    ]
)

memory_id = response['memory']['id']
print(f"Memory resource created with ID: {memory_id}")

# Poll the memory status until it becomes ACTIVE
while True:
    mem_status_response = control_client.get_memory(memoryId=memory_id)
    status = mem_status_response.get('memory', {}).get('status')
    if status == 'ACTIVE':
        print("Memory resource is now ACTIVE.")
        break
    elif status == 'FAILED':
        raise Exception("Memory resource creation FAILED.")
    print("Waiting for memory to become active...")
    time.sleep(10)
Console

  1. ====== Untuk membuat memori AgentCore

  2. Buka AgentCore konsol Amazon Bedrock.

  3. Di panel navigasi kiri, pilih Memori.

  4. Pilih Buat memori.

  5. Untuk nama Memori masukkan nama untuk AgentCore Memori.

  6. (Opsional) Untuk kedaluwarsa Short-term memori (peristiwa mentah) atur durasi (hari), di mana AgentCore Memori akan menyimpan peristiwa.

  7. (Opsional) Dalam konfigurasi tambahan atur hal berikut:

    1. Untuk deskripsi Memori, masukkan deskripsi untuk AgentCore Memori.

    2. Jika Anda ingin menggunakan kunci AWS KMS Anda sendiri untuk mengenkripsi data Anda, lakukan hal berikut:

      1. Pada tombol KMS, pilih Sesuaikan pengaturan enkripsi (lanjutan).

      2. Dalam Pilih tombol AWS KMS pilih atau masukkan ARN dari kunci KMS yang AWS ada. Atau, pilih Buat AWS KMS untuk membuat kunci AWS KMS baru.

  8. (Opsional) Untuk strategi ekstraksi Long-term memori pilih satu atau lebih strategi memori. Untuk informasi selengkapnya:

  9. Pilih Buat memori untuk membuat AgentCore Memori.

Topik