使用 LangSmith Fleet，您可以通过注册自定义 Azure Bot 将智能体连接到 Microsoft Teams。连接后，您的智能体可以：

• - 接收 Teams 用户的消息，并使用消息内容启动新的运行。
• - 使用 Bot Framework 直接在 Teams 对话中回复。
• - 通过 Microsoft Graph API 工具访问 Teams 频道和消息。

前提条件

• - Fleet 中现有的智能体（请参阅 快速入门 创建一个）
• - An Azure 账户 并有权限创建资源
• - Microsoft Teams 工作区的管理员访问权限，或安装应用的权限

创建 Azure Bot

在 Fleet 中注册之前，您需要创建一个 Azure Bot 资源并获取其凭据。

在 Fleet 中注册机器人

应用

将机器人链接到坐席

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

从集成页面链接

1. 导航到 **Teams 应用** 部分在 **集成** 页面中。
2. 选择要链接的机器人。
3. 从下拉菜单中，选择要链接到的坐席。

从坐席编辑器链接

1. 从 **我的坐席** 中的左侧导航栏选择您的坐席。
2. 点击 **编辑坐席**.
3. 滚动到 **渠道** section.
4. 点击 **Teams**.
5. 从下拉菜单中，选择要链接的 Teams 应用。

添加 Teams 工具

工具让您的坐席能够在 Teams 中执行操作。要响应消息并与 Teams 交互，请添加相关工具。

1. 在坐席编辑器中，滚动到 **工具** section. 1. 点击 **+ 添加**. 1. 搜索 "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** — 读取频道中的最近消息 1. 如果出现提示，请点击 **连接** 以授权 Microsoft Graph 工具。 1. 点击 **保存更改**.

配置代理行为（可选）

您的代理需要知道如何处理传入的 Teams 消息。通过在代理聊天中直接提示来更新其指令：

Update your instructions to handle the Teams Trigger and Teams Tools
for bidirectional communication

根据您的用例调整指令——例如，您可能希望代理仅响应某些类型的问题，或在回复前从特定来源获取信息。

故障排除

代理无响应

• - 检查 Fleet 中的线程，看是否有需要人工输入的审批。
• - 在频道对话中，请确保您 **@提及** 机器人。未提及的消息将被忽略。
• - 检查 **动态** 选项卡以获取错误信息。
• - 验证 Azure Bot 资源中的消息传递端点与 Fleet 中的 webhook URL 相匹配。
• - 确保机器人注册在 Fleet 中未暂停。

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

• - 验证 **Azure 应用 ID** 和 **应用密码** （客户端密钥）是否正确。
• - 确保客户端密钥未过期。如有需要，请在 Azure 中创建新密钥。
• - 检查机器人类型是否在 Azure 中设置为 **多租户** 。

机器人在私信中有效但在频道中无效

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

后续步骤