session-会话管理--向量数据库VikingDB-火山引擎

文档中心

向量数据库VikingDB

请输入

导入导出与会话

session-会话管理

命令说明

管理会话、消息、归档和已提交会话上下文。

语法

ov session <subcommand> [options]

子命令概览

子命令	说明
`new`	创建新会话
`list`	列出所有会话
`get <id>`	显示会话详情
`get-session-context <id>`	读取合并的会话上下文
`add-message <id>`	添加一条消息
`add-messages <id>`	添加多条消息
`commit <id>`	归档消息并提取记忆

使用示例

1. 创建新会话

ov session new

2. 添加一条消息到会话

ov session add-message <id> --role user --content "..."

子命令详细说明

`new`

创建新会话。
示例：创建新会话

ov session new

`list`

列出所有会话。
示例：列出所有会话

ov session list

`get <id>`

获取会话详情。

参数	必填	说明	默认值
`<session-id>`	是	会话 ID

示例：获取指定会话详情

ov session get <session-id>

`get-session-context <id>`

读取合并的会话上下文。

参数	必填	说明	默认值
`<session-id>`	是	会话 ID
`--token-budget <n>`	否	最新归档摘要包含的 token 预算	`128000`

示例：读取会话合并上下文

ov session get-session-context <session-id>

`add-message <id>`

向会话添加一条消息。

参数	必填	说明
`<session-id>`	是	会话 ID
`--role <role>`	是	消息角色：user / assistant
`--content <content>`	是	消息内容
`--peer-id <id>`	否	稳定交互对等 ID

示例：添加一条用户消息

ov session add-message <id> --role user --content "Help me summarize this project"

`add-messages <id>`

向会话添加多条消息。

参数	必填	说明	默认值
`<session-id>`	是	会话 ID
`--messages <json-array>`	是	JSON 数组格式的消息

示例：添加多条消息

ov session add-messages <id> --messages '[{"role":"user","content":"..."},{"role":"assistant","content":"..."}]'

`commit <id>`

归档消息并提取记忆。

参数	必填	说明	默认值
`<session-id>`	是	会话 ID

示例：提交会话并提取记忆

ov session commit <id>

下一步

可以查看子命令详细参数：

ov session <subcommand> --help

最近更新时间：2026.06.10 16:56:49

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

命令说明 #

语法 #

子命令概览 #

使用示例 #

1. 创建新会话 #

2. 添加一条消息到会话 #

子命令详细说明 #

new #

list #

get <id> #

get-session-context <id> #

add-message <id> #

add-messages <id> #

commit <id> #

下一步 #