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 资产路径丢失而失败