---
title: "向运行中的对话追加消息"
method: POST
path: "/sessions/{session_id}/steer"
tags: ["问答"]
---

# 向运行中的对话追加消息

`POST /sessions/{session_id}/steer`

向运行中的 agent turn 追加用户消息（after 排队 / inject 注入）。无活 turn 时返回 new_run。

## Path parameters

- `session_id` string, required

## Request body

- InternalHandlerSessionSteerMessageRequest
  - `channel` string
  - `delivery` string — Delivery is "after" (default) or "inject". See the constants above.
  - `expected_assistant_message_id` string — Optional for older clients. New clients pin delivery to the run they see and supply a stable ID so a consume event may precede the HTTP response.
  - `mentioned_items` InternalHandlerSessionMentionedItemRequest[]
    - `id` string
    - `kb_id` string — Parent knowledge base for file/tag mentions
    - `kb_name` string — Display name for parent KB
    - `kb_type` string — "document" or "faq" (only for kb type)
    - `name` string
    - `service_id` string — Parent MCP service for MCP tool mentions
    - `skill_name` string — Preloaded agent skill name
    - `type` string — "kb", "file", "tag", "mcp", "skill"
  - `query` string, required
  - `steer_id` string

## Response `200`

queued | new_run

- object

## Other responses

- `400` — 请求参数错误
- `404` — 会话不存在
- `503` — 活 turn 查询失败，可重试

## Changes

- **2026-09-17** `72436bd81b37` — 1 info
  - endpoint added
- **2026-09-11** `a11720c40679` — 1 breaking
  - api path removed without deprecation
- **2026-09-11** `7c276b8ba2d3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tencentblueking/apis/weknora-api/changes/sessions/:session_id/steer/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.dev/tencentblueking/apis/weknora-api/revisions/710d29c05955?raw)