---
title: "创建会话"
method: POST
path: "/sessions"
tags: ["会话"]
---

# 创建会话

`POST /sessions`

创建新的对话会话

## Request body

- InternalHandlerSessionCreateSessionRequest
  - `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
  - `knowledge_base_id` string — ID of the associated knowledge base (optional, can be set/changed during queries)
  - `session_strategy` InternalHandlerSessionSessionStrategy
    - `embedding_top_k` integer — Number of top results to retrieve from vector search
    - `enable_rewrite` boolean — Whether to enable query rewrite for multi-round conversations
    - `fallback_response` string — Fixed response content for fallback
    - `fallback_strategy` 'fixed' | 'model'
    - `keyword_threshold` number — Threshold for keyword-based retrieval
    - `max_rounds` integer — Maximum number of conversation rounds to maintain
    - `no_match_prefix` string — Prefix for responses when no match is found
    - `rerank_model_id` string — ID of the model used for reranking results
    - `rerank_threshold` number — Threshold for reranking results
    - `rerank_top_k` integer — Number of top results after reranking
    - `summary_model_id` string — ID of the model used for summarization
    - `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
    - `vector_threshold` number — Threshold for vector-based retrieval

## Response `201`

创建的会话

- object

## Other responses

- `400` — 请求参数错误

## 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/post.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)