# 列出事件
<a name="short-term-list-events"></a>

[ListEvents](https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_ListEvents.html) 操作對於需要重建對話歷史記錄、分析互動模式或實作以記憶體為基礎的功能，例如對話摘要和內容感知的應用程式來說非常有用。

`ListEvents` 操作是唯讀操作，列出 AgentCore 記憶體執行個體中指定工作階段的事件。此分頁操作需要您將 `memoryId` 、 `actorId` 和 指定`sessionId`為路徑參數，並支援透過請求內文中的 `filter` 參數進行選用篩選，讓您有效率地從記憶體工作階段擷取相關事件。您可以使用 `includePayloads` 參數控制承載是否包含在回應中 （預設為 true)，並使用 限制結果的數量`maxResults`。