更新 LLM 会话记录¶
按可选的原标题条件更新会话标题或配置文本。
PUT https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/llm/sessions/{session_id}
调用前准备¶
BASE_URL 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。
配置同一环境的工作区身份与变量。先读取详情,保存当前标题与需要保留的配置。
请求¶
curl --request PUT \
"$BASE_URL/workspaces/$WORKSPACE_ID/llm/sessions/$SESSION_ID" \
--header "X-API-Key: $MOI_KEY" \
--header "X-Workspace-ID: $WORKSPACE_ID" \
--header "Content-Type: application/json" \
--data-raw '{"title":"更新后的标题","expected_title":"临时会话"}'
参数 |
位置 |
类型 |
必填 |
说明 |
|---|---|---|---|---|
|
路径 |
string |
是 |
目标工作区,与 X-Workspace-ID 一致。 |
|
路径 |
integer |
是 |
本服务返回的正整数 ID。 |
|
请求体 |
string |
否 |
新标题;只有非空字符串才更新。 |
|
请求体 |
string |
否 |
新配置文本;只有非空字符串才更新。 |
|
请求体 |
string 或 null |
否 |
非 null 字符串作为原标题更新条件;空字符串也是有效条件。 |
title/config 省略、null 或空字符串均保留原值。expected_title 省略或 null 时不检查原标题。条件不匹配时不修改,仍返回 HTTP 200 和当前会话;比较返回标题或配置确认是否生效。不要将成功响应直接当作条件匹配,也不要等待不存在的 409 冲突。请求中的 source 不参与此次更新。
成功响应¶
{
"code": 0,
"data": {
"id": 41,
"title": "更新后的标题",
"source": "moi",
"user_id": "user-example",
"config": "{}",
"created_at": 1794445200,
"updated_at": 1794445200
}
}
字段 |
类型 |
说明 |
|---|---|---|
|
integer |
成功为 0;HTTP 状态码为 200。 |
|
object |
会话记录。 |
错误响应¶
错误格式与读取范围说明身份、参数、资源读取与存储失败的不同结果。
最后更新于