环境准备

前提条件

• 已创建记忆库，并获取记忆库的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

  

  • 执行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包。

    

配置环境变量

创建记忆库后，复制或下载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
  
• region_name：区域，如cn-southwest-2。
• endpoint：访问端点。
• api_key：API Key，获取请参见如何获取记忆库ID和API Key。