AGENT CONTEXT INFRASTRUCTURE
给你的 AI
装上长期记忆
写入对话,自动抽取事实;按语义检索,把最相关的记忆拼进 prompt。删除后不可召回,账号之间数据隔离。
- 写入即记异步抽取,事实、原文、时间线一起落库
- 语义召回向量 + 词法融合,Top5 控制在 150 token 内
- 删除干净删除后 retrieve / answer / chat 都不再出现
- 0.6B 重排自训判别式打分,可选档,失败自动退 R2
当前版本 iris-v4c · 测试环境,请勿写入真实敏感数据
注册后自动登录。API Key 在控制台里创建,只显示一次。
你好,朋友
这里是你的 Iris 测试工作台。先写入一段对话,再问一句,看看它记住了什么。
测试环境
正在检查服务…
记忆–
用户–
今日 tokens–
检索档位–
接入地址
API浏览器和 SDK 都用这个地址。
https://iris.ainward.com
API Key
还没有 Key。
Key 以 um_ 开头。调用时放在 X-API-Key 头里,或者 Authorization: Bearer。
快速体验
不用写代码写入一段对话,等抽取完成,再问一句。数据只属于你的账号。
首次查询会建立模型连接,可能多花几秒;之后通常 1–2 秒。
等待操作…
API 用法
curl也可以把 Key 交给你的服务端、SDK 或 MCP。
写入
curl -sS -X POST https://iris.ainward.com/api/v1/ingest \
-H "X-API-Key: $IRIS_KEY" \
-H "Content-Type: application/json" \
-d '{"subject_id":"demo-user","session_id":"chat-1",
"messages":[
{"role":"user","content":"我叫林晓,我对花生严重过敏。"},
{"role":"assistant","content":"好的,记住了。"}
]}'
检索
curl -sS -X POST https://iris.ainward.com/api/v1/retrieve \
-H "X-API-Key: $IRIS_KEY" \
-H "Content-Type: application/json" \
-d '{"subject_id":"demo-user","query":"我对什么过敏?","top_k":5}'
写入是异步的:拿到 job_id 后轮询 GET /api/v1/jobs/<job_id>,状态变成 success 再检索。
接口一览
v4c| 方法 | 路径 | 作用 |
|---|---|---|
| POST | /api/v1/ingest | 写入一段对话,返回 job_id |
| GET | /api/v1/jobs/{job_id} | 查看抽取进度和结果 |
| POST | /api/v1/retrieve | 检索 Top5 记忆 |
| POST | /api/v1/answer | 基于记忆直接回答 |
| POST | /api/v1/chat | 带记忆的多轮对话 |
| GET | /api/v1/memories | 列出记忆,支持 q 过滤 |
| DELETE | /api/v1/memories/{id} | 删除一条记忆 |
| DELETE | /api/v1/subjects/{id} | 清空一个用户的全部数据 |
鉴权:X-API-Key: um_... 或 Authorization: Bearer um_...。错误返回 JSON,带 trace_id。