Giới thiệu
Khi phát triển và thử nghiệm nhiều khung AI với Amazon Bedrock AgentCore, tôi nhận ra rằng mình cần một công cụ để hình dung và khám phá những gì mà các agent của mình thực sự ghi nhớ. Bộ Nhớ AgentCore cung cấp khả năng mạnh mẽ trong việc quản lý cả ngữ cảnh cuộc trò chuyện ngắn hạn và trích xuất kiến thức dài hạn. Tuy nhiên, việc gỡ lỗi các mẫu nhớ đồng nghĩa với việc phải đào sâu vào các lệnh AWS CLI hoặc viết các script tùy chỉnh chỉ để xem những gì đã được lưu trữ. Do đó, tôi cần một cách nhanh chóng để duyệt, tìm kiếm và hiểu các mẫu nhớ mà các agent của tôi đang tạo ra.
Đó là lý do tôi xây dựng Trình Duyệt Bộ Nhớ AgentCore: một giao diện web giúp đơn giản hóa việc khám phá và tương tác với các tài nguyên Bộ Nhớ Amazon Bedrock AgentCore. Dù bạn đang gỡ lỗi việc trích xuất bộ nhớ của một agent hay chỉ đơn giản là tò mò về những gì mà các agent của bạn đang học hỏi theo thời gian, công cụ này cung cấp cho bạn cái nhìn cần thiết.
Trong bài viết này, tôi sẽ hướng dẫn bạn qua các khả năng của Trình Duyệt Bộ Nhớ AgentCore, cho bạn thấy cách thiết lập trong vài phút và chứng minh cách nó có thể tăng tốc quy trình phát triển agent của bạn. Công cụ này bổ sung cho hành trình đa khung mà tôi đã ghi lại trong loạt bài blog chính về AgentCore, cung cấp cái nhìn thiết yếu cho bất kỳ triển khai agent nào.
Tại sao cần xây dựng một Trình Duyệt Bộ Nhớ?
Làm việc với các agent AI trong môi trường sản xuất yêu cầu hiểu không chỉ những gì chúng nói, mà còn những gì chúng ghi nhớ. Bộ Nhớ AgentCore của Amazon Bedrock cung cấp quản lý bộ nhớ tinh vi với nhiều chiến lược để trích xuất và lưu trữ các loại thông tin khác nhau. Bộ Nhớ AgentCore có thể ghi lại sở thích và cài đặt của người dùng, lưu trữ thông tin thực tế được trích xuất từ các cuộc trò chuyện, tạo các tóm tắt ngắn gọn của các phiên, và duy trì lịch sử cuộc trò chuyện thô để có ngữ cảnh.
Khi một agent không hoạt động như mong đợi hoặc khi bạn muốn hiểu các mẫu nhớ của nó, bạn cần có cái nhìn sâu sắc vào các kho nhớ này. AWS CLI cung cấp khả năng thô, nhưng việc chuyển đổi giữa các lệnh terminal trong quá trình phát triển làm gián đoạn quy trình của bạn. Tôi cần một cái gì đó trực quan hơn - một công cụ có thể cho tôi thấy ngay lập tức những gì mỗi chiến lược nhớ đang lưu trữ, cho phép tôi tìm kiếm qua các bản ghi và giúp tôi hiểu cách mà các agent của tôi sử dụng bộ nhớ qua các phiên và đối tượng khác nhau.
Các tính năng chính giúp tăng tốc phát triển
Trình Duyệt Bộ Nhớ AgentCore cung cấp khám phá theo thời gian thực của tất cả các tài nguyên Bộ Nhớ AgentCore của bạn với dữ liệu trực tiếp được lấy từ cả API điều khiển và API dữ liệu. Bạn có thể thấy trạng thái bộ nhớ, cấu hình và chiến lược chỉ trong nháy mắt.
Mỗi chiến lược bộ nhớ có giao diện riêng với các thao tác được tùy chỉnh cho mục đích của nó. Dù bạn đang làm việc với sở thích của người dùng, sự thật ngữ nghĩa hay tóm tắt phiên, trình duyệt sẽ tự động điều chỉnh để hiển thị các thao tác và mẫu không gian tên liên quan. Bộ Nhớ AgentCore sử dụng các mẫu không gian tên với các placeholder, và khi một chiến lược xác định một không gian tên chứa {memoryStrategyId}, trình duyệt sẽ tự động điền phần ID chiến lược trong khi vẫn giữ trường đó có thể chỉnh sửa để bạn có thể thay thế các giá trị đối tượng và phiên. Điều này giúp bạn dễ dàng khám phá dữ liệu người dùng hoặc phiên cụ thể mà không cần phải nhập đường dẫn không gian tên đầy đủ mỗi lần.
Trình duyệt cung cấp ba thao tác cốt lõi cho mỗi chiến lược. Bạn có thể liệt kê các sự kiện để xem chuỗi sự kiện cho các phiên và đối tượng cụ thể, giúp bạn hiểu dòng thời gian tương tác của agent. Bạn có thể duyệt tất cả các bản ghi bộ nhớ trong một không gian tên với hỗ trợ phân trang cho các tập dữ liệu lớn. Và bạn có thể truy xuất bộ nhớ bằng các truy vấn ngôn ngữ tự nhiên, tận dụng khả năng tìm kiếm ngữ nghĩa của AgentCore.
Giao diện thân thiện với nhà phát triển bao gồm các nút sao chép nhanh cho ID Bộ Nhớ, ARNs và các giá trị không gian tên, giúp bạn tiết kiệm thời gian khi cần tham chiếu ID bộ nhớ hoặc ARNs trong mã của bạn. Trình xem JSON tự động mở rộng với đánh dấu cú pháp giúp dễ dàng kiểm tra các cấu trúc bộ nhớ phức tạp. Trình duyệt nhớ các chỉnh sửa không gian tên của bạn trong một phiên, vì vậy bạn không phải nhập lại các ID đối tượng và phiên liên tục. Và tất cả nội dung của người dùng đều được HTML-escape để ngăn chặn các cuộc tấn công injection, đảm bảo an ninh ngay cả khi duyệt nội dung bộ nhớ không tin cậy.
Cài đặt trong chưa đầy một phút
Để bắt đầu nhanh chóng, tôi đã đóng gói Trình Duyệt Bộ Nhớ AgentCore như một công cụ Python có thể được cài đặt toàn cầu bằng uv, trình quản lý gói Python nhanh.
Trước khi cài đặt, hãy đảm bảo bạn có Python 3.13 trở lên và AWS CLI được cấu hình với thông tin xác thực phù hợp. Bạn sẽ cần quyền IAM AWS cho các thao tác bedrock-agentcore-control:ListMemories và GetMemory, cũng như bedrock-agentcore:ListEvents, ListMemoryRecords và RetrieveMemoryRecords.
Bạn có thể cài đặt trực tiếp từ GitHub với một lệnh duy nhất:
uv tool install git+https://github.com/danilop/agentcore-memory-browser.gitSau đó chạy nó từ bất kỳ đâu:
agentcore-memory-browserỨng dụng sẽ tự động mở trong trình duyệt mặc định của bạn tại http://localhost:8000 (bạn có thể truyền một cổng khác trên dòng lệnh).
Nếu bạn muốn sửa đổi công cụ hoặc đóng góp cho sự phát triển, bạn có thể sao chép kho lưu trữ, cài đặt các phụ thuộc với uv sync, và chạy ứng dụng với uv run agentcore-memory-browser.
Kiến trúc: Phân tách rõ ràng các mối quan tâm
Trình Duyệt Bộ Nhớ AgentCore tuân theo một kiến trúc sạch, mô-đun. Backend được xây dựng với FastAPI, cung cấp một khung web hiện đại, có khả năng async. Nó sử dụng hai khách hàng dịch vụ AWS: điều khiển AgentCore để liệt kê và mô tả các tài nguyên bộ nhớ, và plane dữ liệu để thực hiện các thao tác như liệt kê sự kiện, duyệt các bản ghi và thực hiện tìm kiếm ngữ nghĩa.
Frontend sử dụng Bootstrap cho thiết kế đáp ứng và JavaScript thuần cho tính tương tác - không cần quy trình xây dựng phức tạp. Giao diện được tổ chức với một thanh bên cho việc chọn bộ nhớ với bản xem trước metadata, nội dung chính với một giao diện tab cho mỗi chiến lược bộ nhớ, các bảng điều khiển thao tác với các biểu mẫu dành riêng cho mỗi thao tác bộ nhớ, và một hiển thị kết quả với trình xem cây JSON với đánh dấu cú pháp.
Các mẫu sử dụng thực tế
Sau khi sử dụng Trình Duyệt Bộ Nhớ trong khi phát triển các agent, một số mẫu đã chứng minh là đặc biệt hữu ích trong quy trình làm việc của tôi để gỡ lỗi việc trích xuất bộ nhớ khi các sự kiện được xử lý bởi các chiến lược, hiểu cách mà kiến thức của agent tiến triển theo thời gian, và tối ưu hóa các tìm kiếm ngữ nghĩa.
Các thực tiễn tốt nhất
Sau một thời gian sử dụng dài, một số thực tiễn đã nổi lên là rất hữu ích. Đầu tiên, hãy cấu hình môi trường AWS của bạn một cách chính xác bằng cách thiết lập vùng AWS mặc định và xác minh thông tin xác thực với aws sts get-caller-identity. Điều này đảm bảo rằng trình duyệt có thể kết nối với các tài nguyên Bộ Nhớ AgentCore của bạn mà không gặp vấn đề gì.
Ngoài ra, việc sử dụng tốt các nút sao chép tiết kiệm thời gian khi bạn cần tham chiếu ID bộ nhớ hoặc ARNs trong mã của mình.
Điều làm cho Bộ Nhớ AgentCore đặc biệt hữu ích là cách nó đơn giản hóa việc xử lý cả bộ nhớ ngắn hạn và dài hạn cho các agent AI. Bộ nhớ ngắn hạn ghi lại ngữ cảnh ngay lập tức của các cuộc trò chuyện, trong khi bộ nhớ dài hạn trích xuất và lưu giữ các sự thật, sở thích và mẫu quan trọng tồn tại qua các phiên. Trình Duyệt Bộ Nhớ cho bạn cái nhìn vào cả hai, giúp bạn hiểu cách mà các agent của bạn xây dựng kiến thức theo thời gian và cách chúng sử dụng kiến thức đó để cung cấp các phản hồi cá nhân hóa và phù hợp với ngữ cảnh hơn. Cái nhìn này giúp xây dựng các agent có thể duy trì các kết quả mạch lạc và hiệu quả trong khi học hỏi và thích nghi từ các tương tác của chúng.
Kết luận
Trình Duyệt Bộ Nhớ AgentCore không chỉ là một công cụ, mà là một phần không thể thiếu trong quy trình phát triển agent AI. Bằng cách cung cấp cái nhìn sâu sắc vào cách mà các agent ghi nhớ và sử dụng thông tin, nó giúp các nhà phát triển như bạn tối ưu hóa quy trình làm việc và cải thiện chất lượng của các agent. Hãy thử ngay hôm nay để trải nghiệm sự khác biệt mà nó mang lại cho dự án của bạn!
Câu hỏi thường gặp (FAQ)
1. Tôi có cần kiến thức lập trình để sử dụng Trình Duyệt Bộ Nhớ không?
Có, một số kiến thức cơ bản về lập trình sẽ giúp bạn tận dụng tối đa công cụ này.
2. Trình Duyệt Bộ Nhớ có hỗ trợ các ngôn ngữ khác không?
Hiện tại, công cụ này chủ yếu hỗ trợ tiếng Anh và tiếng Việt.
3. Làm thế nào để tôi có thể đóng góp vào dự án này?
Bạn có thể sao chép kho lưu trữ trên GitHub và gửi pull request với các thay đổi của mình.
