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

81 lines
2.5 KiB
Python

from __future__ import annotations
import logging
from .conversation_store import ConversationStore
from .outbound import send_media, send_text
from .sdk import BotFrameworkAdapter
from .types import BotFrameworkActivity, StoredConversationReference
logger = logging.getLogger(__name__)
async def build_conversation_reference(
activity: BotFrameworkActivity,
bot_app_id: str,
) -> StoredConversationReference:
return StoredConversationReference(
activity_id=activity.id,
user={
"id": activity.from_id,
"name": activity.from_name,
"aadObjectId": activity.from_.aad_object_id if activity.from_ else None,
},
bot={
"id": f"28:{bot_app_id}",
"name": "ForcePilot",
},
conversation={
"id": activity.conversation_id,
"conversationType": activity.conversation_type,
"tenantId": activity.tenant_id,
"isGroup": activity.is_group,
},
service_url=activity.service_url,
channel_id=activity.channel_id,
tenant_id=activity.tenant_id,
aad_object_id=activity.from_.aad_object_id if activity.from_ else None,
team_id=activity.channel_data.team_id if activity.channel_data else None,
channel_ref_id=activity.channel_data.channel_id if activity.channel_data else None,
thread_id=activity.reply_to_id if activity.is_channel_thread else None,
locale=activity.locale,
)
async def save_conversation_reference(
store: ConversationStore,
activity: BotFrameworkActivity,
bot_app_id: str,
) -> None:
ref = await build_conversation_reference(activity, bot_app_id)
store.set(ref)
async def send_proactive_text(
adapter: BotFrameworkAdapter,
store: ConversationStore,
conversation_id: str,
text: str,
*,
reply_to_id: str | None = None,
) -> list[str]:
ref = store.get(conversation_id)
if not ref:
raise ValueError(f"No conversation reference for: {conversation_id}")
return await send_text(adapter, ref, text, reply_to_id=reply_to_id)
async def send_proactive_media(
adapter: BotFrameworkAdapter,
store: ConversationStore,
conversation_id: str,
media_url: str,
media_type: str,
*,
name: str = "",
) -> str:
ref = store.get(conversation_id)
if not ref:
raise ValueError(f"No conversation reference for: {conversation_id}")
return await send_media(adapter, ref, media_url, media_type, name=name)