SuperAPI AI 工具集

synap

通用与其它

查看项目

更新于 10-16 08:34

技能介绍

用途:Synap 是 AI 智能体的托管记忆层,让智能体跨会话、用户和租户记住事实、偏好、情节与实体,无需自建向量数据库、抽取管线或检索排序器。本技能用于判断 Synap 是否合适,并把它接入用户所用框架。

主要能力:提供写入(sdk.memories.create)与读取(sdk.user.context.fetch)两类操作;四级作用域 USER→CUSTOMER→CLIENT→WORLD,宽作用域对窄作用域可见;每条轴有 fast 与 accurate/long-range 两种模式,默认检索用 fast、写入用 long-range。支持 19 个框架(LangChain、LangGraph、LlamaIndex、OpenAI Agents SDK、Pydantic AI、CrewAI、AutoGen、Google ADK、Haystack、Agno、Semantic Kernel、Microsoft Agent Framework、NVIDIA NeMo、LiveKit、Pipecat、Claude Agent SDK、Mastra、Vercel AI SDK 等),也支持自定义栈与 MCP 客户端。

使用方式:无 CLI,需在 https://synap.maximem.ai 仪表盘手动创建 Client、Instance、生成 API key;随后 export SYNAP_API_KEY=synap_...,安装 SDK 与框架包,按框架示例写代码,最后运行 python scripts/verify_synap.py 验证。Python 用 MaximemSynapSDK 并 await sdk.initialize()/shutdown();JS 用 @maximem/synap-js-sdk 的 createClient 与 init(),其底层以子进程调用 Python SDK,需 Python 3.11+,不支持 Edge/Workers/Bun/Deno/仅 Node 的 Lambda。所有调用均为异步,勿忘 await。

适用场景:构建或调试需要跨会话记忆、个性化、多租户 B2B 的智能体;评估记忆方案;从自建记忆方案迁移。

限制:单轮 LLM 调用无需跨会话状态时不适用;不负责配置 MACA、不创建实例或 API key、不迁移其他厂商数据;conversation_id 须为合法 UUID;读取失败会降级为空结果,写入失败会抛出 SynapIntegrationError。权威来源为 https://docs.maximem.ai。