TiDB X

面向AI智能体的对象存储原生、弹性、多租户SQL引擎。按查询计费（RU）。

快速开始（TiDB Cloud Zero）

即时获取免费的MySQL兼容数据库。无需注册，无需付费。

bash

预配置（单次API调用，无需认证）

curl -s -X POST https://zero.tidbapi.com/v1alpha1/instances \
-H Content-Type: application/json \
-d {tag:my-agent} | tee tidb-zero.json

响应包含：host, port, username, password, expiresAt, claimUrl

提取连接信息

jq -r .instance.connectionString tidb-zero.json

连接（始终使用TLS）

export MYSQL_PWD=$(jq -r .instance.connection.password tidb-zero.json) mysql -u $(jq -r .instance.connection.username tidb-zero.json) \ -h $(jq -r .instance.connection.host tidb-zero.json) \ -P 4000 --ssl-mode=REQUIRED

认领你的实例： 响应中包含claimInfo.claimUrl——打开它即可将临时实例转换为永久TiDB Cloud Starter（免费）。未认领的实例将在30天后自动过期。

bash

获取认领URL

jq -r .instance.claimInfo.claimUrl tidb-zero.json

或直接在 https://tidbcloud.com/free-trial/ 注册

---

何时使用TiDB X

当你的智能体需要具备以下特性的状态时使用：

• - 持久化 — 能承受崩溃、重启、设备故障
• 共享 — 多个智能体读写同一数据
• 隔离 — 按用户或智能体进行数据分离
• 可查询 — SQL查询，不仅仅是键值查找
• 可审计 — 谁在何时做了什么以及为什么
• 弹性 — 能随突发、不可预测的智能体流量扩展
• 高性价比 — 按查询付费，不为空闲实例付费

不适用于： 临时草稿板、纯内存缓存、完全离线的单设备应用。

---

思维模型

智能体写入SQL
│
▼
TiDB服务器（无状态，解析+优化SQL）
│
▼
TiKV（热缓存，快速确认给智能体）
│
▼
S3对象存储（数据源，持久化，廉价，无限）
│
▼
后台池（压缩，DDL — 隔离运行，永不阻塞你的查询）

关键概念：

• - S3是数据源 — 而非本地磁盘
• 计算是无状态的 — 无需数据迁移即可扩缩容
• 后台工作隔离运行 — 压缩永远不会导致延迟飙升
• RU计费 — 每个查询都有请求单元成本；空闲=免费

---

模式（可直接复制使用）

模式1：智能体记忆

存储和查询智能体记忆。适用于支持机器人、编码智能体、个人助手。

sql
CREATE TABLE agent_memory (
id BIGINT AUTO_INCREMENT PRIMARY KEY,
tenant_id VARCHAR(64),
agent_id VARCHAR(64),
type VARCHAR(32),
content TEXT,
tags JSON,
createdat TIMESTAMP DEFAULT CURRENTTIMESTAMP,
INDEX idxtenant (tenantid)
);

-- 存储一条记忆
INSERT INTO agentmemory (tenantid, agent_id, type, content, tags)
VALUES (user123, supportbot, resolution,
客户对账单不满。提供了20%折扣。,
[billing, discount, escalation]);

-- 查询记忆
SELECT content, createdat FROM agentmemory
WHERE tenantid = user123 ORDER BY created_at DESC LIMIT 10;

-- 按标签搜索
SELECT * FROM agent_memory
WHERE tenantid = user123 AND JSON_CONTAINS(tags, billing);

---

模式2：会话上下文（仅追加）

适用于编码智能体、研究智能体或任何长时间运行的任务。仅追加，永不更新。

sql
CREATE TABLE agent_context (
id BIGINT AUTO_INCREMENT PRIMARY KEY,
session_id VARCHAR(128),
step INT,
type VARCHAR(32), -- observation, toolcall, tooloutput, decision
content TEXT,
tokens INT,
createdat TIMESTAMP DEFAULT CURRENTTIMESTAMP,
INDEX idxsession (sessionid, step)
);

-- 追加一个步骤
INSERT INTO agentcontext (sessionid, step, type, content, tokens)
VALUES (taskabc, 42, tooloutput, {file: auth.ts, result: ok}, 800);

