View a markdown version of this page

Menelan konten ke dalam memori jangka panjang - Batu Dasar Amazon AgentCore
Kapan harus menggunakan IngestDataBagaimana cara ker IngestData janyaContohLacak kemajuan konsumsi

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

Menelan konten ke dalam memori jangka panjang

Gunakan IngestData untuk mengirimkan konten secara langsung untuk ekstraksi memori jangka panjang, tanpa mempertahankannya sebagai peristiwa memori jangka pendek.

Kapan harus menggunakan IngestData

Gunakan IngestData saat Anda membutuhkan konten yang disaring ke dalam memori jangka panjang tetapi tidak perlu menyimpan interaksi mentah sebagai peristiwa yang dapat diambil kembali. Contoh:

  • Anda hanya perlu catatan memori yang diekstraksi, bukan interaksi kata demi kata.

  • Anda ingin menghindari overhead penyimpanan jangka pendek karena mempertahankan peristiwa yang tidak akan pernah Anda baca kembali.

  • Aplikasi Anda sudah menyimpan interaksi mentah, jadi Anda hanya perlu catatan jangka panjang yang diekstraksi darinya.

Karena IngestData tidak menyimpan peristiwa jangka pendek, konten yang dikirimkan tidak dapat diambil denganGetEvent,, atau ListEventsListSessions, atau ditata ulang dengan percabangan.

catatan

Untuk menjaga interaksi mentah sebagai peristiwa jangka pendek, gunakan sebagai gant CreateEvent inya.

Bagaimana cara ker IngestData janya

Permintaan yang berhasil mengonfirmasi bahwa konten Anda diterima; catatan memori jangka panjang yang dihasilkan tersedia setelah konten diproses.

Setelah pemrosesan selesai, ambil catatan memori jangka panjang yang dihasilkan menggunakanRetrieveMemoryRecords,ListMemoryRecords, atau GetMemoryRecord - operasi yang sama yang digunakan untuk catatan memori jangka panjang lainnya.

IngestDatamendukung dua jenis muatan:

Percakapan

Pesan percakapan dengan peran (misalnya, USER atauASSISTANT) dan konten teks.

JSON

JSON-formatted data—seperti peristiwa perilaku, log aktivitas, atau peristiwa sistem.

Anda dapat secara opsional melampirkan metadata untuk memperkaya catatan yang diekstraksi. Untuk informasi selengkapnya, lihat Metadata terstruktur untuk memori jangka panjang.

Catatan yang diekstraksi dicakup ke namespace. Untuk informasi selengkapnya, lihat Menentukan organisasi memori jangka panjang dengan ruang nama.

actorIdIdentifikasi entitas (misalnya, pengguna akhir atau agen) dan konten sessionId grup dalam sesi. Konten berbagi yang samaactorId,sessionId, dan namespace diperlakukan sebagai konteks terkait selama ekstraksi.

catatan

IngestDatapenggemar puas dengan strategi memori jangka panjang yang dikonfigurasi memori, kecuali strategi yang dikelola sendiri, yang memiliki alur kerja pemrosesan memori mereka sendiri.

Contoh

Contoh berikut mencerna konten percakapan dan non-percakapan.

import boto3
from datetime import datetime

# Initialize the Boto3 client for data plane operations
data_client = boto3.client('bedrock-agentcore', region_name='us-west-2')

response = data_client.ingest_data(
    memoryId='mem-12345abcdef',
    actorId='customer-123',
    sessionId='session-456',
    contentTimestamp=datetime.now(),
    source={
        'inline': {
            'payload': [
                {
                    'conversational': {
                        'content': {'text': 'I prefer window seats on flights.'},
                        'role': 'USER'
                    }
                },
                {
                    'conversational': {
                        'content': {'text': "Noted — I'll remember your window seat preference."},
                        'role': 'ASSISTANT'
                    }
                },
                {
                    'json': {
                        'content': {
                            'customer_tier': 'gold',
                            'preferences': {'seat': 'window', 'meal': 'vegetarian'},
                            'loyalty_points': 48200
                        }
                    }
                }
            ]
        }
    }
)

# IngestData is asynchronous; the response echoes the session the content was ingested into.
print(f"Ingested content into session: {response['sessionId']}")

Lacak kemajuan konsumsi

Untuk melacak apa yang terjadi setelah permintaan berhasil dan mendeteksi masalah, gunakan pendekatan berikut.

Verifikasi hasil ekstraksi

Setelah konsumsi, catatan memori biasanya muncul dalam hitungan detik hingga menit tergantung pada ukuran konten dan konfigurasi strategi. Untuk mengonfirmasi ekstraksi selesai:

  • Gunakan ListMemoryRecords atau RetrieveMemoryRecords untuk memeriksa apakah catatan memori jangka panjang yang diharapkan telah muncul.

  • Konfigurasikan aliran Kinesis untuk menerima pemberitahuan waktu nyata saat catatan memori dibuat. Lihat Streaming rekaman memori untuk petunjuk penyiapan.

Tangani kegagalan ekstraksi

Jika ekstraksi gagal, AgentCore pindahkan pekerjaan yang gagal ke antrian khusus untuk sumber daya memori Anda. Gunakan ListMemoryExtractionJobs untuk melihat pekerjaan yang gagal, dan StartMemoryExtractionJob untuk mengemudi ulang setelah mengatasi akar penyebabnya. Untuk kode alasan kegagalan, langkah-langkah remediasi, dan cara mengatur pemantauan proaktif dengan FailedExtraction CloudWatch metrik, lihat Pencernaan gagal Redrive.

Untuk mengaktifkan log dan pelacakan aplikasi untuk visibilitas yang lebih dalam ke dalam siklus proses, lihat Mengaktifkan observabilitas untuk AgentCore runtime, memori, gateway, alat bawaan, dan sumber daya identitas.