Microsoft Teams 集成
Microsoft Teams 集成提供两种互相独立的连接：
- Agent 机器人：把一个 HiFox Agent 绑成 Teams 机器人，在私聊、群聊 @ 和频道 @ 中对话。
- 任务助手：每个空间一个系统助手。从 Teams 集成页绑定后，可以在群里根据聊天上下文整理需求并创建任务。
两者都通过 Teams Developer Portal 创建的机器人（应用 ID / 租户 ID / 客户端密码）连接，可以同时使用，但需要分别配置。任务助手不是普通 Agent：它不会出现在 Agent 列表、处理人选择器和站内私聊里。
连接前需要准备什么？
从哪里进入？
- 进入组织后，打开 外部应用集成，进入 MS Teams 详情页；
- 或进入某个 Agent 的详情页，在 集成 页签中配置，这种方式会直接绑定当前 Agent。
连接 Agent 机器人
- 打开 连接 MS Teams 弹窗，按右侧的编号指引在 Developer Portal 里准备机器人。
- 选择要绑定的 Agent。
- 填入机器人的 应用 ID、租户 ID 和 客户端密码。
- 点击连接，凭据验证通过后即完成绑定。
- 在设置页 下载应用包 并安装到 Teams，或 复制消息终结点 填回 Developer Portal 的机器人配置里。
绑定后，集成页会显示机器人已加入的团队数量和当前状态，可以重试或断开。
绑定任务助手
- 打开 外部应用集成，进入 MS Teams 详情页的 任务助手 分组。
- 找到你加入的空间，选择 绑定。
- 选择运行该空间任务助手的 Runtime，填入机器人凭据。
每个空间只能有一个 Teams 任务助手。任务助手与 Agent 分身使用同一套设置结构：空间行的 ··· 菜单提供 设置、解绑 和 移除助手。设置 会打开和 Agent 相同的设置面板，可以调整运行电脑与 Runtime、默认模型、指令、技能等；其中 描述 和 指令 默认继承管理后台的「任务助手模板」，模板修改后自动同步，在助手侧改过即标记 已覆盖、可用 恢复继承 回到模板。系统自带一套出厂模板（内置在 Teams 里创建任务的指令），组织管理员可在管理后台的 任务助手模板 页统一维护中文 / 英文模板。
在 Teams 中怎么使用？
私聊机器人
在 Teams 里直接给机器人发私信，可以和绑定的 Agent 对话。第一次私信会创建对应的 Agent 会话，之后在同一私信里继续发送，Agent 会基于这个会话回复。
在群聊或频道里 @ 机器人
在群聊或频道里 @ 机器人并输入问题或指令，Agent 才会回复；没有 @ 的消息不会触发。回复会带上该会话最近约 20 条消息的上下文，消息里带的图片和文件也会作为附件带给 Agent。
发送文件
私聊和群聊里都可以发送图片、文件给 Agent 处理；Agent 回复里的文件会回到原来的 Teams 会话。
管理和断开
回到 MS Teams 集成页可以查看已连接的机器人列表，包括绑定的 Agent、所在团队和当前状态，并进行重试或断开。断开后，这个 Agent 不再通过该机器人收发消息；已有 HiFox 会话和历史消息不会因此删除。
常见问题
连接时提示「Microsoft 拒绝了这些凭据」怎么办？
先核对应用 ID、租户 ID 和客户端密码是否与 Developer Portal 里的一致，客户端密码注意只在新创建时可见。此前版本曾出现有效凭据被服务端误判为无效的问题（已于 2026-10-26 修复）；如果凭据确认有效仍连不上，请重新生成客户端密码后再试。
机器人在 Teams 里收不到消息？
确认已把应用包安装到对应 Teams 组织，并且消息终结点已正确填回 Developer Portal 的机器人配置；群聊和频道里需要 @ 机器人才会触发。
Teams 消息会变成 HiFox 任务吗？
Agent 机器人不会自动把消息变成任务。需要把群里的讨论整理成任务时，使用空间的任务助手：在群里 @ 任务助手，它会根据聊天上下文创建任务。