# 环境准备
#### 前提条件
- 已[创建记忆库](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_017.html)，并获取记忆库的API Key。
- 已安装Python，且版本不低于3.10。
- 执行以下命令安装SDK（建议在Python虚拟环境中安装，以避免与系统包产生冲突）。
  ```
  # 安装依赖包
  apt install python3.12-venv
  # 创建并激活虚拟环境 (linux) 
  python3 -m venv venv
  source venv/bin/activate
  # 安装sdk
  pip install agentarts-sdk
  ```
  ![](https://support.huaweicloud.com/highcode-agentarts/public_sys-resources/note_3.0-zh-cn.png)
  - 执行pip install agentarts-sdk命令下载缓慢、超时可以更改为使用如下命令
    ```
    pip install agentarts-sdk -i https://repo.huaweicloud.com/repository/pypi/simple --trusted-host repo.huaweicloud.com
    ```
    
  
  - 如果系统缺少python3-venv包，导致无法创建虚拟环境，请按照命令回显提示安装python3-venv包。 ![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002706472235.png "点击放大")
    
    
 
#### 配置环境变量
创建记忆库后，复制或下载API Key并妥善保存，用于后续访问记忆库。获取记忆库 ID（对应 space_id）后，配置以下环境变量：
```
# 通过 console 创建记忆库后，可以进行记忆操作。
# 首先需要配置 API Key，配置方式：
# 方式一：环境变量配置,若不传入,SDK会尝试从环境变量中获取apikey
export HUAWEICLOUD_SDK_MEMORY_API_KEY="your-memory-api-key"
# 方式二：代码中直接传入
from agentarts.sdk.memory import MemoryClient
client = MemoryClient(api_key="your-memory-api-key")
# 其次可以配置访问端点
export AGENTARTS_MEMORY_DATA_ENDPOINT="https://{memory_endpoint}"
# endpoint为基本信息内展示的公网域名、公网ip、私网ip或私网访问域名
# 例如：
export AGENTARTS_MEMORY_DATA_ENDPOINT="https://memory-{space_id}.cn-southwest-2.huaweicloud-agentarts.com"
# 也可通过配置region信息, SDK会自行拼接如下域名"https://memory.{region_name}.huaweicloud-agentarts.com"
client = MemoryClient(region_name="cn-southwest-2")
```
#### 获取记忆库关键参数
后续代码中需要用到的参数：
- space_id：记忆库 ID，在详情页"基本信息"获取。
  图1获取记忆库ID   
  ![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002727627208.png "点击放大") 
- region_name：区域，如cn-southwest-2。
- endpoint：访问端点。
- api_key：API Key，获取请参见[如何获取记忆库ID和API Key](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_051.html)。