本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 啟用代理程式記憶體
<a name="agents-configure-memory"></a>

若要設定代理程式的記憶體，您必須先啟用記憶體，然後選擇性地指定記憶體的保留期間。您可以在[建立](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-create.html)或[更新](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-manage.html#agents-edit)代理程式時啟用代理程式的記憶體。

**注意**  
您可以在所有模型上啟用代理程式的記憶體，但下列項目*除外*：  
Amazon Titan Text Premier
Anthropic Claude Instant
請確定您計劃使用的模型在您的區域中可用。如需詳細資訊，請參閱[模型支援依據 AWS 區域。](https://docs.aws.amazon.com//bedrock/latest/userguide/models-supported.html)

若要了解如何為您的代理程式設定記憶體，請選取與您所選方法對應的索引標籤，然後遵循步驟。

------
#### [ Console ]

**為您的代理程式設定記憶體**

1. 如果您尚未進入代理程式建置器，請執行下列動作：

   1.  AWS 管理主控台 使用具有使用 Amazon Bedrock 主控台之許可的 IAM 身分登入 。接著，開啟位於 [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock) 的 Amazon Bedrock 主控台。

   1. 從左側導覽窗格選取**代理程式**。接著，在**代理程式**區段中選擇代理程式。

   1. 選擇**在代理程式建置器中編輯**

1. 在代理程式詳細資訊區段中，選擇**選取模型**。

1. 在**記憶體**區段中，執行以下操作：

   1. 針對**啟用工作階段摘要**，選取**已啟用**。

   1. (選用) 針對**記憶體持續時間**，輸入介於 1 到 365 之間的數字，以指定代理程式的記憶體持續時間。根據預設，代理程式會保留對話內容 30 天。

   1. 針對**最近的工作階段數目上限**，選取一個數字，用於指定要儲存到記憶體之最近工作階段數目的上限。

   1. (選用) 您可以選擇性地變更工作階段摘要提示。若要進行變更，請在**工作階段摘要提示**中，選擇**檢視和編輯**。

1. 請務必先**儲存**，然後**準備**套用您對代理程式所做的變更，再進行測試。

------
#### [ API ]

若要啟用和設定代理程式的記憶體，請使用 [Amazon Bedrock 代理人建置時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)傳送 [CreateAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgent.html) 或 [UpdateAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgent.html) 請求。

在 Amazon Bedrock API 中，您可以在傳送 [CreateAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgent.html) 或 [UpdateAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgent.html) 請求時指定 `memoryConfiguration`。

以下顯示 `memoryConfiguration` 的一般格式：

```
"memoryConfiguration": {
"enabledMemoryTypes": [ "SESSION_SUMMARY" ],
"storageDays":30,
"sessionSummaryConfiguration": {
    "maxRecentSessions": 5
    }
}
```

您可以選擇性地設定記憶體保留期，方法是將 `storageDays` 指派為 1 到 365 天的數字。

**注意**  
如果您為代理程式啟用記憶體，但在調用代理程式時未指定 `memoryId`，則代理程式不會將該特定回合存放在記憶體中。

------