AI 数据模型说明

在创建 Agent 时，系统会自动创建四张核心数据表：会话、消息、工具使用记录、消息内容。

会话表

用于记录每次 AI 会话的主数据。在调用“开始会话”行为后，会在此表添加一条记录，也可通过“删除会话”行为删除（会同时删除关联的消息内容）。

主要字段：

• 账户 ID：整数类型，关联账户表，标识会话发起用户。
• 入参：记录 AI 配置的提示词、知识库、工具、输出等参数。
• 状态：会话状态，含六种：
  • CREATED：初始状态
  • IN_PROGRESS：等待 AI 回复
  • STREAMING：AI 流式输出中
  • COMPLETED：AI 回复完成
  • FAILED：失败
  • CANCELED：已终止
• 错误信息：会话失败时的报错内容。
• AI 配置 ID/模型：调用的 AI 配置与模型。
• 消息：该会话下的所有消息。

消息表

记录某会话下的所有消息。

• 账户 ID：关联账户表，标识消息归属用户。
• 会话 ID：关联会话表。
• 角色：文本类型，分三类：
  • system：对话背景设定（如提示词、知识库）
  • assistant：大模型返回内容
  • user：用户输入内容

消息内容表

一条消息可包含多种内容（如文本、图片、JSON），需用“消息内容表”保存具体内容。

• 类型：三类：
  • TEXT：文本内容
  • IMAGE：图片内容
  • JSON：结构化内容
• 消息 ID：关联消息表。

工具使用记录表

记录 Agent 运行时工具的调用情况。AI 处理消息时，可能多次调用工具。

• 名称：工具名称
• 工具调用 ID：唯一标识本次调用
• 类型：四类：
  • ACTION_FLOW：行为流
  • TPA：第三方 API
  • ZAI：其它 AI
  • OBTAIN_MORE_INFORMATION：获取更多信息
• 请求：JSON，调用工具时的请求内容
• 响应：JSON，工具返回结果
• 消息 ID：关联消息表，标识归属消息