Microsoft Teams 触发器

概览

使用 Microsoft Teams 触发器，在新聊天创建时启动自动化。常见模式包括汇总传入请求、将紧急消息路由给支持团队，或在其他系统中创建后续任务。

Tip

请确认 Microsoft Teams 已在 Tools & Integrations 中连接，并且已在该部署的 Triggers 选项卡中启用。

启用 Microsoft Teams 触发器

1. 在 CrewAI AMP 中打开你的部署
2. 前往 Triggers 选项卡
3. 找到 Microsoft Teams 并切换开关以启用

Microsoft Teams 触发器连接

示例：汇总新聊天线程

from teams_chat_created_crew import MicrosoftTeamsChatTrigger

crew = MicrosoftTeamsChatTrigger().crew()
result = crew.kickoff({
    "crewai_trigger_payload": teams_payload,
})
print(result.raw)

crew 会解析线程元数据（主题、创建时间、成员列表），并为接收团队生成行动计划。

本地测试

使用 CrewAI CLI 在本地测试你的 Microsoft Teams 触发器集成：

# 查看所有可用触发器
crewai triggers list

# 使用真实感 payload 模拟 Microsoft Teams 触发器
crewai triggers run microsoft_teams/teams_message_created

crewai triggers run 命令会使用完整的 Teams payload 执行你的 crew，从而让你在部署前测试解析逻辑。

Warning

在开发过程中请使用 crewai triggers run microsoft_teams/teams_message_created（而不是 crewai run）来模拟触发器执行。部署后，你的 crew 会自动接收触发 payload。

故障排查

• 确保 Teams 连接处于活动状态；如果租户撤销了权限，连接必须刷新
• 使用 crewai triggers run microsoft_teams/teams_message_created 在本地测试，以查看准确的 payload 结构
• 如果 payload 停止到达，请确认 Microsoft 365 中的 webhook 订阅仍然有效
• 如果 chat 为私密或受限，Graph 通知可能会省略某些字段，请查看执行日志以排查 payload 形状不匹配的问题
• 记住：使用 crewai triggers run（而不是 crewai run）来模拟触发器执行