SuperAPI AI 工具集

enterprise integration skill

通用与其它

查看项目

更新于 10-15 21:40

技能介绍

本技能用于在 VS Code 扩展中构建企业级功能,聚焦 Microsoft Graph API、Azure AD(现为 Microsoft Entra ID)认证与企业模式功能开关。

用途:为扩展接入企业能力(如日历、邮件、在线状态、联系人、用户资料),并按企业模式与企业设置进行功能控制。

主要能力:

  1. 认证流程:使用 vscode.authentication.getSession('microsoft', scopes, { createIfNone: false }) 获取令牌,采用渐进式范围获取,如初始仅请求 User.Read,完整 Graph 范围含 Calendars.Read、Mail.Read、Presence.Read、People.Read。
  2. Graph API 客户端:基于端点 https://graph.microsoft.com/v1.0,封装 graphFetch(path),携带 Bearer 令牌,响应失败时记录状态码并返回 null。
  3. 功能端点对照:日历 /me/calendar/events(Calendars.Read)、邮件 /me/messages(Mail.Read)、在线状态 /me/presence(Presence.Read)、联系人 /me/people(People.Read)、用户资料 /me(User.Read)。
  4. 企业功能开关:通过 vscode.workspace.getConfiguration 读取 alex.enterprise.enabled 等布尔配置,控制企业模式及具体子功能是否启用。
  5. 条件 UI 与命令:根据企业模式和 Graph 连接状态选择显示企业区块、登录按钮或功能按钮;命令可通过 when 条件如 config.alex.enterprise.enabled 控制显示。
  6. 设置组织:采用 extension.area.feature.setting 层级,如 alex.enterprise.graph.calendarEnabled、calendarDaysAhead(范围 1–30,默认 7)。
  7. Chat 命令处理:在命令中先检查企业模式与 Graph 可用性,再执行逻辑并通过 ChatResponseStream 返回 Markdown 与元数据。

使用方式:在 VS Code 扩展工程中参照上述模式编写认证、API 调用、配置读取、UI 与聊天命令处理代码。示例用法包括询问如何添加 Microsoft Graph 认证、企业功能开关模式、日历所需范围、企业设置组织方式。

限制与注意事项:资料标明 Microsoft Graph 与 Azure AD API 频繁变化,认证流与权限模型会变更;需关注 Graph API 版本更新、MSAL 大版本发布、Azure AD 更名为 Entra ID 及新增范围权限。资料最后验证时间为 2026 年 2 月(MSAL 2.x、Graph v1.0)。资料未提供具体安装命令、包名、价格或平台支持信息。