主题
将 Managed Deep Agents 连接到频道
将 Managed Deep Agents 连接到可启动运行并接收响应的外部消息服务。
频道让托管 deep agent 可在外部消息服务中使用。来自该服务的消息可以启动 agent 运行,agent 的最终响应会通过同一服务返回。
NOTE
Managed Deep Agents 处于公开 beta 阶段,仅在 US 区域的 LangSmith Cloud 上可用。
项目结构
频道声明位于项目级 channels/ 目录中:
text
my-agent/
agent.py
channels/
slack.py了解频道
频道由外部消息集成的三个部分组成:
- 入站事件:验证并规范化提供商事件,然后启动 agent 运行。
- 出站消息:将 agent 的响应发送回原始对话。
- 预配:创建并配置将服务连接到已部署 agent 的提供商资源。
在 Managed Deep Agents 中,频道将已部署的 agent 连接到消息提供商。
托管运行时负责频道生命周期:
flowchart LR
Provider["Messaging provider"] --> Verify["Verify and normalize event"]
Verify --> Thread["Resolve identity and thread"]
Thread --> Run["Run agent"]
Run --> Reply["Post response"]
Reply --> Provider
classDef trigger fill:#F6FFDB,stroke:#6E8900,stroke-width:2px,color:#2E3900;
classDef process fill:#E5F4FF,stroke:#006DDD,stroke-width:2px,color:#030710;
classDef output fill:#EBD0F0,stroke:#885270,stroke-width:2px,color:#441E33;
class Provider trigger;
class Verify,Thread,Run process;
class Reply output;
提供商适配器决定接受哪些事件、提供商对话如何映射到 Managed Deep Agents 线程,以及如何传递响应。频道声明暴露该提供商支持的配置。
在项目中声明频道
将每个频道放在 channels/ 下的单独模块中。
从每个文件中导出模块级 channel。
文件名会成为配置的频道名称,并在部署内标识该频道。
不要将声明命名为 channels/channel.py。
频道名称在项目内必须唯一。
提供商工厂创建声明。
例如,channels.slack() 会创建一个 Slack 频道。
有关其声明、应用配置和部署流程,请参阅提供商指南。
区分频道与连接器
频道接收可启动 agent 运行的消息并传递响应。MCP 连接器为 agent 提供来自远程 MCP 服务器的工具。项目可以两者都用,也可以只用其一。