Docs.items.databaseConcepts

Awareness 数据模型（AI Database 概念）

一句话：Awareness 是给 agent 的原生记忆数据库——把「记忆」当作数据库对象来管理： 数据库 → 数据表 → 记录，并自带连接器、Agent 协作与可验证审计。

对象关系

Database（租户整机 / Box）
└── Library（空间 / Space，相当于 schema）
    ├── Records（记忆条目，相当于行）
    │   ├── source（来源：rest / mcp / email / drive / notion …）
    │   ├── metadata（类型、标签、时间）
    │   └── state chain（状态链：哈希 + 根，供审计）
    ├── Sources（连接器：Gmail / Drive / Notion / 飞书）
    └── Members（reader / writer / auditor）
概念说明对应实现
Database客户购买/开通的专属服务器（Box），含独立 Postgres/Qdrant/Redistenant + 服务器实例
Library / Space项目级数据分区；一个 Box 内可多库memory_spaces
Record一条记忆（文本/事实/文档片段），带来源与时间memories 内容条目
Source数据来源连接器（Gmail、Drive、Notion、飞书、REST、MCP）connector_configs
Member空间成员及角色：只读/写入/审计memory_space_members
Agent绑定到空间、按角色访问记忆的智能体；支持任务协议agent_bindings / agent_tasks
Audit每条记录的哈希链 + 定期锚定（ERC-8350），可出证明memory_state_chain / state_anchors

数据流

写入（REST / MCP / 连接器同步）
  → 规范化 + 去重（内容哈希）
  → 向量化（Qdrant）+ 元数据（Postgres）
  → 状态链追加（可选，审计套餐）
  → 可检索

检索
  → 混合检索（向量 + 关键词 + 元数据过滤）
  → 返回记录 + 来源 + 分数
  → 审计套餐可附 inclusion proof

分区与隔离

  • 租户隔离：每个 Box 独立服务器、数据库与对象存储；客户数据不共享
  • 项目分区：Library（空间）隔离不同项目的数据，成员/权限按空间控制
  • 区域：开通时选择 region（数据驻留）；全球版支持多节点
  • 配额：套餐限制库数量、存储、API 调用、席位；超额按量计费

权限模型

角色读写管理成员审计
owner✅✅✅✅（按套餐）
reader✅❌❌❌
writer✅✅❌❌
auditor✅❌❌✅

计费维度

  1. Box 订阅：Box S $45 / Box M $99 / Box L $199（含配额）
  2. 用量：存储、检索、连接器同步、链上锚定（按量）
  3. 席位：团队/空间成员
  4. 审计套餐：状态链 + 锚定 + 合规报告（Team/Enterprise）

接口

  • REST：/api/v1/memories、/spaces、/connectors、/tenants 等
  • MCP：https://awareness.market/mcp（Claude Code、Cursor、OpenCode 等）
  • CLI：npx @awareness.market/cli connect --token …
  • SSH：Box 客户可直接登录自己的服务器

下一步

Core ConceptsDocs.items.gmailTutorial