AI日程助手搭建实战：2026年从零构建你的智能日程管家

 传统手动日程管理：纯硬编码，不具备智能化
def add_task_manually():
     每次添加日程都需要用户手动输入所有字段
    title = input("请输入事件名称：")
    start_time = input("请输入开始时间（格式：YYYY-MM-DD HH:MM）：")
    end_time = input("请输入结束时间（格式：YYYY-MM-DD HH:MM）：")
    
     冲突检测需要手动检查
    for existing in load_all_tasks():
        if (start_time < existing['end'] and end_time > existing['start']):
            print(f"⚠️ 冲突：与任务'{existing['title']}'时间重叠，请手动调整")
            return
    
     手动保存到数据库
    save_to_database({"title": title, "start": start_time, "end": end_time})
    print("✅ 任务添加成功")

用户："明天下午三点和产品团队开会，时长90分钟，并提醒我准备材料"

Agent内部执行流程：
┌─────────────────────────────────────────────────┐
│ 1. Thought（思考）：需要先检查日历，再创建事件   │
│ 2. Action（行动）：check_calendar_conflict()     │
│ 3. Observation（观察）：日历该时段空闲           │
│ 4. Thought（继续）：可创建事件，设置提醒         │
│ 5. Action（执行）：create_calendar_event()       │
│ 6. Observation：事件创建成功                     │
│ 7. Output（输出）：“已为您创建会议并设置提醒”    │
└─────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────┐
│                 AI日程助手全景图                      │
├──────────────────────────────────────────────────────┤
│                                                        │
│   ┌─────────────────────────────────────────────┐    │
│   │                AI Agent（大脑）              │    │
│   │         任务规划 · 记忆管理 · 决策迭代        │    │
│   └─────────────────────┬───────────────────────┘    │
│                         │ 调用                         │
│                         ▼                              │
│   ┌─────────────────────────────────────────────┐    │
│   │          Function Calling（神经链路）         │    │
│   │             意图识别 · 参数提取 · 执行分发      │    │
│   └─────────────────────┬───────────────────────┘    │
│                         │                              │
│         ┌───────────────┼───────────────┐             │
│         ▼               ▼               ▼             │
│   ┌──────────┐   ┌──────────┐   ┌──────────────┐     │
│   │ 日历API  │   │ 邮件API  │   │   RAG知识库   │     │
│   └──────────┘   └──────────┘   └──────────────┘     │
│                                                        │
│   🧠 底层优化：CoS / TDSA / 强化学习（PEARL框架）      │
└──────────────────────────────────────────────────────┘

import json
from datetime import datetime
from typing import List, Dict, Optional
from openai import OpenAI

 初始化OpenAI客户端
client = OpenAI(api_key="your-api-key")

 日程数据存储（生产环境需替换为数据库）
tasks_db: List[Dict] = []

 ========== 步骤1：定义函数Schema ==========
tools = [
    {
        "type": "function",
        "function": {
            "name": "create_calendar_event",
            "description": "创建日历事件，会自动检测时间冲突",
            "parameters": {
                "type": "object",
                "properties": {
                    "title": {"type": "string", "description": "事件标题"},
                    "start_time": {"type": "string", "format": "iso8601", 
                                   "description": "开始时间，格式YYYY-MM-DDTHH:MM:SS"},
                    "duration": {"type": "integer", "description": "持续时间（分钟）", "default": 60}
                },
                "required": ["title", "start_time"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "query_today_tasks",
            "description": "查询今日所有日程",
            "parameters": {"type": "object", "properties": {}, "required": []}
        }
    }
]

 ========== 步骤2：实现函数逻辑 ==========
def create_calendar_event(title: str, start_time: str, duration: int = 60) -> Dict:
    """创建日历事件，带冲突检测"""
    start = datetime.fromisoformat(start_time)
    end = datetime.fromisoformat(start_time.replace('Z', '+00:00')) 
    end = end.replace(hour=start.hour, minute=start.minute + duration) if duration else start
    
     冲突检测核心逻辑
    for existing in tasks_db:
        existing_start = datetime.fromisoformat(existing['start_time'])
        existing_end = datetime.fromisoformat(existing['end_time'])
        
        if (start < existing_end and end > existing_start):
            return {
                "status": "conflict",
                "message": f"时间冲突！与已有事件'{existing['title']}'重叠",
                "conflict_with": existing['title']
            }
    
     无冲突则保存
    new_event = {
        "title": title,
        "start_time": start.isoformat(),
        "end_time": end.isoformat(),
        "created_at": datetime.now().isoformat()
    }
    tasks_db.append(new_event)
    return {"status": "success", "message": f"✅ 已创建事件：{title}", "event": new_event}

def query_today_tasks() -> Dict:
    """查询今日日程"""
    today = datetime.now().date()
    today_tasks = [t for t in tasks_db 
                   if datetime.fromisoformat(t['start_time']).date() == today]
    return {"status": "success", "count": len(today_tasks), "tasks": today_tasks}

 函数映射表
available_functions = {
    "create_calendar_event": create_calendar_event,
    "query_today_tasks": query_today_tasks,
}

def chat_with_assistant(user_input: str) -> str:
    """与AI日程助手对话"""
    messages = [{"role": "user", "content": user_input}]
    
     第一次调用：模型决定是否调用函数
    response = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=messages,
        tools=tools,
        tool_choice="auto"
    )
    
    response_message = response.choices[0].message
    tool_calls = response_message.tool_calls
    
     如果有函数调用请求
    if tool_calls:
        messages.append(response_message)   将助手响应加入对话历史
        
        for tool_call in tool_calls:
            function_name = tool_call.function.name
            function_args = json.loads(tool_call.function.arguments)
            
             执行对应函数
            if function_name in available_functions:
                function_response = available_functions[function_name](function_args)
                messages.append({
                    "tool_call_id": tool_call.id,
                    "role": "tool",
                    "name": function_name,
                    "content": json.dumps(function_response)
                })
        
         第二次调用：模型基于函数结果生成最终回复
        final_response = client.chat.completions.create(
            model="gpt-4o-mini",
            messages=messages
        )
        return final_response.choices[0].message.content
    
    return response_message.content

 运行示例
if __name__ == "__main__":
     示例1：自然语言创建日程
    print(chat_with_assistant("帮我安排明天下午3点的项目复盘会，预计1小时"))
     输出：✅ 已创建事件：项目复盘会
    
     示例2：冲突检测
    print(chat_with_assistant("明天下午3点再安排一个面试"))
     输出：时间冲突！与已有事件'项目复盘会'重叠
    
     示例3：查询今日日程
    print(chat_with_assistant("我今天有什么安排"))