SuperAPI AI 工具集

synap-codex

通用与其它

查看项目

更新于 10-16 07:16

技能介绍

用途:为 AI 智能体加入持久、结构化的长期记忆。Synap 作为托管记忆层,摄取对话与文档,抽取事实、偏好、情节、实体等结构化知识,并在检索时返回带排序、带作用域(scope)的上下文;无需自建向量数据库或检索管线。

主要能力:两条写入路径——sdk.conversation.record_message(...) 逐轮记录(唯一注册 conversation_id 的调用)与 sdk.memories.create(...) 写入持久知识(较重,默认 mode="long-range"),生产聊天智能体通常两者并用。四个检索接口按摄取作用域匹配:sdk.user.context.fetch(user_id=...)、sdk.customer.context.fetch(customer_id=...)、sdk.client.context.fetch()、sdk.conversation.context.fetch(conversation_id=...)。作用域链由窄到宽为 USER → CUSTOMER → CLIENT → WORLD;每次调用带 user_id,B2B 带 customer_id。冷作用域返回空 ContextResponse 而非报错。读取失败则返回空并记日志,写入失败则抛错(框架包抛 SynapIntegrationError)。所有调用均为异步,需 await。

使用方式:无 CLI,配置在仪表盘手动完成。先识别技术栈,参考 reference/frameworks/<name>.md(共 19 个集成,含一个免代码托管 MCP 服务器)。在仪表盘注册、创建 Client 与 Instance(可上传用例 .md)、设定 B2C/B2B、生成 API key,然后暂停并让用户设置 API key,再安装 SDK 与框架包、写入集成代码、运行 python scripts/verify_synap.py 验证,未通过不得报告完成。

语言:Python 3.11+ 为主,pip install maximem-synap;TypeScript/Node 18+ 用 npm install @maximem/synap-js-sdk,其内部以子进程调用 Python,故宿主机也需 Python 3.11+。

限制:不负责创建实例或 API key(需在仪表盘手动完成),不配置 MACA 记忆架构文件。需网络访问与文件写入权限,受限沙箱下应告知用户自行执行命令。不提供独立收费或价格信息。资料来源以官方文档为准。