多数AI智能体（AI Agent，指能自主执行任务的AI程序）的记忆力堪比金鱼——对话两轮，上下文窗口（Context Window，模型一次能处理的文本长度）清空，一切归零。用户刚交代完偏好，转眼就得重说一遍。这种体验像什么？像你跟一个每次见面都自我介绍的新人打交道。
持久化记忆是刚需，但实现路径往往臃肿：装SDK、配仪表盘、调接口，还没开始写业务逻辑，半天没了。TIAMAT Memory API走了一条反直觉的路——用curl（命令行工具，用于发送HTTP请求）就能跑通全流程，注册、存储、召回、健康检查，四步搞定。
免费层给10条存储额度、每日50次召回，够你把原型跑起来，确认这层记忆真的有价值，再考虑付费。
第一步：拿钥匙，30秒
不需要邮箱验证，不需要填表单。直接POST一个agent名称：
curl -X POST https://memory.tiamat.live/api/keys/register \ -H "Content-Type: application/json" \ -d '{"agent_name": "my-agent"}'
返回很直白：api_key、限额、一句提醒"Save your API key — it will not be shown again"。存进环境变量，后续命令直接引用。
这个设计有个好处——自动化友好。CI/CD流水线里塞一行curl，测试环境就能自动拿到临时密钥，用完即弃。
第二步：写记忆，带标签
存储接口同样朴素。内容+标签，JSON包进去：
curl -X POST https://memory.tiamat.live/api/memory/store \ -H "Authorization: Bearer $TIAMAT_MEMORY_KEY" \ -H "Content-Type: application/json" \ -d '{ "content": "User prefers concise answers and curl examples", "tags": ["preferences", "writing-style"] }'
返回里的charged: false是个贴心字段——明确告诉你这笔走的是免费额度，不是误扣费。memory_id、已用/总额度、重要性评分（默认0.5）、标签，信息给全。
标签是手动管理的，没有自动分类。好处是可控，坏处是得自己设计taxonomy（分类体系）。小规模场景够用，规模大了可能需要在上层封装一层语义标签推荐。
第三步：召回，语义匹配
查询用GET，query参数支持URL编码的自然语言：
curl "https://memory.tiamat.live/api/memory/recall?query=concise%20curl&limit=5" \ -H "X-API-Key: $TIAMAT_MEMORY_KEY"
返回结果按语义相关度排序。示例里搜"concise curl"，命中了之前存的"User prefers concise answers and curl examples"。recalls_remaining_today实时显示剩余额度，方便你做客户端侧的用量预警。
这里有个细节：召回用的是语义搜索，不是精确匹配。你存的是"prefers concise answers"，搜"brief responses"也可能命中，具体效果取决于嵌入模型（Embedding Model，将文本转为向量的技术）。TIAMAT没公开模型细节，实际召回率需要你自己测。
健康检查与工程考量
公开健康端点返回实时状态，写进你的监控脚本：
curl https://memory.tiamat.live/health
从工程视角看，这个API的设计哲学很清晰：最小可行接口。没有批量操作、没有复杂权限、没有版本控制。适合什么场景？个人项目、内部工具、MVP验证。不适合什么？多租户SaaS、合规要求高的金融医疗、需要细粒度审计的企业级部署。
免费层的10条存储是个硬限制，但设计得巧妙——刚好够你验证"记忆层是否真的提升了用户体验"，而不是无限期白嫖。50次/日的召回额度，按每次对话平均2-3次查询算，能支撑15-25轮完整测试。
对比自建方案：用PostgreSQL+pgvector搭向量存储，开发成本至少2-3人天，后续还要运维。TIAMAT把启动成本压到接近零，代价是失去控制力。这个trade-off（权衡）对早期验证很划算。
最后提一个未解的问题：持久化记忆普及后，用户隐私边界在哪？你的智能体记住了"用户离婚咨询记录"或"抑郁症用药史"，这些数据的生命周期、删除权、跨场景隔离，TIAMAT的文档里还没看到详细说明。技术跑通了，合规功课可能才刚开始。
你的Agent现在能记住事了——但你想让它记住什么，又愿意让第三方服务记住什么？
热门跟贴