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

164 lines
4.9 KiB
Python

from __future__ import annotations
import asyncio
import logging
import time
from .sdk import BotFrameworkAdapter, build_message_activity, build_typing_activity
from .types import StoredConversationReference
logger = logging.getLogger(__name__)
TEAMS_HTTP_STREAM_THROTTLE_MS = 1500
TEAMS_HTTP_STREAM_TIMEOUT_S = 45
class MSTeamsStreaming:
streaming_mode = "block"
block_streaming_enabled = True
block_streaming_chunk_min_chars = 1500
block_streaming_chunk_max_chars = 4000
block_streaming_chunk_break_preference = "paragraph"
block_streaming_coalesce_defaults = {
"min_chars": 1500,
"max_chars": 4000,
"idle_ms": 1000,
}
teams_http_stream_enabled = False
teams_http_stream_throttle_ms = TEAMS_HTTP_STREAM_THROTTLE_MS
teams_http_stream_timeout_s = TEAMS_HTTP_STREAM_TIMEOUT_S
def create_block_chunker(self) -> dict:
return {
"mode": "length",
"min_chars": self.block_streaming_chunk_min_chars,
"max_chars": self.block_streaming_chunk_max_chars,
}
def create_stream_session(self, target_id: str) -> dict:
return {
"target_id": target_id,
"mode": "block",
"chunks_sent": 0,
}
class TeamsHttpStreamSession:
def __init__(
self,
adapter: BotFrameworkAdapter,
ref: StoredConversationReference,
*,
throttle_ms: int = TEAMS_HTTP_STREAM_THROTTLE_MS,
timeout_s: int = TEAMS_HTTP_STREAM_TIMEOUT_S,
):
self._adapter = adapter
self._ref = ref
self._throttle_ms = throttle_ms
self._timeout_s = timeout_s
self._message_id: str | None = None
self._last_update: float = 0.0
self._last_text: str = ""
self._start_time: float = 0.0
self._finished: bool = False
self._cancelled: bool = False
@property
def message_id(self) -> str | None:
return self._message_id
@property
def finished(self) -> bool:
return self._finished
async def start(self, initial_text: str = "") -> str:
activity = {
"type": "message",
"text": initial_text or "...",
"textFormat": "markdown",
}
if self._ref.tenant_id:
activity.setdefault("channelData", {})
activity["channelData"]["tenant"] = {"id": self._ref.tenant_id}
result = await self._adapter.send_activity(self._ref, activity)
self._message_id = result.get("id", "")
self._last_text = initial_text
self._start_time = time.monotonic()
return self._message_id
async def update(self, text: str) -> bool:
if self._cancelled or self._finished:
return False
if time.monotonic() - self._start_time > self._timeout_s:
logger.warning("TeamsHttpStream timeout (%ds), falling back to block streaming", self._timeout_s)
self._cancelled = True
return False
if len(text) <= len(self._last_text):
return True
if not text.startswith(self._last_text):
logger.debug("TeamsHttpStream prefix constraint violated, falling back")
self._cancelled = True
return False
elapsed = (time.monotonic() - self._last_update) * 1000
if elapsed < self._throttle_ms:
await asyncio.sleep((self._throttle_ms - elapsed) / 1000.0)
if not self._message_id:
return False
activity = build_message_activity(text, tenant_id=self._ref.tenant_id, ai_generated=True)
try:
await self._adapter.update_activity(
self._ref.service_url,
self._ref.conversation_id,
self._message_id,
activity,
)
self._last_text = text
self._last_update = time.monotonic()
return True
except Exception as e:
logger.warning("TeamsHttpStream update failed: %s", e)
self._cancelled = True
return False
async def finish(self, final_text: str) -> bool:
if self._cancelled:
return False
activity = build_message_activity(final_text, tenant_id=self._ref.tenant_id, ai_generated=True)
try:
await self._adapter.update_activity(
self._ref.service_url,
self._ref.conversation_id,
self._message_id,
activity,
)
self._finished = True
return True
except Exception as e:
logger.warning("TeamsHttpStream finish failed: %s", e)
return False
async def cancel(self) -> None:
self._cancelled = True
async def send_streaming_typing(
adapter: BotFrameworkAdapter,
ref: StoredConversationReference,
) -> None:
try:
activity = build_typing_activity()
await adapter.send_activity(ref, activity)
except Exception:
pass