Skip to content
LangSmith 文档版本 跟随上游 源快照 701f1b25 更新于 2026-10-18

将 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 服务器的工具。项目可以两者都用,也可以只用其一。

支持的频道

另请参阅

  • 身份:对调用方进行身份验证,并将频道运行限定到解析出的用户。
  • 计划:通过配置的频道传递计划结果。
  • 部署 agent:部署项目变更并配置密钥。
  • CLI 参考:查看频道项目文件约定。

BytesRouter 是社区翻译站点,所有译文仅供参考,一切以官方英文原文为准。