Teams Delegate

让智能体代您管理 Microsoft Teams 收件箱：读取消息、草拟回复、发送消息——同时准确识别发信人身份，并判断哪些内容真正需要您的关注。

初始化配置（仅需一次）

1. 在 https://portal.azure.com 注册一个 Azure 应用： → Azure Active Directory → 应用注册 → 新建注册

   • 平台类型：移动和桌面应用（启用设备代码流）
   • 在“身份验证”设置中，向下滚动至“高级设置”，将“允许公共客户端流”设为“是”（设备代码流必需）
   • 注意：请使用旧版 Azure 门户体验——若页面顶部黄色横幅中出现“切换到旧版体验”，请先点击该链接
   • 添加 API 权限：Chat.Read、Chat.ReadWrite、ChannelMessage.Read.All、ChannelMessage.Send、Presence.Read.All、User.Read
   • 若处于企业租户环境，请管理员授予同意

2. 保存客户端 ID：

   python3 scripts/auth.py --client-id YOUR_CLIENT_ID
   

3. 执行认证：

   python3 scripts/auth.py
   

   按提示完成设备代码流程。获取的访问令牌将保存至 ~/.teams-delegate/token.json，并支持自动刷新。

核心命令

python3 scripts/teams.py inbox          # 列出近期聊天会话及预览内容
python3 scripts/teams.py read   # 读取完整对话历史
python3 scripts/teams.py reply  "message"  # 发送回复
python3 scripts/teams.py summary        # 导出所有待处理聊天，供智能体审阅

智能体工作流

检查收件箱

1. 运行 summary 命令，一次性获取全部近期对话
2. 对每条消息进行分类：
   • 由智能体处理：确认类消息（如“收到”、“已知晓”）、日程确认、简单状态更新等
   • 需人工介入：涉及决策、敏感话题、用户明确要求亲自查看的内容，或来自上级的紧急/高优先级消息
3. 对于智能体可处理的消息：草拟回复 → 执行 reply 命令发送
4. 对于需人工介入的消息：生成摘要并呈现给用户

草拟回复

• 匹配当前对话语境的语气（例如：一对一私聊偏随意，频道消息偏正式）
• 保持简洁——Teams 是即时通讯工具，不是电子邮件系统
• 若代表他人回复，请勿冒充其身份；仅在上下文明确要求时，以助理身份代为撰写
• 检查 importance 字段——来自管理人员的紧急消息必须立即升级通知用户

自动回复模式

当用户发出“帮我处理 Teams 消息”或“我离线期间自动回复”等指令时：

1. 每隔 N 分钟运行一次 summary（可通过 cron 或心跳机制实现）
2. 应用上述分类规则
3. 自动发送已批准的回复
4. 完整记录所有操作：发送内容、接收人、时间戳
5. 对任何标记为“需人工介入”的消息，及时向用户发出提醒

优先级规则（默认策略，用户可覆盖）

• 标记为 urgent 的消息 → 始终升级通知用户
• 来自指定 VIP（如直属上级、关键客户）的消息 → 仅草拟回复，等待用户审批后方可发送
• 群组聊天消息 → 优先级较低，仅在被直接 @提及 时才回复
• 频道消息 → 默认仅生成摘要，除非被 @提及

Graph API 参考文档

完整端点说明、授权范围（auth scopes）及速率限制详情，请参阅 references/graph-api.md。

作者

由 Nate Teshome 开发 — @takeovernat

网站：stellarsitesai.com
GitHub：github.com/takeovernat

发现 Bug 或希望参与贡献？欢迎在 GitHub 提交 Issue 或 Pull Request。