ForcePilot/backend/package/yuxi/channel/extensions/msteams/graph_users.py
Kris 94444ced96 feat(channel): 添加 Microsoft Teams 渠道扩展
新增 Microsoft Teams 渠道扩展,支持在 Yuxi 平台中集成 Microsoft Teams 协作平台。

包含以下功能模块:
- sdk: Bot Framework SDK 封装
- config: 渠道配置管理
- gateway: SSE/WebSocket 网关接入
- webhook: Webhook 事件处理
- outbound: 外发消息管理
- streaming: 流式消息处理
- pairing: 用户配对与绑定
- security: 安全校验
- auth: JWT 认证
- jwks: JWKS 密钥管理
- dedupe: 消息去重
- monitor: 渠道状态监控
- status: 会话状态管理
- session: 会话管理
- state: 状态管理
- runtime: 运行时管理
- actions: 动作处理
- adaptive_card: 自适应卡片
- task_modules: 任务模块
- message_extension: 消息扩展
- proactive: Proactive Messaging
- graph: Microsoft Graph API 集成
- graph_teams: Teams 操作
- graph_members: 成员管理
- graph_messages: 消息获取
- graph_thread: 线程管理
- graph_users: 用户管理
- graph_upload: 文件上传
- files: 文件处理
- file_consent: 文件授权
- conversations: 会话存储
- mentions: @提及处理
- threading: 线程管理
- reactions: 表情反应
- polls: 投票功能
- meetings: 会议集成
- feedback: 反馈处理
- sso: 单点登录
- deep_links: 深层链接
- incoming_webhook: 入站 Webhook
- localization: 本地化
- user_agent: 用户代理
- sent_message_cache: 消息缓存
- types: 类型定义
2026-05-21 11:28:42 +08:00

64 lines
1.7 KiB
Python

from __future__ import annotations
import logging
from .graph import MSTeamsGraphClient
logger = logging.getLogger(__name__)
async def search_users(
graph_client: MSTeamsGraphClient,
query: str,
*,
limit: int = 10,
) -> list[dict]:
path = f'/users?$search="displayName:{query}"&$top={limit}&$select=id,displayName,mail,userPrincipalName'
try:
data = await graph_client.fetch_json(path)
return _parse_users(data)
except Exception as e:
logger.warning("User search failed for query '%s': %s", query, e)
return []
async def get_user(
graph_client: MSTeamsGraphClient,
user_id: str,
) -> dict | None:
path = f"/users/{user_id}?$select=id,displayName,mail,userPrincipalName"
try:
data = await graph_client.fetch_json(path)
return _parse_single_user(data)
except Exception as e:
logger.warning("Failed to get user %s: %s", user_id, e)
return None
async def get_aad_object_id(
graph_client: MSTeamsGraphClient,
identifier: str,
) -> str | None:
users = await search_users(graph_client, identifier)
for user in users:
if (
user.get("displayName", "").lower() == identifier.lower()
or user.get("mail", "").lower() == identifier.lower()
):
return user.get("id")
return None
def _parse_single_user(data: dict) -> dict:
return {
"id": data.get("id", ""),
"display_name": data.get("displayName", ""),
"mail": data.get("mail", ""),
"user_principal_name": data.get("userPrincipalName", ""),
}
def _parse_users(data: dict) -> list[dict]:
users = data.get("value", [])
return [_parse_single_user(u) for u in users]