Integration Patterns
嵌入到 Node 应用
在 Node.js 应用里直接创建和使用本地 Agent 的推荐模式
嵌入到 Node 应用
这是最自然的 SDK 使用方式:
- 你的应用代码直接创建
Agent - 应用启动时准备 session
- handler 收到请求后转成
session.prompt()
适合:
- 内部工具
- MCP 风格包装层
- 面向项目的研发助手服务
这种模式最大的优点是:
- 上下文最完整
- 调试最直接
- 不需要先跨进程排查网络问题
打包行为
当前 @downcity/agent 的内建 system prompt 与初始化模板已经直接编译进 TS 模块。
这意味着:
- 不需要额外复制
PROMPT.txt之类的运行时文本资源 - 把 SDK 嵌入 Electron main 或其他 Node 宿主时,不再依赖包目录中的 prompt 文件结构
- 只要你的运行时能正确加载
@downcity/agent的 ESM 入口,就不会再因为 prompt 资产路径丢失而失败