> ## Documentation Index
> Fetch the complete documentation index at: https://cndoc-langchain.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 将 Teams 与智能体集成

> 通过自带 Azure 机器人将 LangSmith Fleet 连接到 Microsoft Teams，让智能体能在 Teams 中与用户通信。

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

* 接收来自 Teams 用户的消息，并以消息内容开始新的运行。
* 使用 Bot Framework 在 Teams 对话中直接回复。
* 通过 Microsoft Graph API 工具访问 Teams 频道和消息。

<Note>
  在频道对话中，机器人仅在被明确提及时才会响应。在直接消息和群聊中，机器人会响应所有消息。
</Note>

## 前提条件

* Fleet 中已有的智能体（参见[快速入门](/langsmith/fleet/quickstart)以创建一个）
* 拥有创建资源权限的 [Azure 账户](https://portal.azure.com)
* Microsoft Teams 工作区的管理员访问权限，或安装应用的权限

## 创建 Azure 机器人

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

<Steps>
  <Step title="创建 Azure 机器人资源">
    1. 前往 [Azure 门户](https://portal.azure.com)。
    2. 搜索 **Azure Bot** 并点击 **创建**。
    3. 填写必填字段：
       * **机器人句柄**：机器人的唯一标识符。
       * **订阅**：选择您的 Azure 订阅。
       * **资源组**：创建新的或选择现有的。
       * **应用类型**：选择 **多租户**。
       * **创建类型**：选择 **创建新的 Microsoft 应用程序 ID**。
    4. 点击 **查看 + 创建**，然后点击 **创建**。
  </Step>

  <Step title="获取应用程序凭据">
    资源创建后：

    1. 导航到您的机器人资源，然后在左侧边栏中点击 **配置**。
    2. 复制 **Microsoft 应用程序 ID**。稍后会用到。
    3. 点击应用程序 ID 旁边的 **管理密码**。
    4. 点击 **新建客户端密码**，添加描述，然后点击 **添加**。
    5. 立即复制新密码的 **值**——它只显示一次。

    <Warning>
      创建后立即复制客户端密码值。之后无法检索。如果丢失，必须创建一个新的。
    </Warning>
  </Step>

  <Step title="配置消息传递端点">
    您将在 Fleet 中注册机器人后设置消息传递端点。现在跳过此字段——您稍后会返回此步骤。
  </Step>
</Steps>

## 在 Fleet 中注册机器人

<Steps>
  <Step title="打开集成页面">
    1. 在 [LangSmith UI](https://smith.langchain.com) 中导航到 **Fleet**。
    2. 前往 **集成** 页面。
    3. 点击 **添加 Teams 应用**。
  </Step>

  <Step title="输入凭据">
    填写以下字段：

    * **应用名称**：机器人在 Fleet 中的显示名称。
    * **Azure 应用程序 ID**：来自 Azure 机器人资源的 Microsoft 应用程序 ID。
    * **Azure 应用程序密码**：您之前复制的客户端密码值。
    * **Azure 租户 ID**（可选）：您的 Azure AD 租户 ID。对于多租户机器人，保留默认值。

    点击 **创建** 以注册机器人。
  </Step>

  <Step title="复制 webhook URL">
    注册后，Fleet 会显示一个 **webhook URL**。复制此 URL——您需要它来完成 Azure 机器人配置。
  </Step>

  <Step title="在 Azure 中设置消息传递端点">
    1. 返回 [Azure 门户](https://portal.azure.com) 中的 Azure 机器人资源。
    2. 前往 **配置**。
    3. 将来自 Fleet 的 webhook URL 粘贴到 **消息传递端点** 字段中。
    4. 点击 **应用**。
  </Step>
</Steps>

## 将机器人添加到 Teams

<Steps>
  <Step title="打开 Teams 频道">
    1. 在 Azure 门户中，转到您的机器人资源。
    2. 在左侧边栏中点击 **频道**。
    3. 选择 **Microsoft Teams** 并点击 **应用**。
    4. 同意服务条款。
  </Step>

  <Step title="在 Teams 中安装机器人">
    1. 在 Teams 中，点击左侧边栏的 **应用**。
    2. 点击 **管理您的应用**，然后点击 **上传应用**。
    3. 上传引用您的 Azure 应用程序 ID 的 [Teams 应用清单](https://learn.microsoft.com/en-us/microsoftteams/platform/resources/schema/manifest-schema)，或使用 Azure 机器人频道页面中的 **在 Teams 中打开** 链接。
    4. 将机器人添加到所需的团队或聊天中。
  </Step>
</Steps>

## 将机器人链接到智能体

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

### 从集成页面链接

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

### 从智能体编辑器链接

1. 从左侧导航的 **我的智能体** 中选择您的智能体。
2. 点击 <Icon icon="pencil" /> **编辑智能体**。
3. 滚动到 **频道** 部分。
4. 点击 **Teams**。
5. 从下拉菜单中，选择要链接的 Teams 应用。

## 添加 Teams 工具

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

<Tip>
  您也可以要求智能体自行添加这些工具。在智能体聊天中，尝试：“添加 Teams 工具以便你能响应消息。”
</Tip>

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. 点击 **保存更改**。

<Note>
  `teams_bot_send_proactive_message` 工具使用 Bot Framework 凭据，不需要单独的 OAuth 授权。其他 Teams 工具使用 Microsoft Graph API，可能需要 OAuth 同意。
</Note>

## 配置智能体行为（可选）

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

```
更新你的指令以处理 Teams 触发器和 Teams 工具，实现双向通信
```

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

## 故障排除

### 智能体不响应

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

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

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

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

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

## 后续步骤

<CardGroup cols={3}>
  <Card title="添加更多工具" icon="puzzle" href="/langsmith/fleet/tools">
    将其他服务连接到您的智能体
  </Card>

  <Card title="添加更多频道" icon="bolt" href="/langsmith/fleet/channels">
    设置电子邮件、日程或 webhook 频道
  </Card>

  <Card title="使用模板" icon="layout-grid" href="/langsmith/fleet/templates">
    从预构建的智能体模板开始
  </Card>
</CardGroup>

***

<div className="source-links">
  <Callout icon="terminal-2">
    [将这些文档](/use-these-docs)通过 MCP 连接到 Claude、VSCode 等，以获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/langsmith/fleet/teams-app.mdx) 或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>