---
description: 记录智能体会话中的单条消息、角色、内容、工具调用、思考过程、Token 用量和反馈信息。
navTitle: AGENT_CHAT_MESSAGES
---
# **AGENT\_CHAT\_MESSAGES 智能体会话消息表**

记录智能体会话中的单条消息、角色、内容、工具调用、思考过程、Token 用量和反馈信息。

一条会话通常会对应多条消息，消息按创建时间组成完整对话上下文。用户提问、智能体回复、工具执行结果、反馈等都会沉淀在这里，用于继续会话、查看历史记录、统计消耗和复盘智能体回答质量。

消息生命周期与会话一致：创建会话后持续追加消息；会话被删除或清理时，相关消息也应一起归档或清理。`SESSION_ID` 与 `AGENT_CHAT_SESSIONS` 关联，`AGENT_ID` 用于区分不同智能体，`MESSAGE_ID` 用于唯一定位一条消息。

`ROLE` 记录消息发送者角色，通常取 `user`、`assistant`、`tool`，也可以按调用方约定使用 `agent` 表示智能体回复。`CONTENT` 对 BI 场景可能包含 Markdown 表格或图表配置 JSON。

`TOOL_CALLS` 保存工具调用详情，通常是 JSON 字符串，例如工具名称和参数摘要。`THOUGHTS` 可保存深度思考过程或 RAG 检索到的引用片段 ID 列表。`TOKEN_USAGE` 记录 input/output token 消耗，用于计费和成本统计；`FEEDBACK` 记录用户点赞或点踩，可用于后续回答质量优化。

## 位置{#position}

模型路径：`/sysdata/data/tables/app/AGENT_CHAT_MESSAGES.tbl`

物理表名：`SZSYS_5_AGENT_CHAT_MESSAGES`

## 表结构{#structure}

| 字段名 | 字段类型 | 字段描述 |
| :----  | :---- | :------ |
| AGENT\_ID | VARCHAR(64) | 智能体ID |
| SESSION\_ID | VARCHAR(64) | 会话ID |
| MODEL\_ID | VARCHAR(64) | 模型ID |
| MESSAGE\_ID | VARCHAR(64) | 消息ID，主键 |
| ROLE | VARCHAR(32) | 消息角色，如 user、assistant、tool |
| CONTENT | CLOB | 消息正文内容 |
| TOOL\_CALLS | CLOB | 工具调用信息，记录本轮回复中涉及的工具名称、参数摘要和调用结果摘要 |
| THOUGHTS | CLOB | 智能体生成过程中的中间信息，用于诊断复杂回答或工具编排过程 |
| TOKEN\_USAGE | CLOB | Token 用量统计信息，用于成本统计和会话质量分析 |
| FEEDBACK | VARCHAR(32) | 用户反馈状态，thumb\_up表示点赞，thumb\_down表示点踩；其它值按调用方约定 |
| CREATE\_TIME | TIMESTAMP | 创建时间 |

## 表索引{#indexes}

| 类型 | 名称 | 字段列表 | 是否唯一 | 说明 |
| :---- | :---- | :---- | :------ | :------ |
| 主键 | PRIMARY | MESSAGE\_ID | 是 | 唯一标识一条记录 |
| 索引 | - | - | - | 该表未定义其他索引 |