托管深度代理支持常规的深度代理 tools 配置界面。在你的项目中定义 LangChain 工具,将其导入到 agent.py 或 agent.ts 文件中,然后传递给 define_deep_agent 或 defineDeepAgent。
托管深度代理目前处于私有测试阶段,仅在LangSmith Cloud的美国区域提供。加入等待列表以申请访问权限。

已编写工具与连接器工具

托管深度代理可以使用两种工具: 使用已编写工具来实现业务逻辑、私有 API、数据库访问以及其他属于你的代理项目中的代码。当工具界面由远程 MCP 服务器公开时,请使用 MCP 连接器。 有关 LangChain 工具定义的更多信息,请参见工具。

添加工具模块

将自定义工具代码放在项目中的 tools/ 目录下,并从代理入口文件导入。有关完整的项目布局,请参阅 CLI 项目文件参考。

将工具附加到代理

将工具导入到项目根目录的代理入口文件中,并在 tools 列表中传递它们。
mda dev 和 mda deploy 命令会将项目文件复制到编译后的构建中。你的导入方式应与在普通本地 Python 或 TypeScript 项目中相同。
使用清晰、唯一的工具名称。MCP 连接器工具会附加在已编写工具之后,并且连接器名称默认会添加前缀以避免冲突。

使用密钥和上下文

工具可以从环境变量中读取部署密钥。对于 mda dev,将本地值放在 .env 文件中;mda deploy 会将非保留的 .env 值作为托管部署密钥进行转发。 当项目声明了身份时,工具和中间件会为经过身份验证的调用者接收一个冻结的 runtime.identity 信封。建议优先使用它,而不是客户端提供的、用于参与者或租户 ID 的可配置密钥。 对于其他运行时值,例如请求元数据或功能标志,请使用常规的 LangChain 运行时上下文模式来处理工具。请参阅如何从工具内部访问上下文。

测试与部署

使用 mda dev 在本地测试项目,然后使用 mda deploy 进行部署。在 LangSmith 中打开部署追踪,以检查模型调用、工具调用、错误和延迟情况。