KocoroMicrosoft Teams 集成配置指南
通过自建 Bot Framework 应用，将 Kocoro 中的智能体接入 Microsoft Teams，让团队成员可以在单聊或群聊中直接与你的智能体对话。全流程约 10 分钟。
开始前的准备
- 一个可在 Teams 开发者门户创建应用与机器人的 Microsoft Teams / Microsoft 365 账号。
- 已安装并完成初始化的 Kocoro，并至少创建一个智能体。
- 一台保持运行的 Mac，用于承载 Kocoro 并回应消息。
- 1
创建机器人（Bot）
打开 Teams 开发者门户，进入「Tools → Bot management」，点击「New bot」，填写名称（例如「Kocoro」），点击「Add」。创建后会显示 Bot ID，请记下它，后续在 Kocoro 中注册时需要用到。
- Teams 开发者门户: https://dev.teams.microsoft.com/
图 1：在「Tools → Bot management」中创建机器人。 - 2
将机器人端点指向 Kocoro
打开刚创建的机器人，进入「Configure」，将端点地址（Endpoint address）设置为下方的 Kocoro Teams 端点，点击「Save」。
https://api.shannon.run/api/v1/channels/teams/events图 2：设置机器人的消息端点并保存。 - 3
创建客户端密钥（Client secret）
进入「Client secrets」标签页，点击「Add a secret」，复制生成的密钥。下一步将作为 App Password 填入 Kocoro。
密钥仅显示一次，请立即复制并妥善保存；如丢失需重新创建。图 3：创建并复制客户端密钥。 - 4
在 Kocoro 中注册机器人
打开 Kocoro，进入「能力 → 连接器」，在「Microsoft Teams」分组点击「添加机器人」。将 Bot ID 填入 App ID、客户端密钥填入 App Password，可选填显示名称，点击「注册机器人」。
- 注册成功后，Kocoro 将使用这组凭证收发 Teams 消息。
- 可随时回到「连接器」页面查看连接状态或移除机器人。
图 4：在 Kocoro 中填入凭证并注册机器人。 - 5
创建应用（App）
回到 Teams 开发者门户，进入「Apps」，点击「New app」，填写应用名称，清单版本保持最新稳定版，点击「Add」。这个应用是让用户在 Teams 中安装机器人的安装包。
图 5：在「Apps」中创建新应用。 - 6
填写基础信息
在应用的「Basic information」页填写简短名称和简短/详细描述。此处的 App ID 由 Microsoft 生成，在你的组织内唯一。
图 6：填写应用的基础信息。 - 7
填写开发者信息与 URL
向下滚动到「Developer information」与「App URLs」，填写开发者/公司名称、网站，以及隐私政策和使用条款的 URL，点击「Save」。
图 7：填写开发者信息与应用 URL 并保存。 - 8
上传应用图标
进入「Branding」，上传两个图标：彩色图标（192×192 像素 PNG，中心含 96×96 图形）和描边图标（32×32 像素，白色或透明）。可直接使用下方的 Kocoro 图标。
图 8：在「Branding」中上传彩色图标与描边图标。 - 9
添加 Bot 功能
打开「App features」，在「Select a feature to add」中选择「Bot」。
图 9：为应用添加 Bot 功能。 - 10
选择 Bot 并设置可用范围
在「Identify your bot」下选择「Select an existing bot」，选中第 1 步创建的机器人。然后在「Select the scopes where people can use your bot」中勾选「Personal」和「Group Chat」，点击「Save」。
图 10：选择已有机器人，勾选可用范围并保存。 - 11
在 Teams 中预览
点击右上角的「Preview in Teams」，即可将应用安装到你的 Teams 客户端。
图 11：点击「Preview in Teams」安装并测试。
完成！开始在 Teams 中使用
应用安装后，成员即可在单聊中向机器人发送消息，或在群聊中 @它，由 Kocoro 智能体生成回复。如需在群聊或频道中使用，请先把机器人添加进去。