Skip to main content

使用 CLI

在终端用阿里云百炼 CLI 管理长期记忆与用户画像。

阿里云百炼 CLI 提供记忆写入、检索、节点管理、画像模板管理和技能记忆导出命令，可在终端或 Agent 中调用。
记忆库相关 CLI 能力目前仅对中国站（aliyun.com）账号开放。

前提条件

  • 已安装阿里云百炼 CLI，版本为 2.5.0 或以上。
  • 已获取 API Key 和业务空间 ID，两者须属于同一业务空间。获取方式见认证。
所有 Memory 命令都需要业务空间 ID。可以传入 --workspace-id，或设置以下环境变量： 
export DASHSCOPE_API_KEY='<your-api-key>'
export BAILIAN_WORKSPACE_ID='<your-workspace-id>'

写入、查看和检索记忆

bl memory add --user-id user1 --content "偏好简洁的技术风格回答" --output json
bl memory list --user-id user1 --output json
bl memory search --user-id user1 --query "回答风格偏好" --output json
add 提交异步抽取任务，默认最多等待 120 秒。使用 --wait 0 时只返回提交回执；超时后抽取可能仍在后台继续，应先核对结果再决定是否重新提交。返回的 event_id 是事件 ID；查看、更新和删除节点时，使用 list 或 search 结果中的 memory_node_id。 search 默认检索事实记忆（observation），检索技能记忆需指定 --memory-types skill。--plan-version 可选择 pro 或 lite，--min-score 只在 pro 下生效。计费差异见计费说明。list 默认只查询默认规则，查看其他规则下的节点需传入 --project-id。

可用命令

任务命令说明
写入和检索bl memory add / bl memory search通过 --user-id 指定记忆归属对象
节点管理bl memory list / bl memory node show / bl memory update / bl memory deletelist 按用户和规则分页；其余命令按 --node-id 定位，update 和 delete 不接受 --user-id
画像模板管理bl memory profile create / bl memory profile list / bl memory profile show / bl memory profile update / bl memory profile delete模板定义需抽取的属性，可供多个用户共享
读取用户画像bl memory profile get通过 --schema-id 和 --user-id 读取已抽取的属性值；先用 add 的 --profile-schema 关联模板
导出技能记忆bl memory skill export通过 --node-id 导出技能正文或 JSON，不自动安装到 Agent
模板与用户画像的完整流程见使用用户画像。
删除节点或画像模板需传入 --yes，可先用 --dry-run 预览请求。删除节点不会清空用户画像；删除共享模板会使所有用户在该模板下的画像无法访问。profile update 的属性删除操作没有 --yes 确认，执行前应核对模板和属性 ID。
从旧版本升级时，将记忆库参数 --memory-library-id 改为 --library-id。更多迁移变更见2.5.0 更新日志。 任意命令追加 --help 查看完整参数。13 条命令的参数和示例见 Memory 命令参考。