Microsoft Graph 工具包中的对话助手组件

警告

Microsoft Graph 工具包已弃用。 停用期从 2025 年 9 月 1 日开始,计划于 2026 年 8 月 28 日完全停用。 开发人员应迁移到使用 Microsoft Graph SDK 或其他受支持的 Microsoft Graph 工具来构建 Web 体验。 有关详细信息,请参阅 弃用公告。

注意

此组件处于预览状态,可能会发生更改。 不支持在生产应用程序中使用这些组件。 该组件目前仅作为 React 组件提供,没有等效的 Web 组件。

聊天组件允许用户进行 1:1 或群组对话。 此组件不支持频道对话。 该组件允许呈现对话和创作新消息。 所有数据都存储在 Microsoft Teams 中。

示例

以下示例显示了使用该 mgt-chat 组件的对话。

聊天组件的屏幕截图

属性

属性 属性 说明
聊天 ID chatId 用于设置要呈现的 1:1 或群组对话 的字符串 ID。 必填。

CSS 自定义属性

该 mgt-chat 组件不定义 CSS 自定义属性。

事件

该 mgt-chat 组件不提供任何事件。

模板

组件 mgt-chat 不提供要覆盖的模板。

Microsoft Graph 权限

此控件使用以下 Microsoft Graph API 和权限。

配置 权限 API
chatId 已设置 对话助手。ReadBasic,对话助手。Read,ChatMessage.Read,对话助手。ReadWrite、ChatMember.ReadWrite /chats/{id}/messages、 /chats/{id}/messages、 /chats/{id}/messages/{messageId}、 /me/chats/{id}/messages/{messageId}/softDelete、 /chats/{id}/members/{membershipId}、 /chats/{id}/members、 /chats/{id}/messages/{messageId}/hostedContents/{hostedContentId}、 /chats/{id}

子组件

该 mgt-chat 组件由一个或多个子组件组成,这些子组件可能需要前面列出的权限以外的其他权限。 有关详细信息,请参阅每个子组件的文档:

身份验证

该 mgt-chat 组件使用 身份验证文档中所述的全局身份验证提供程序。

缓存

该 mgt-chat 组件缓存聊天消息和相关元数据。

本地化

该 mgt-chat 组件不公开任何本地化变量。

已知问题

  • 组件 mgt-chat 不支持在组件的多个实例或多个选项卡中使用相同的 chatId 内容。
  • 该 mgt-chat 组件不支持主题设置,并且不会遵守浏览器首选项。