2026年4月9日：AI日程助手核心技术，从概念原理到代码示例与面试考点

import json
from datetime import datetime
from typing import List, Dict

 ========== 1. 定义工具函数（模拟日历API） ==========

class MockCalendarAPI:
    """模拟日历API，实际开发可替换为Google Calendar/Outlook真实接口"""
    
    def __init__(self):
        self.events: List[Dict] = []
    
    def create_event(self, title: str, start_time: str, end_time: str, 
                     attendees: List[str] = None) -> Dict:
        """创建日程事件"""
        event = {
            "id": len(self.events) + 1,
            "title": title,
            "start": start_time,
            "end": end_time,
            "attendees": attendees or [],
            "created_at": datetime.now().isoformat()
        }
        self.events.append(event)
        return event
    
    def query_events(self, date: str = None) -> List[Dict]:
        """查询日程事件"""
        if date:
            return [e for e in self.events if date in e["start"]]
        return self.events

 ========== 2. 定义工具描述（供LLM识别） ==========

TOOLS = [
    {
        "type": "function",
        "function": {
            "name": "create_calendar_event",
            "description": "在日历中创建一个新的事件/会议/日程",
            "parameters": {
                "type": "object",
                "properties": {
                    "title": {"type": "string", "description": "事件标题"},
                    "start_time": {"type": "string", "description": "开始时间，格式YYYY-MM-DD HH:MM"},
                    "end_time": {"type": "string", "description": "结束时间"},
                    "attendees": {"type": "array", "items": {"type": "string"}, "description": "参与者邮箱列表"}
                },
                "required": ["title", "start_time", "end_time"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "query_calendar_events",
            "description": "查询指定日期的日程事件",
            "parameters": {
                "type": "object",
                "properties": {
                    "date": {"type": "string", "description": "查询日期，格式YYYY-MM-DD"}
                },
                "required": ["date"]
            }
        }
    }
]

 ========== 3. LLM意图识别与工具调用模拟 ==========

def simulate_llm_intent(user_input: str):
    """
    模拟LLM的意图识别和工具调用决策。
    实际生产中这里会调用OpenAI/Anthropic等LLM API。
    """
     识别关键词
    if "创建" in user_input or "添加" in user_input or "安排" in user_input:
         模拟从自然语言中提取信息
         实际场景中LLM会解析用户输入，填充参数
        return {
            "should_call": True,
            "function_name": "create_calendar_event",
            "arguments": {
                "title": user_input.split("会议")[0] if "会议" in user_input else "未命名事件",
                "start_time": "2026-04-10 14:00",
                "end_time": "2026-04-10 15:00",
                "attendees": ["colleague@company.com"]
            }
        }
    elif "查询" in user_input or "查看" in user_input:
        return {
            "should_call": True,
            "function_name": "query_calendar_events",
            "arguments": {"date": "2026-04-10"}
        }
    else:
        return {"should_call": False, "response": "请告诉我想创建还是查询日程"}

 ========== 4. 主流程：LLM决策 + 工具执行 ==========

def ai_scheduling_assistant(user_input: str, calendar_api: MockCalendarAPI):
    """AI日程助手主流程"""
    print(f"👤 用户: {user_input}")
    
     Step 1: LLM理解意图并决定是否调用工具
    intent = simulate_llm_intent(user_input)
    
    if not intent["should_call"]:
        print(f"🤖 AI: {intent['response']}")
        return
    
     Step 2: 根据函数名执行对应工具
    if intent["function_name"] == "create_calendar_event":
        result = calendar_api.create_event(intent["arguments"])
        print(f"✅ 已创建日程: {result['title']} at {result['start']}")
        print(f"📅 参与者: {', '.join(result['attendees'])}")
    
    elif intent["function_name"] == "query_calendar_events":
        events = calendar_api.query_events(intent["arguments"])
        if events:
            print(f"📋 查询到 {len(events)} 个日程:")
            for e in events:
                print(f"   - {e['title']}: {e['start']} ~ {e['end']}")
        else:
            print("📭 当天暂无日程安排")

 ========== 5. 运行示例 ==========

if __name__ == "__main__":
    calendar = MockCalendarAPI()
    
     示例1：创建日程
    ai_scheduling_assistant("明天下午2点和同事开项目会议", calendar)
    print("-"  50)
    
     示例2：查询日程
    ai_scheduling_assistant("查询明天有什么日程", calendar)