-- 崩溃后恢复：重新加载最近步骤+所有决策
SELECT * FROM agent_context
WHERE sessionid = taskabc
AND (step > 30 OR type = decision)
ORDER BY step ASC;

---

模式3：多智能体任务队列

当多个智能体并行运行时防止重复工作。

sql
CREATE TABLE tasks (
id BIGINT AUTO_INCREMENT PRIMARY KEY,
task_key VARCHAR(255) UNIQUE,
status VARCHAR(32) DEFAULT pending,
agent_id VARCHAR(64),
input JSON,
output JSON,
claimed_at TIMESTAMP NULL,
completed_at TIMESTAMP NULL,
INDEX idx_status (status)
);

-- 认领任务（原子操作——只有一个智能体能成功）
UPDATE tasks SET status = claimed, agentid = worker3, claimed_at = NOW()
WHERE task_key = enrich:Union.ai AND status = pending;

-- 完成任务
UPDATE tasks SET status = done,
output = {investors: NEA, Insight Partners},
completed_at = NOW()
WHERE taskkey = enrich:Union.ai AND agentid = worker_3;

---

模式4：可审计决策（溯源）

当你需要解释智能体为何做出某个行为时使用。

sql
CREATE TABLE agent_decisions (
id BIGINT AUTO_INCREMENT PRIMARY KEY,
tenant_id VARCHAR(64),
agent_id VARCHAR(64),
action VARCHAR(32),
reasoning TEXT,
source JSON, -- {guideline: WHO-2026, confidence: 0.92}
createdat TIMESTAMP DEFAULT CURRENTTIMESTAMP,
INDEX idxtenant (tenantid)
);

-- 记录决策及其推理
INSERT INTO agentdecisions (tenantid, agent_id, action, reasoning, source)
VALUES (patient456, medbot, recommend,
HbA1c = 7.8%，高于7%阈值。根据WHO指南推荐二甲双胍。,
{guideline: WHO-2026-diabetes, confidence: 0.92});

-- 审计追踪
SELECT action, reasoning, source, createdat FROM agentdecisions
WHERE tenantid = patient456 ORDER BY created_at DESC;

---

模式5：区块链事件索引（Web3）

监控并关联跨多条链的链上活动。

sql
CREATE TABLE chain_events (
id BIGINT AUTO_INCREMENT PRIMARY KEY,
chain VARCHAR(16),
tx_hash VARCHAR(128),
block_number BIGINT,
from_addr VARCHAR(64),
to_addr VARCHAR(64),
value_wei VARCHAR(78),
method VARCHAR(64),
agent_id VARCHAR(64),
tags JSON,
createdat TIMESTAMP DEFAULT CURRENTTIMESTAMP,
INDEX idxchainblock (chain, block_number),
INDEX idxaddr (fromaddr)
);

-- 索引一笔鲸鱼交易
INSERT INTO chainevents (chain, txhash, blocknumber, fromaddr, to_addr,
valuewei, method, agentid, tags)
VALUES (ethereum, 0xabc..., 19500000, 0xwhale..., 0xuniswap...,
50000000000000000000, swap, whale_watcher, [whale, defi]);

-- 查找鲸鱼活动
SELECT chain, method, valuewei FROM chainevents
WHERE JSONCONTAINS(tags, whale) ORDER BY createdat DESC;

-- 跨链：同一钱包在多个链上
SELECT chain, COUNT(*) as txns FROM chain_events
WHERE from_addr = 0xwhale... GROUP BY chain;

---

模式6：DeFi投资组合智能体（Web3）

追踪持仓、策略和退出决策，附带完整推理过程。

sql
CREATE TABLE defi_positions (
id BIGINT AUTO_INCREMENT PRIMARY KEY,
tenant_id VARCHAR(64),
protocol VARCHAR(64),
chain VARCHAR(16),
position_type VARCHAR(32),
token_pair VARCHAR(64),
amount DECIMAL(36,18),
entry_price DECIMAL(36,18),
current_value DECIMAL(36,18),
strategy JSON,
updatedat TIMESTAMP DEFAULT CURRENTTIMESTAMP,
INDEX idxtenant (tenantid)
);

-- 智能体退出持仓并解释原因
INSERT INTO agentdecisions (tenantid,