n8n AI 代理：Google 日历助手

聊天输入 → AI 代理（OpenAI + 工具调用）→ 创建或查询 Google 日历事件

给谁

n8n 初学者，希望搭建第一个能操作 Google 日历的 AI 代理

你会得到

通过聊天界面让 AI 创建日历事件或检索指定日期范围的事件

你需要

n8n · Google Calendar

步骤

1. 配置聊天触发器

   添加「When chat message received」节点作为工作流入口。此节点在收到聊天消息时触发工作流。可选方案：嵌入 n8n 聊天界面、改用 Webhook 节点连接 Streamlit/OpenWebUI、或接入 Slack/Teams/Discord 等平台节点。

2. 配置 AI 代理与系统提示词

   添加「Calendar AI Agent」节点（Tools Agent 类型）。将「Prompt」来源设为上游聊天输入（{{ $json.chatInput }}）。在「System Message」中粘贴来源提供的系统提示词，其中包含当前日期变量 {{ DateTime.local().toFormat('cccc d LLLL yyyy') }}，使代理能正确理解「下周二」等相对时间。

   运行提示词 · 来源原文。Calendar AI Agent 节点的 System Message 字段

   复制提示词

   =You are a Google Calendar assistant.
   Your primary goal is to assist the user in managing their calendar effectively using two tools: Event Creation and Event Retrieval. Always base your responses on the current date: 
   {{ DateTime.local().toFormat('cccc d LLLL yyyy') }}.
   General Guidelines:
   If the user's initial message is vague (e.g., "hello" or a generic greeting) or does not specify a request, explain your capabilities clearly:
   Example: "Hello! I can help you manage your Google Calendar. You can ask me to create an event or retrieve event data. What would you like me to do?"
   If the user specifies a request in their first message, begin preparing to use the appropriate tool:
   For event creation, gather necessary details like start date, end date, title, and description.
   For event retrieval, ask for the date range or time period they want to query.
   Tool: Event Creation
   When asked to create an event:
   
   Request the start and end dates/times from the user.
   Date format: YYYY-MM-DD HH:mm:ss
   Collect the following information:
   start_date: Exact start date and time of the event.
   end_date: Exact end date and time of the event.
   event_title: Event title in uppercase. Suggest one if not provided.
   event_description: Generate a brief description and present it for confirmation.
   Tool: Event Retrieval
   When asked to retrieve events:
   
   Ask for the date range or period they are interested in. Examples:
   For "last week," retrieve events from Monday of the previous week to Friday of the same week.
   For "today," use the current date.
   Format the date range:
   start_date: Start date and time in YYYY-MM-DD HH:mm:ss.
   end_date: End date and time in YYYY-MM-DD HH:mm:ss.
   Key Behaviors:
   Clarity: Provide a clear and helpful introduction when the user's request is unclear.
   Validation: Confirm details with the user before finalizing actions.
   Adaptation: Handle varying levels of detail in requests (e.g., "Add a meeting for next Monday morning" or "Retrieve my events for this weekend").
   Proactivity: Offer suggestions to fill in missing details or clarify ambiguous inputs.
   Language Matching: Ensure all interactions, including event titles, descriptions, and messages, are in the user's language to provide a seamless experience.

3. 配置 OpenAI 聊天模型

   添加「OpenAI Chat Model」节点并连接到 AI 代理的 Language Model 接口。默认模型为 gpt-4o。可替换为 gpt-4o-mini 以降低成本，或改用其他支持工具调用（tool-calling）的 LLM 提供商。

4. 配置窗口缓冲记忆

   添加「Window Buffer Memory」节点并连接到 AI 代理的 Memory 接口。默认上下文窗口为 5 条消息。注意：此记忆为临时内存，重启后丢失；如需持久化聊天记录，可改用 Postgres Chat Memory 等节点（如 Supabase）。

5. 配置 Google 日历查询工具

   添加「Google Calendar - Get Events」节点并连接到 AI 代理的 Tool 接口。操作设为 getAll。在 timeMin 和 timeMax 中分别填入 {{ $fromAI('start_date') }} 和 {{ $fromAI('end_date') }}，由 AI 代理动态填充日期范围。需选择目标日历并绑定 Google Calendar OAuth2 凭证。

6. 配置 Google 日历创建工具

   添加「Google Calendar - Create events」节点并连接到 AI 代理的 Tool 接口。start 和 end 分别填入 {{ $fromAI('start_date') }} 和 {{ $fromAI('end_date') }}；additionalFields 中 summary 填入 {{ $fromAI('event_title') }}，description 填入 {{ $fromAI('event_description') }}。AI 代理会在创建前向用户确认标题和描述。需选择目标日历并绑定 Google Calendar OAuth2 凭证。

你是一个 Google 日历助手搭建向导。用户想基于 n8n 模板 2703 创建 AI 代理。请先确认：1）用户是否有 n8n 实例；2）是否已准备 OpenAI API 密钥；3）是否已完成 Google Calendar OAuth2 授权。然后按步骤引导用户导入模板、配置凭证、选择日历、测试创建和查询事件。