能在 Outlook 里约会议的网站聊天助手

能在 Outlook 里约会议的网站聊天助手

一个放在网站聊天组件后面的 n8n 工作流。一个用 OpenAI gpt-4o-2024-08-06 的 AI 智能体和每位访客聊天，查看你 Outlook 日历里的空闲时间，并预约一场 30 分钟的 Teams 会议。访客还没准备好预约时，智能体收集信息，把咨询用邮件发给你。

包里有什么

• workflow.json：n8n 导出的工作流，22 个节点。十七个干活，五个是便签：一个标题，加四条简短的提醒，提醒你把工具指向这个工作流、改营业时间和时区、改邮件。里面没有任何凭据。
• README.md：这份设置说明，压缩包里的是英文版。

我们相对原来的副本改了什么

• 两个工具节点 Get Availability 和 Send Message 原来按 ID 调用作者自己 n8n 里的一个工作流。这个 ID 已清空。它们应当调用的是这同一个工作流，它下面一行会回应它们：先保存一次，再在每个节点里选中它。
• AI Agent 的系统消息原来写着它的作者、作者的公司以及公司做什么。现在这些是 <OWNER_NAME>、<OWNER_ROLE>、<YOUR_COMPANY> 和 <WHAT_YOUR_COMPANY_DOES>。
• Send Message1 的收件人原来是一个示例邮箱。现在是 <YOUR_EMAIL_ADDRESS>。
• 两张链接到作者博客文章和设置视频的便签已删掉，标题便签现在只剩标题。它原来带的链接和署名都没了。
• 所有 Outlook 和 OpenAI 的凭据关联以及聊天的 webhookId 都删掉了。文件原来没有设置块，所以现在把执行顺序设为当前的 v1。
• Make Appointment 和 Get Events 里 Outlook 凭据的类型名有一个字母写成了 JSON 转义（\u0041）。n8n 把它读成同一个名字。否则商店的密钥检查会把这个长名字当成密钥。
• 别的都没改。提示词的规则、工具、记忆和布局都是文件原有的。

开始之前

• 一个 n8n 实例，n8n Cloud 或自己的服务器都行，而且你的网站要能访问到它。
• 一个 OpenAI API 密钥，用于 OpenAI 凭据。
• 一个带 Outlook 的微软账号。Microsoft Outlook OAuth2 凭据的默认权限范围包括日历的读写和邮件的发送。
• 你网站上一个可以加上 n8n 嵌入式聊天组件的页面。

设置

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。保存一次，这样 n8n 会给它一个 ID。
2. 添加一个 OpenAI 凭据，在 OpenAI Chat Model 里选中它。
3. 添加一个 Microsoft Outlook OAuth2 凭据。在 Make Appointment、Get Events 和 Send Message1 里选中它。
4. 在 Get Availability 和 Send Message 里，打开 Workflow 栏，从列表里选这同一个工作流。
5. 打开 AI Agent，把它系统消息里的每个占位符填好：<OWNER_NAME>、<OWNER_ROLE>、<YOUR_COMPANY> 和 <WHAT_YOUR_COMPANY_DOES>。顺便读一读它的时间段、提前通知时间和时区。
6. 在 Send Message 里，替换工具说明里的 <insert name>。在 Make Appointment 里，替换它的工具说明里的 <timezone>。在 Send Message1 里，把 <YOUR_EMAIL_ADDRESS> 换成要收咨询的邮箱。
7. 在 freeTimeSlots 里设好你的营业时间。如果你在别的时区工作，就改 Get Events 和 Make Appointment 里的 Europe/London。
8. 保存，然后在 n8n 自己的聊天窗口里，用你自己的姓名和邮箱试一试聊天。
9. 点 Publish。把 n8n 的聊天组件加到你的网站上，指向 Chat Trigger 的正式地址。

一次运行的过程

1. Chat Trigger（嵌入式聊天，公开，允许所有来源）接收每条访客消息和一个会话 ID。
2. If 检查 chatInput 是否存在。没有文字的调用交给 Respond With Initial Message，它回答“Hi, how can I help you today?”。其余的都交给 AI Agent。
3. AI Agent（1.6 版）用 OpenAI Chat Model（gpt-4o-2024-08-06，温度 0.4）和 Window Buffer Memory，后者为每个会话保留最近 20 轮互动。它的系统消息设定了角色、30 分钟的会议、48 小时的提前通知、工作日的办公时间，以及只谈预约的规则。
4. 智能体有三个工具。Get Availability 和 Send Message 用一个 route 值调用这个工作流，Make Appointment 则自己向微软的日历发 POST。
5. 在下面一行里，Execute Workflow Trigger 把调用交给 Switch，它读取 route。
   - availability 走向 Get Events，它向微软的 calendarView 要未来第 2 天到第 16 天的日程，再交给 freeTimeSlots，一个 Code 节点，列出营业时间内的空闲时段。varResponse 把这份列表还给智能体。
   - message 走向 Send Message1，一个 Outlook 节点，用高重要性给你发一封排好版的咨询邮件。varMessageResponse 告诉智能体邮件已发出。
6. Make Appointment 创建一个事件，访客是必需参会人，带一个 Teams 会议链接，原因写在正文里。Respond to Webhook 把智能体的回答返回给聊天。

改变风格

• 声音和规则：AI Agent 的系统消息。
• 营业时间：freeTimeSlots 里的 businessHoursStart 和 businessHoursEnd。它们是 UTC，提示词里也写了时间段，所以两处都要改。
• 时区：Make Appointment、Get Events 和提示词里的 Europe/London。
• 提前通知和时长：提示词里的规则，以及 Make Appointment 里的 dateEndTime，它规定在开始后 30 分钟结束。
• 查看的天数：Get Events 里的两个日期表达式。
• 问候语：Respond With Initial Message。
• 咨询邮件：主题来自聊天，版式在 Send Message1 的 HTML 里。
• 模型：OpenAI Chat Model。
• 聊天的外观：在你网站上的组件里设置，不在这个文件里。

注意事项

• 智能体根据陌生人输入的内容预约真实的会议。访客的邮箱会进入事件的参会人名单，所以任何人都可以输入一个地址，向它发出邀请。先用你自己的日历测试。
• Chat Trigger 是公开的，允许所有来源。把允许的来源限制在你的网站上，能挡住别的网页，挡不住脚本，所以要盯着你的 OpenAI 花费。
• freeTimeSlots 把它的时间段当作 UTC，而提示词说的是伦敦时间。它只列出已经有事件的日子，所以日历空着的一天永远不会被提供。有事件但没有一个标为忙碌的日子会让代码报错停下，因为它要读这一天的第一个忙碌事件，而这一天没有。
• Get Events 最多请求 50 个事件，不会去翻后面的页。
• 事件的主题是字面文字 Meetings with <name> at <company>。要从聊天里填入，就写 {name}，再给工具加一个 company 占位符。
• 提示词里的当前伦敦时间用一个表达式写成，在秒后面以 :00.000Z 结尾。它不是规整的 ISO 时间，夏天 Z 也代表 UTC。
• OpenAI 的弃用页面（2026 年 11 月 12 日查阅）给出 gpt-4o-2024-08-06 将于 2027 年 1 月 14 日关停，替代是 gpt-6-luna。
• 每条访客消息至少是一次 OpenAI 调用，工具运行时更多。
• 聊天消息会发给 OpenAI，访客的信息会发给微软。智能体看到的是空闲时段，不是你的事件标题。
• 文件里没有任何凭据和密钥。