ForcePilot/backend/package/yuxi/channel/extensions/msteams/graph_members.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

112 lines
3.1 KiB
Python

from __future__ import annotations
import logging
from .graph import MSTeamsGraphClient
logger = logging.getLogger(__name__)
async def get_chat_members(
graph_client: MSTeamsGraphClient,
chat_id: str,
*,
limit: int = 50,
) -> list[dict]:
path = f"/chats/{chat_id}/members?$top={limit}"
try:
data = await graph_client.fetch_json(path)
return _parse_members(data)
except Exception as e:
logger.warning("Failed to get members for chat %s: %s", chat_id, e)
return []
async def add_chat_members(
graph_client: MSTeamsGraphClient,
chat_id: str,
user_ids: list[str],
*,
roles: list[str] | None = None,
) -> bool:
if not user_ids:
return False
for user_id in user_ids:
body = {
"@odata.type": "#microsoft.graph.aadUserConversationMember",
"roles": roles or ["owner"],
"user@odata.bind": f"https://graph.microsoft.com/v1.0/users/{user_id}",
}
path = f"/chats/{chat_id}/members"
try:
await graph_client.fetch_json(path, method="POST", body=body)
except Exception as e:
logger.warning("Failed to add member %s to chat %s: %s", user_id, chat_id, e)
return False
return True
async def remove_chat_member(
graph_client: MSTeamsGraphClient,
chat_id: str,
membership_id: str,
) -> bool:
path = f"/chats/{chat_id}/members/{membership_id}"
try:
await graph_client.fetch_json(path, method="DELETE")
return True
except Exception as e:
logger.warning("Failed to remove member %s from chat %s: %s", membership_id, chat_id, e)
return False
async def get_team_members(
graph_client: MSTeamsGraphClient,
team_id: str,
*,
limit: int = 50,
) -> list[dict]:
path = f"/teams/{team_id}/members?$top={limit}"
try:
data = await graph_client.fetch_json(path)
return _parse_members(data)
except Exception as e:
logger.warning("Failed to get members for team %s: %s", team_id, e)
return []
async def get_channel_members(
graph_client: MSTeamsGraphClient,
team_id: str,
channel_id: str,
*,
limit: int = 50,
) -> list[dict]:
path = f"/teams/{team_id}/channels/{channel_id}/members?$top={limit}"
try:
data = await graph_client.fetch_json(path)
return _parse_members(data)
except Exception as e:
logger.warning("Failed to get members for channel %s in team %s: %s", channel_id, team_id, e)
return []
def _parse_members(data: dict) -> list[dict]:
members = data.get("value", [])
result = []
for m in members:
result.append(
{
"id": m.get("id", ""),
"display_name": m.get("displayName", ""),
"user_id": m.get("userId", ""),
"email": m.get("email", ""),
"roles": m.get("roles", []),
"tenant_id": m.get("tenantId", ""),
"visible_history_start": m.get("visibleHistoryStartDateTime", ""),
}
)
return result