文档中心

向量数据库VikingDB

请输入

会话 (Sessions)

update_session_config - 更改session配置

接口说明

部分更新一个已存在 Session 的可变配置。当前可修改 auto_commit_policy 与 memory_extraction_config.events.tags；修改会对后续消息Commit 生效，不会回溯历史 commit 的消息。

HTTP Method	`PATCH`
Path	`/api/v1/sessions/{session_id}/config`
Content-Type	`application/json`
更新方式	字段级 Patch；空对象是合法 no-op。

路径参数

参数	类型	必填	说明
`session_id`	string	是	要更新的 Session ID。SDK 会对路径段进行 URL 编码。

请求参数

参数	类型	必填	说明
`memory_extraction_config`	object 或 null	否	目前支持部分更新 `events.tags`。传 `null` 不修改现有配置。
`auto_commit_policy`	object 或 null	否	传 object 时只合并已提供字段；传 `null` 禁用；省略则不修改。
`telemetry`	boolean 或 object	否	默认 `false`。传 `true` 或 `{"summary":true}` 返回 telemetry summary。

auto_commit_policy 参数

传入 object 即启用自动 Commit。未传字段由默认值补齐；超出范围的整数会被截断到边界值。object 内的字段不能传 null，如需关闭自动 Commit，应将整个 auto_commit_policy 设为 null。

字段	类型	默认值	范围	说明
`pending_token_threshold`	integer	150000	0–1000000	未提交 pending token 严格大于该值后触发。传 0 关闭该触发器。
`message_count_threshold`	integer	100	0–1000	Live message 数严格大于该值后触发。传 0 关闭该触发器。
`keep_recent_count`	integer	0	0–1000	阈值触发时保留的最近消息数；idle 触发会忽略该值并归档全部积压消息。
`min_commit_interval_seconds`	integer	0	0–604800	两次自动 Commit 的最小间隔；0 表示不节流。

memory_extraction_config 参数

字段	类型	必填	说明
`events.tags`	string[]	否	事件记忆默认标签，每项采用严格 `key=value` 格式。系统会去除首尾空格、转为小写，并按 key 去重；重复 key 保留最后一个 value。

响应参数

字段	类型	说明
`status`	string	成功时为 `ok`。
`result.session_id`	string	已更新的 Session ID。
`result.auto_commit_policy`	object 或 null	合并并补齐默认值后的生效策略；禁用时为 `null`。
`result.memory_extraction_config`	object	当前生效的事件记忆默认标签。

请求示例

HTTP：部分更新并替换事件标签

curl -X PATCH 'http://127.0.0.1:1933/api/v1/sessions/support-agent-20260821/config' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: your-user-key' \
  -d '{
    "auto_commit_policy": {
      "message_count_threshold": 25,
      "min_commit_interval_seconds": 600
    },
    "memory_extraction_config": {
      "events": {
        "tags": ["team=support", "channel=app"]
      }
    }
  }'

HTTP：清空事件默认标签

curl -X PATCH 'http://127.0.0.1:1933/api/v1/sessions/support-agent-20260821/config' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: your-user-key' \
  -d '{
    "memory_extraction_config": {
      "events": {"tags": []}
    }
  }'

Python SDK

from openviking_sdk import SyncHTTPClient

client = SyncHTTPClient(
    url="http://127.0.0.1:1933",
    api_key="your-user-key",
)
client.initialize()

result = client.update_session_config(
    "support-agent-20260821",
    auto_commit_policy={
        "message_count_threshold": 25,
        "min_commit_interval_seconds": 600,
    },
    memory_extraction_config={
        "events": {"tags": ["team=support", "channel=app"]},
    },
)
print(result["auto_commit_policy"])

client.update_session_config(
    "support-agent-20260821",
    auto_commit_policy=None,
)
client.close()

TypeScript SDK

const result = await client.updateSessionConfig(
  "support-agent-20260821",
  {
    autoCommitPolicy: {
      message_count_threshold: 25,
      min_commit_interval_seconds: 600,
    },
    memoryExtractionConfig: {
      events: { tags: ["team=support", "channel=app"] },
    },
  },
);

await client.updateSessionConfig("support-agent-20260821", {
  autoCommitPolicy: null,
});

Go SDK

policy := map[string]any{
    "message_count_threshold": 25,
    "min_commit_interval_seconds": 600,
}
result, err := client.UpdateSessionConfig(
    ctx,
    "support-agent-20260821",
    &openviking.UpdateSessionConfigOptions{
        AutoCommitPolicy: &policy,
        MemoryExtractionConfig: map[string]any{
            "events": map[string]any{
                "tags": []string{"team=support", "channel=app"},
            },
        },
    },
)
if err != nil {
    return err
}
fmt.Println(result["auto_commit_policy"])

disabled := openviking.Map(nil)
_, err = client.UpdateSessionConfig(
    ctx,
    "support-agent-20260821",
    &openviking.UpdateSessionConfigOptions{
        AutoCommitPolicy: disabled,
    },
)

响应示例

{
  "status": "ok",
  "result": {
    "session_id": "support-agent-20260821",
    "auto_commit_policy": {
      "pending_token_threshold": 150000,
      "message_count_threshold": 25,
      "keep_recent_count": 10,
      "min_commit_interval_seconds": 600
    },
    "memory_extraction_config": {
      "events": {
        "tags": ["team=support", "channel=app"]
      }
    }
  }
}

最近更新时间：2026.09.04 17:35:42

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

接口说明 #

路径参数 #

请求参数 #

auto_commit_policy 参数 #

memory_extraction_config 参数 #

响应参数 #

请求示例 #

HTTP：部分更新并替换事件标签 #

HTTP：清空事件默认标签 #

Python SDK #

TypeScript SDK #

Go SDK #

响应示例 #