AppBase 云控制台
浏览全部文档 · 26/37
AppBase 增强已进入 main

AI Memory

Models、Knowledge Base、Memory 与 Moderation

版本验证信息发布状态与验证 Commit
发布状态
已进入 main
后端验证 Commit
0363062a1c7ea08741975bb5ba0c3361663c9353

功能简介

AI Memory 为 Agent 应用提供项目级长期记忆写入、列表、搜索、召回、反馈、遗忘、导入导出、审计以及用户画像、Knowledge、Experience、Skill 等沉淀路径。Project 需要先绑定可用 Memory Resource，并保持 embedding 空间和访问 Scope 一致。

当前支持范围

  • AI Memory（APPBASE_ENHANCED）：为 Agent 应用提供项目级长期记忆、检索与召回、用户画像、知识和经验沉淀、反馈、遗忘及审计；需要部署 Memory 数据面并绑定资源。

适用场景

  • 让长期任务在多次会话间保留受控上下文。
  • 按 user、agent、run 与 scope 检索记忆。
  • 通过 feedback、forget 和 audit 管理记忆质量与生命周期。

前置条件

  • Memory 数据面已部署且健康。
  • 管理员已创建 Resource 并绑定 Project。
  • Project Memory Config 已选择可用 embedding/chat/rerank Provider。

Console 操作路径

Console → Project → Memory。先创建或选择 Resource，完成 Project Binding 与 Configuration，再使用记忆列表、检索和审计能力。Embedding provider/model/dimensions 初始化后不能原地随意切换。

SDK 示例

SDK · TypeScript
import { Client, Memory } from 'appbase-console-sdk';

const client = new Client()
  .setEndpoint('https://<APPBASE_HOST>/v1')
  .setProject('<PROJECT_ID>')
  .setKey('<API_KEY>');
const memory = new Memory(client);

await memory.create({
  content: 'The user prefers concise release notes.',
  userId: '<USER_ID>',
  scope: 'user',
  infer: true
});

const results = await memory.search({
  query: 'release note preference',
  userId: '<USER_ID>',
  scope: 'user',
  limit: 10
});

REST 示例

REST · Bash
curl 'https://<APPBASE_HOST>/v1/memory/memories/search' \
  -X POST \
  -H 'X-Appwrite-Project: <PROJECT_ID>' \
  -H 'X-Appwrite-Key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  --data '{"query":"release note preference","userId":"<USER_ID>","scope":"user","limit":10}'

权限模型

写入需要 memories.write，搜索/召回需要 memories.read；Resource 与 Project Binding 是更高权限控制面。userId、agentId、runId、scope 和 sub-store 一起限定可见范围，不能依赖前端过滤。

常见错误

现象处理建议
Memory resource unavailable检查 Project Binding、Resource 健康、Memory 数据面和网络。
embedding dimension mismatch创建并验证新的 Memory 实例/空间后再切换，不能混写。
搜索为空核对 scope、userId、检索配置、索引和记忆状态。
403检查 memories Scope 与 Project Binding，不要扩大到全项目读取。

当前限制

  • 不要写入密码、Token、Cookie、API Key 或高敏感原文。
  • 模型推断可能产生不准确记忆，需要 feedback、audit 与 forget 机制。
  • Memory 依赖独立数据面和模型 Provider，不是所有实例默认可用。

Appwrite 兼容说明

Memory 属于 AppBase 独立增强能力，不从 Appwrite Auth/Databases 文档推导行为。

AppBase 增强说明

AppBase 提供从 Resource/Binding 到记忆 CRUD、检索、画像、知识经验、反馈、遗忘与审计的组合数据面。

发布状态和验证 Commit

origin/main 已核验。验证 Commit：0363062a1c7ea08741975bb5ba0c3361663c9353。

权威来源文件列表

  • boundary:frontend candidate 隐藏 Memory 导航；最新 origin/main 已恢复为按 canSeeMemories 条件显示
  • origin-main:console/src/routes/(console)/project-[region]-[project]/memory/
  • origin-main:docs/products/v2.3.x/memory/memory.md
  • origin-main:src/Appwrite/Platform/Modules/Memory/Http/
  • origin-main:tests/memory/README.md

Appwrite taxonomy 仅作信息架构参考：https://appwrite.io/docs/tooling/ai。上游页面不是 AppBase 实现证据。

继续阅读