---
title: "更新会话"
method: PUT
path: "/sessions/{id}"
tags: ["会话"]
---

# 更新会话

`PUT /sessions/{id}`

更新会话属性

## Path parameters

- `id` string, required

## Request body

- GithubComTencentWeKnoraInternalTypesSession
  - `agent_config` GithubComTencentWeKnoraInternalTypesSessionAgentConfig
    - `agent_mode_enabled` boolean — Whether agent mode is enabled for this session
    - `knowledge_bases` string[] — Accessible knowledge base IDs for this session
    - `knowledge_ids` string[] — Accessible knowledge IDs (individual documents) for this session
    - `web_search_enabled` boolean — Whether web search is enabled for this session
  - `context_config` GithubComTencentWeKnoraInternalTypesContextConfig
    - `compression_strategy` 'sliding_window' | 'smart'
    - `max_tokens` integer — Maximum tokens allowed in LLM context
    - `recent_message_count` integer — For sliding_window: number of messages to keep For smart: number of recent messages to keep uncompressed
    - `summarize_threshold` integer — Summarize threshold: number of messages before summarization
  - `created_at` string
  - `deleted_at` GormDeletedAt
    - `time` string
    - `valid` boolean — Valid is true if Time is not NULL
  - `description` string — Description
  - `embedding_top_k` integer — 向量召回TopK
  - `enable_rewrite` boolean — 多轮改写开关
  - `fallback_response` string — 固定回复内容
  - `fallback_strategy` 'fixed' | 'model'
  - `id` string — ID
  - `keyword_threshold` number — 关键词召回阈值
  - `knowledge_base_id` string — Strategy configuration
  - `max_rounds` integer — 多轮保持轮数
  - `rerank_model_id` string — 排序模型ID
  - `rerank_threshold` number — 排序阈值
  - `rerank_top_k` integer — 排序TopK
  - `summary_model_id` string — 总结模型ID
  - `summary_parameters` GithubComTencentWeKnoraInternalTypesSummaryConfig
    - `context_template` string — Context template
    - `frequency_penalty` number — Frequency penalty
    - `max_completion_tokens` integer — Max completion tokens
    - `max_tokens` integer — Max tokens
    - `no_match_prefix` string — No match prefix
    - `presence_penalty` number — Presence penalty
    - `prompt` string — Prompt
    - `repeat_penalty` number — Repeat penalty
    - `seed` integer — Seed
    - `temperature` number — Temperature
    - `top_k` integer — TopK
    - `top_p` number — TopP
  - `tenant_id` integer — Tenant ID
  - `title` string — Title
  - `updated_at` string
  - `vector_threshold` number — 向量召回阈值

## Response `200`

更新后的会话

- object

## Other responses

- `404` — 会话不存在

## Changes

- **2025-12-22** `e625bcd5b8b9` — 1 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
- **2025-12-16** `edf61e68559d` — 1 info
  - the endpoint scheme security `ApiKeyAuth` was removed from the API

[Change history](https://skmtc.dev/tencentblueking/apis/weknora-api/changes/sessions/:id/put.md)

---

[API](https://skmtc.dev/tencentblueking/apis/weknora-api.md) · [All operations](https://skmtc.dev/tencentblueking/apis/weknora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tencentblueking/weknora-api/revisions/a7ea016b0504/schema)