Skip to main content
通过 LangSmith Fleet,您可以通过注册自定义 Azure 机器人将智能体连接到 Microsoft Teams。连接后,您的智能体可以:
  • 接收来自 Teams 用户的消息,并以消息内容开始新的运行。
  • 使用 Bot Framework 在 Teams 对话中直接回复。
  • 通过 Microsoft Graph API 工具访问 Teams 频道和消息。
在频道对话中,机器人仅在被明确提及时才会响应。在直接消息和群聊中,机器人会响应所有消息。

前提条件

  • Fleet 中已有的智能体(参见快速入门以创建一个)
  • 拥有创建资源权限的 Azure 账户
  • Microsoft Teams 工作区的管理员访问权限,或安装应用的权限

创建 Azure 机器人

在 Fleet 中注册之前,您需要创建一个 Azure 机器人资源并获取其凭据。
1

创建 Azure 机器人资源

  1. 前往 Azure 门户
  2. 搜索 Azure Bot 并点击 创建
  3. 填写必填字段:
    • 机器人句柄:机器人的唯一标识符。
    • 订阅:选择您的 Azure 订阅。
    • 资源组:创建新的或选择现有的。
    • 应用类型:选择 多租户
    • 创建类型:选择 创建新的 Microsoft 应用程序 ID
  4. 点击 查看 + 创建,然后点击 创建
2

获取应用程序凭据

资源创建后:
  1. 导航到您的机器人资源,然后在左侧边栏中点击 配置
  2. 复制 Microsoft 应用程序 ID。稍后会用到。
  3. 点击应用程序 ID 旁边的 管理密码
  4. 点击 新建客户端密码,添加描述,然后点击 添加
  5. 立即复制新密码的 ——它只显示一次。
创建后立即复制客户端密码值。之后无法检索。如果丢失,必须创建一个新的。
3

配置消息传递端点

您将在 Fleet 中注册机器人后设置消息传递端点。现在跳过此字段——您稍后会返回此步骤。

在 Fleet 中注册机器人

1

打开集成页面

  1. LangSmith UI 中导航到 Fleet
  2. 前往 集成 页面。
  3. 点击 添加 Teams 应用
2

输入凭据

填写以下字段:
  • 应用名称:机器人在 Fleet 中的显示名称。
  • Azure 应用程序 ID:来自 Azure 机器人资源的 Microsoft 应用程序 ID。
  • Azure 应用程序密码:您之前复制的客户端密码值。
  • Azure 租户 ID(可选):您的 Azure AD 租户 ID。对于多租户机器人,保留默认值。
点击 创建 以注册机器人。
3

复制 webhook URL

注册后,Fleet 会显示一个 webhook URL。复制此 URL——您需要它来完成 Azure 机器人配置。
4

在 Azure 中设置消息传递端点

  1. 返回 Azure 门户 中的 Azure 机器人资源。
  2. 前往 配置
  3. 将来自 Fleet 的 webhook URL 粘贴到 消息传递端点 字段中。
  4. 点击 应用

将机器人添加到 Teams

1

打开 Teams 频道

  1. 在 Azure 门户中,转到您的机器人资源。
  2. 在左侧边栏中点击 频道
  3. 选择 Microsoft Teams 并点击 应用
  4. 同意服务条款。
2

在 Teams 中安装机器人

  1. 在 Teams 中,点击左侧边栏的 应用
  2. 点击 管理您的应用,然后点击 上传应用
  3. 上传引用您的 Azure 应用程序 ID 的 Teams 应用清单,或使用 Azure 机器人频道页面中的 在 Teams 中打开 链接。
  4. 将机器人添加到所需的团队或聊天中。

将机器人链接到智能体

您可以从集成页面或智能体编辑器将 Teams 机器人链接到智能体。

从集成页面链接

  1. 导航到 Fleet 集成 页面上的 Teams 应用 部分。
  2. 选择要链接的机器人。
  3. 从下拉菜单中,选择要链接到的智能体。

从智能体编辑器链接

  1. 从左侧导航的 我的智能体 中选择您的智能体。
  2. 点击 编辑智能体
  3. 滚动到 频道 部分。
  4. 点击 Teams
  5. 从下拉菜单中,选择要链接的 Teams 应用。

添加 Teams 工具

工具让您的智能体能在 Teams 中执行操作。要响应消息并与 Teams 交互,请添加相关工具。
您也可以要求智能体自行添加这些工具。在智能体聊天中,尝试:“添加 Teams 工具以便你能响应消息。”
  1. 在智能体编辑器中,滚动到 工具 部分。
  2. 点击 + 添加
  3. 搜索“Teams”并添加所需的工具:
    • teams_bot_send_proactive_message — 向 Teams 对话发回消息
    • microsoft_teams_list_my_teams — 列出经过身份验证的用户所属的团队
    • microsoft_teams_list_channels — 列出团队中的频道
    • microsoft_teams_post_channel_message — 向频道发布消息
    • microsoft_teams_read_channel_messages — 读取频道中的最近消息
  4. 如果出现提示,点击 连接 以授权 Microsoft Graph 工具。
  5. 点击 保存更改
teams_bot_send_proactive_message 工具使用 Bot Framework 凭据,不需要单独的 OAuth 授权。其他 Teams 工具使用 Microsoft Graph API,可能需要 OAuth 同意。

配置智能体行为(可选)

您的智能体需要知道如何处理传入的 Teams 消息。通过在智能体聊天中直接提示来更新其指令:
更新你的指令以处理 Teams 触发器和 Teams 工具,实现双向通信
根据您的用例调整指令——例如,您可能希望智能体仅响应某些类型的问题,或在回复前从特定来源提取信息。

故障排除

智能体不响应

  • 检查 Fleet 中的线程是否有需要人工输入的审批。
  • 在频道对话中,确保您 @提及 了机器人。未提及的频道消息会被忽略。
  • 检查 动态 选项卡是否有错误。
  • 验证 Azure 机器人资源中的消息传递端点是否与来自 Fleet 的 webhook URL 匹配。
  • 确保 Fleet 中的机器人注册未被暂停。

注册期间出现无效凭据错误

  • 验证 Azure 应用程序 ID应用程序密码(客户端密码)是否正确。
  • 确保客户端密码未过期。如果需要,在 Azure 中创建新的密码。
  • 检查 Azure 中的机器人类型是否设置为 多租户

机器人在直接消息中有效,但在频道中无效

  • 在频道对话中,机器人必须被明确 @提及
  • 确保机器人已添加到团队,并具有读取频道中消息的权限。

后续步骤

添加更多工具

将其他服务连接到您的智能体

添加更多频道

设置电子邮件、日程或 webhook 频道

使用模板

从预构建的智能体模板开始