新增 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: 类型定义
164 lines
4.9 KiB
Python
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
|