View a markdown version of this page

Buat AgentCore Memori - Batu Dasar Amazon AgentCore

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

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 peristiwa 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. Memperbaruinya hanya memengaruhi 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, bahkan jika Anda tidak memberikan kunci KMS yang dikelola pelanggan AWS .

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

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

contoh
AgentCore CLI

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

    agentcore create --project-name MemoryProject --no-agent
cd MemoryProject

    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

    Per iksa status memori:

    agentcore status
Interactive

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

  2. Masukkan nama memori:

    Wizard memori: masukkan nama

  3. Pilih durasi kedaluwarsa acara:

    Wizard 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:

    Wizard 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 Mem ori masukkan nama untuk AgentCore Memori.

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

  7. (Opsional) Di Konfigurasi tambahan atur yang 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. Di kunci KMS, pilih Ku stomisasi pengaturan enkripsi (lanjutan).

      2. Di Pilih kunci AWS KMS pilih atau masukkan ARN dari kunci AWS KMS yang 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