← 返回预览首页

03 · 数据模型

一、现有表(nine-admin main @ 6060c5a,直接复用)

agent_clients —— 智能体身份

字段 用途 主脑系统里的位置
id 主键 编号 JZ-AG-00X 的来源
name 客户端名(如 joey-mac-jczx) 岗位/客户端名
owner 归属人/用途备注 所属管理人
device_uuid 设备绑定 machine_uuid 与 agent_machines.machine_uuid 对应
token_digest / token_prefix agt_ token(明文不落库) 归档鉴权
last_used_at 最近调用 最后同步时间
documents_count / total_bytes 缓存计数 档案占用
revoked_at / expires_at 撤销/过期 状态判定参考

agent_machines —— 设备

agent_client_id, machine(主机名), machine_uuid, first/last_remote_ip, first/last_seen_at → 机器码 = machine_uuid;last_seen_at 决定「连通 / 不通」。

agent_documents —— 档案本体(核心)

agent_client_id, kind(soul|memory|skill|session), path, title, current_sha256, current_size, first/last_uploaded_at, machine_uuid, deleted_at

kind 客户端来源 界面名字 主脑系统用到的地方
soul SOUL.md 性格 抽屉「性格」tab、档案分析、派单携带档案
memory memories/** 历史记忆 抽屉「历史记忆」、记忆档案
skill skills/** 技能 抽屉「技能」、SKILL 档案(27 条)
session transcripts/** 历史会话 抽屉「历史会话」、会话档案、无关会话统计

其他复用

agent_upload_batches(同步批次)、staffers(员工)、admin_roles / admin_privileges(权限点)、 tickets(工单)、user_action_logs(操作审计)、push_configs / fault_reports(客户端通道)。

二、需要新增的表(6 张)

目标:让「100 个位」「岗位」「SKILL 状态」「分析结果」「派单台账」「技能动作留痕」有地方落,否则界面上的一切都是空的。

1. brain_slots —— 100 个智能体位

create_table :brain_slots do |t|
  t.integer  :seq,           null: false          # 1..100,界面上 JZ-AG-001
  t.string   :label                                # 自定义名称(可空)
  t.string   :post_name                            # 岗位名称(冗余,便于查询)
  t.bigint   :agent_client_id                      # 空 = 空置
  t.string   :machine_uuid
  t.string   :manager_owner                        # 所属管理人(= agent_clients.owner 快照)
  t.string   :status, default: 'empty'             # empty / configured / online / busy / offline
  t.datetime :configured_at
  t.timestamps
end
add_index :brain_slots, :seq, unique: true
add_index :brain_slots, :agent_client_id
add_index :brain_slots, [:machine_uuid], unique: true, where: "machine_uuid IS NOT NULL"  # 一台设备不能占两位

2. posts(岗位表)

create_table :posts do |t|
  t.string :name, null: false      # 电力行业售前顾问 …
  t.string :code
  t.text   :duty                   # 岗位职责
  t.boolean :active, default: true
  t.timestamps
end
add_index :posts, :name, unique: true

3. staff_posts(人员 ↔ 岗位,含离职与接替)

create_table :staff_posts do |t|
  t.bigint   :staffer_id, null: false
  t.bigint   :post_id,    null: false
  t.date     :started_on
  t.date     :ended_on                    # 非空 = 已离岗
  t.bigint   :handover_to_staffer_id      # 接替人(原岗复活用)
  t.timestamps
end

「原岗复活」= 找 ended_on 非空岗位的 handover_to_staffer_id,取其名下智能体。

4. skill_registry(技能状态与计数)

create_table :skill_registry do |t|
  t.string  :code, null: false            # skill-rail-vehicle-assembly-check
  t.string  :name, null: false
  t.bigint  :post_id
  t.bigint  :agent_document_id            # 指向 agent_documents(kind=skill) 本体
  t.string  :status, default: 'available' # in_use / available / deprecated
  t.integer :uses_count, default: 0
  t.datetime :last_used_at
  t.datetime :deprecated_at
  t.text    :note
  t.timestamps
end
add_index :skill_registry, :code, unique: true
add_index :skill_registry, [:post_id, :status]

5. skill_ops_logs(四个动作的留痕)

create_table :skill_ops_logs do |t|
  t.bigint :skill_registry_id, null: false
  t.string :action, null: false              # learn / assign / copy / revive
  t.bigint :target_slot_id                   # 指派/复活的目标位
  t.bigint :operator_staffer_id
  t.string :result                           # ok / failed
  t.text   :note
  t.timestamps
end

6. brain_analyses + dispatch_records

create_table :brain_analyses do |t|
  t.date     :period_from, null: false
  t.date     :period_to,   null: false
  t.string   :model, null: false              # deepseek-flash / gpt-4o …
  t.integer  :token_usage
  t.integer  :duration_ms
  t.string   :status, default: 'pending'      # pending / running / done / failed
  t.jsonb    :result                          # 人人+逐智能体判定结果
  t.timestamps
end

create_table :dispatch_records do |t|
  t.string  :kind, null: false                # task(派智能体)/ ticket(派员工)
  t.bigint  :source_id                        # 工单 id 或任务 id
  t.bigint  :target_slot_id                   # kind=task
  t.bigint  :target_staffer_id                # kind=ticket
  t.string  :model                            # 本次推荐用的模型
  t.jsonb   :recommendation                   # 模型原始建议(审计用)
  t.bigint  :confirmed_by_staffer_id
  t.datetime :confirmed_at
  t.timestamps
end

三、口径(必须与线上一致)

项 口径
积分 ↔ 金额 1 积分 = 8.9 元(0.50 积分 ≈ ¥4.45)
余额 只认 ATP users.quota,本地不存余额
「已设置」智能体 brain_slots.agent_client_id IS NOT NULL(= 集群档案里非空置的框)
档案分析覆盖范围 必须 = 已设置数量,空置位不参与
连通判定 agent_machines.last_seen_at 在 N 分钟内(建议 10 分钟)→ 连通;否则不通
任务中 有未完成的 dispatch_record(kind=task) 指向该位
无关会话 transcripts 每条打标 relevance(业务相关 / 无关),判定时汇总占比