本教程将逐步构建一个研究助手。请先完成快速入门以搭建项目框架、添加 API 密钥并在本地运行 mda dev。然后添加一个搜索工具、使用持久化记忆、安排智能体每日定时运行,并将其部署到 LangSmith。 若要查看结合了常用功能的完整项目,请参考示例项目。
托管深度代理目前处于私有测试阶段,仅在LangSmith Cloud的美国区域提供。加入等待列表以申请访问权限。

构建智能体

1

编写指令

用研究助手的行为定义替换 instructions.md 文件内容。这些指令引用了你接下来要添加的工具以及运行时提供的持久化记忆:
instructions.md
2

添加搜索工具

创建一个 tools/ 模块并包含一个搜索工具,然后将其导入到智能体入口。本示例返回一个占位符结果,因此无需外部 API 即可运行。将函数主体替换为调用你的搜索提供商。
将该工具导入智能体入口并传递给定义:
关于自定义工具的更多信息,请参阅自定义工具。
3

在本地运行智能体

安装依赖项并启动本地开发服务器:
mda dev 会在 LangSmith Studio 中打开该智能体。发送一个问题,并确认智能体调用了 web_search 并使用返回的片段回答了问题。
4

使用持久化记忆

托管记忆默认开启,因此你无需配置后端。运行时将持久化记忆存储在 Context Hub 中,智能体在运行期间会读取和写入这些记忆。由于指令要求智能体记住感兴趣的主题,请在一轮对话中告诉它一个偏好(例如“我只关心开源版本”),然后开始一个新的对话,并确认它能回忆起该偏好。要关闭托管记忆,请在智能体定义中设置 disable_memory=True 或 disableMemory: true。有关冷热存储层、身份重载和组织记忆的更多信息,请参阅记忆。
5

设置每日摘要调度

添加一个 schedules/ 模块,以便智能体按照 cron 计划运行,无需用户消息。此计划在太平洋时间每周一至周五上午 8 点运行:
部署上线后,mda deploy 会将此调度整合到 LangSmith 的定时任务中。有关线程行为和限制,请参阅调度。
6

部署智能体

将项目部署到 LangSmith:
成功后,CLI 会打印部署信息中心的 URL。部署过程会将指令同步到 Context Hub,上传编译后的项目,并整合每日调度。有关部署标志和故障排除,请参阅部署智能体和 CLI 参考。
7

检查运行

在 LangSmith 中打开打印的 URL,以检查构建状态和版本。打开跟踪记录以检查智能体的输入、模型调用、web_search 调用、记忆读写以及最终响应。

后续步骤

自定义中间件

在模型和工具调用周围添加日志记录、重试、限制和防护措施。

身份

将线程和记忆的范围限定到已认证的调用者。

记忆

使用 Context Hub 的 /memories 在多个线程中持久保存偏好。

评估

编译 Harbor 交接并运行 Harbor 风格的任务。

连接器

加载 MCP 工具或受约束的 LangSmith 功能。

通道

接收 Slack 事件并通过消息通道回复。

示例项目

查看一个结合了常用功能的完整项目。