87 lines
2.3 KiB
Python
87 lines
2.3 KiB
Python
|
"""Microsoft Teams 欢迎卡片。
|
|||
|
|
|
|||
|
|
在 Bot 被添加到个人或群组对话时发送欢迎卡片，支持自定义 prompt starters。
|
|||
|
|
"""
|
|||
|
|
|
|||
|
|
from __future__ import annotations
|
|||
|
|
|
|||
|
|
from typing import Any
|
|||
|
|
|
|||
|
|
|
|||
|
|
def build_personal_welcome_card(
|
|||
|
|
bot_name: str = "ForcePilot",
|
|||
|
|
subtitle: str = "你好！我是你的智能助手，可以帮你回答问题、处理数据、管理任务。",
|
|||
|
|
prompt_starters: list[str] | None = None,
|
|||
|
|
) -> dict[str, Any]:
|
|||
|
|
starters = prompt_starters or [
|
|||
|
|
"你能做什么？",
|
|||
|
|
"帮我总结今天的要点",
|
|||
|
|
"查看我的会话上下文",
|
|||
|
|
]
|
|||
|
|
|
|||
|
|
body: list[dict[str, Any]] = [
|
|||
|
|
{
|
|||
|
|
"type": "TextBlock",
|
|||
|
|
"size": "Large",
|
|||
|
|
"weight": "Bolder",
|
|||
|
|
"text": f"欢迎使用 {bot_name}",
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
"type": "TextBlock",
|
|||
|
|
"text": subtitle,
|
|||
|
|
"wrap": True,
|
|||
|
|
"spacing": "Medium",
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
"type": "TextBlock",
|
|||
|
|
"text": "试试这些：",
|
|||
|
|
"spacing": "Medium",
|
|||
|
|
"isSubtle": True,
|
|||
|
|
},
|
|||
|
|
]
|
|||
|
|
|
|||
|
|
for i, starter in enumerate(starters[:3]):
|
|||
|
|
body.append(
|
|||
|
|
{
|
|||
|
|
"type": "TextBlock",
|
|||
|
|
"text": f"{i + 1}. {starter}",
|
|||
|
|
"wrap": True,
|
|||
|
|
"spacing": "Small",
|
|||
|
|
}
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
return {
|
|||
|
|
"type": "AdaptiveCard",
|
|||
|
|
"version": "1.5",
|
|||
|
|
"body": body,
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
|
|||
|
|
def build_group_welcome_message(bot_name: str = "ForcePilot") -> str:
|
|||
|
|
return (
|
|||
|
|
f"大家好！我是 **{bot_name}**，已加入此对话。\n\n"
|
|||
|
|
"你可以 @提及 我或直接向我发送消息来获得帮助。\n\n"
|
|||
|
|
"发送 `/help` 查看可用命令。"
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
|
|||
|
|
def build_welcome_response(
|
|||
|
|
conversation_type: str,
|
|||
|
|
bot_name: str,
|
|||
|
|
prompt_starters: list[str] | None = None,
|
|||
|
|
) -> dict[str, Any]:
|
|||
|
|
if conversation_type == "personal":
|
|||
|
|
card = build_personal_welcome_card(
|
|||
|
|
bot_name=bot_name,
|
|||
|
|
prompt_starters=prompt_starters,
|
|||
|
|
)
|
|||
|
|
return {
|
|||
|
|
"type": "card",
|
|||
|
|
"content": f"欢迎使用 {bot_name}",
|
|||
|
|
"adaptive_card": card,
|
|||
|
|
}
|
|||
|
|
return {
|
|||
|
|
"type": "text",
|
|||
|
|
"content": build_group_welcome_message(bot_name),
|
|||
|
|
}
|