- 接收来自 Teams 用户的消息,并以消息内容开始新的运行。
- 使用 Bot Framework 在 Teams 对话中直接回复。
- 通过 Microsoft Graph API 工具访问 Teams 频道和消息。
在频道对话中,机器人仅在被明确提及时才会响应。在直接消息和群聊中,机器人会响应所有消息。
前提条件
创建 Azure 机器人
在 Fleet 中注册之前,您需要创建一个 Azure 机器人资源并获取其凭据。创建 Azure 机器人资源
- 前往 Azure 门户。
- 搜索 Azure Bot 并点击 创建。
- 填写必填字段:
- 机器人句柄:机器人的唯一标识符。
- 订阅:选择您的 Azure 订阅。
- 资源组:创建新的或选择现有的。
- 应用类型:选择 多租户。
- 创建类型:选择 创建新的 Microsoft 应用程序 ID。
- 点击 查看 + 创建,然后点击 创建。
获取应用程序凭据
资源创建后:
- 导航到您的机器人资源,然后在左侧边栏中点击 配置。
- 复制 Microsoft 应用程序 ID。稍后会用到。
- 点击应用程序 ID 旁边的 管理密码。
- 点击 新建客户端密码,添加描述,然后点击 添加。
- 立即复制新密码的 值——它只显示一次。
在 Fleet 中注册机器人
打开集成页面
- 在 LangSmith UI 中导航到 Fleet。
- 前往 集成 页面。
- 点击 添加 Teams 应用。
输入凭据
填写以下字段:
- 应用名称:机器人在 Fleet 中的显示名称。
- Azure 应用程序 ID:来自 Azure 机器人资源的 Microsoft 应用程序 ID。
- Azure 应用程序密码:您之前复制的客户端密码值。
- Azure 租户 ID(可选):您的 Azure AD 租户 ID。对于多租户机器人,保留默认值。
在 Azure 中设置消息传递端点
- 返回 Azure 门户 中的 Azure 机器人资源。
- 前往 配置。
- 将来自 Fleet 的 webhook URL 粘贴到 消息传递端点 字段中。
- 点击 应用。
将机器人添加到 Teams
在 Teams 中安装机器人
- 在 Teams 中,点击左侧边栏的 应用。
- 点击 管理您的应用,然后点击 上传应用。
- 上传引用您的 Azure 应用程序 ID 的 Teams 应用清单,或使用 Azure 机器人频道页面中的 在 Teams 中打开 链接。
- 将机器人添加到所需的团队或聊天中。
将机器人链接到智能体
您可以从集成页面或智能体编辑器将 Teams 机器人链接到智能体。从集成页面链接
- 导航到 Fleet 集成 页面上的 Teams 应用 部分。
- 选择要链接的机器人。
- 从下拉菜单中,选择要链接到的智能体。
从智能体编辑器链接
- 从左侧导航的 我的智能体 中选择您的智能体。
- 点击 编辑智能体。
- 滚动到 频道 部分。
- 点击 Teams。
- 从下拉菜单中,选择要链接的 Teams 应用。
添加 Teams 工具
工具让您的智能体能在 Teams 中执行操作。要响应消息并与 Teams 交互,请添加相关工具。- 在智能体编辑器中,滚动到 工具 部分。
- 点击 + 添加。
- 搜索“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 — 读取频道中的最近消息
- 如果出现提示,点击 连接 以授权 Microsoft Graph 工具。
- 点击 保存更改。
teams_bot_send_proactive_message 工具使用 Bot Framework 凭据,不需要单独的 OAuth 授权。其他 Teams 工具使用 Microsoft Graph API,可能需要 OAuth 同意。配置智能体行为(可选)
您的智能体需要知道如何处理传入的 Teams 消息。通过在智能体聊天中直接提示来更新其指令:故障排除
智能体不响应
- 检查 Fleet 中的线程是否有需要人工输入的审批。
- 在频道对话中,确保您 @提及 了机器人。未提及的频道消息会被忽略。
- 检查 动态 选项卡是否有错误。
- 验证 Azure 机器人资源中的消息传递端点是否与来自 Fleet 的 webhook URL 匹配。
- 确保 Fleet 中的机器人注册未被暂停。
注册期间出现无效凭据错误
- 验证 Azure 应用程序 ID 和 应用程序密码(客户端密码)是否正确。
- 确保客户端密码未过期。如果需要,在 Azure 中创建新的密码。
- 检查 Azure 中的机器人类型是否设置为 多租户。
机器人在直接消息中有效,但在频道中无效
- 在频道对话中,机器人必须被明确 @提及。
- 确保机器人已添加到团队,并具有读取频道中消息的权限。
后续步骤
添加更多工具
将其他服务连接到您的智能体
添加更多频道
设置电子邮件、日程或 webhook 频道
使用模板
从预构建的智能体模板开始
将这些文档通过 MCP 连接到 Claude、VSCode 等,以获取实时答案。

