antelope1992-cmyk/recallmesh-agentic-memory

# RecallMesh RecallMesh 是一个专为事件响应 agent 设计的 agentic memory 层。它将嘈杂的运维工作转化为持久化记忆：证据、决策、runbook 步骤、待办任务、操作员反馈和语义检索全部存储在 CockroachDB 中，让 agent 能够跨会话执行，且不会忘记之前的决策原因。 专为 CockroachDB x AWS Hackathon: Build with Agentic Memory 而构建。 ## 为什么它很重要 大多数 agent 演示仅记住聊天记录。生产级 agent 需要的更多：它们需要事务性状态、语义召回、可审计性以及支持跨区域容错的持久化。RecallMesh 将 CockroachDB 作为 agent 记忆的记录系统，并通过 AWS 友好的接口运行 agent。 演示场景是 SRE 事故指挥官。用户报告生产环境问题。RecallMesh 检索相关的事故和 runbook，生成响应计划，存储决策轨迹，创建任务，并可通过 `ccloud` 摄取 CockroachDB Cloud 审计事件。 ## 黑客松契合度 使用的 CockroachDB 工具： - CockroachDB Distributed Vector Indexing：`memory_events.embedding VECTOR(64)` 外加用于语义记忆检索的向量索引。 - ccloud CLI：可选的运维端点和脚本，用于读取 Cloud 审计/集群状态并将其转化为 agent 记忆。 使用的 AWS 服务： - AWS Lambda：用于事故事件和外部记忆写入的无服务器摄取处理程序。 - Amazon S3：可选的制品归档，用于存储事故的 payload、日志、截图或复盘报告。 - Amazon Bedrock：可选的 embedding 模型路径；确定性的本地 embedding 确保演示在没有云凭证的情况下也能运行。 ## 本地运行 ``` npm install npm run seed npm start ``` 打开 `http://localhost:8787`。 当未配置 `DATABASE_URL` 时，应用将使用本地 JSON 存储运行。设置 `DATABASE_URL` 以使用 CockroachDB Cloud。 ## CockroachDB 设置 1. 创建一个 CockroachDB Cloud 集群。 2. 创建一个名为 `recallmesh` 的数据库。 3. 运行 `db/schema.sql`。 4. 设置 `DATABASE_URL`。 5. 启动应用。 ``` ccloud auth login ccloud cluster create basic recallmesh-demo us-east-1 --cloud AWS --spend-limit 0 ccloud cluster database create recallmesh-demo recallmesh ccloud cluster sql --connection-url recallmesh-demo ``` 然后应用： ``` cockroach sql "$DATABASE_URL" -f db/schema.sql ``` ## AWS 部署 `aws/template.yaml` 包含一个 SAM 模板，用于： - Lambda API 入口点。 - S3 制品桶。 - 用于 CockroachDB 和可选 Bedrock embedding 的环境变量。 ``` sam build sam deploy --guided ``` ## 演示流程 1. 填充示例 runbook 和历史事故记忆。 2. 打开仪表板。 3. 提交一个事故：“checkout 延迟在 model router 推出后激增”。 4. 观察 RecallMesh 检索相关记忆、创建计划、存储决策并生成任务。 5. 触发 ccloud 快照端点，将集群/审计事件作为运维记忆进行摄取。 ## 仓库导航 - `src/server.js`：本地 API 和静态演示服务器。 - `src/agent/incidentAgent.js`：确定性 agent 规划器和记忆写入器。 - `src/memory/cockroachStore.js`：CockroachDB 记忆存储。 - `src/memory/localStore.js`：本地演示存储。 - `db/schema.sql`：事务性记忆 schema 和向量索引。 - `aws/template.yaml`：AWS 部署。 - `docs/DEVPOST_SUBMISSION.md`：可直接粘贴的 Devpost 文案。

标签：AI智能体, AWS, CockroachDB, DPI, MITM代理, Serverless, 向量检索, 自定义脚本, 记忆层, 运维管理