Day 1：搭骨架，先跑起来

为什么这是最重要的第一天

很多教程一上来就给你扔几十个文件、一堆配置、import了一堆你听都没听过的库。你复制粘贴了半小时，终于开始跑——报错了。然后你在StackOverflow和GPT之间来回跳，修bug修到怀疑人生。

我们反着来。

今天的Agent不会任何AI。你说"你好"，它回"你好"。听起来很蠢？但它是能跑的。 它验证了：Python装好了、文件结构没问题、你理解了最基本的函数调用。这比任何"看起来高级但跑不起来的代码"都有价值。

地基错了，上面盖什么都塌。地基对了，后面每天加一块砖，第七天就是一座房子。

你需要什么

• Python 3.10+（第2章装过了）
• 一个文本编辑器（VSCode、PyCharm都行）
• 一个终端
• 不需要API Key、不需要联网、不需要花钱

📦 本项目全程使用的框架版本：

框架	版本	首次用到
langchain	≥0.3	Day 2
langchain-community	≥0.3	Day 3
chromadb	≥0.5	Day 3
langgraph	≥0.2	Day 5
mcp	0.9.x	Day 6
fastapi	≥0.100	Day 7
uvicorn	≥0.20	Day 7

每天会在对应章节给出具体安装命令，不用第一天全部装完。

今天做什么

今天只做一件事：让程序跑起来。 写一个最简单的Python函数——收消息，回消息。不涉及任何AI。

代码

创建一个文件夹 customer_service_agent，在里面创建 day1.py：

📁 代码目录

customer_service_agent/
└── day1.py        ← 唯一一个文件，10行

# day1.py — 整个文件就这一个

def simple_agent(user_message: str) -> str:
    """
    最简单的Agent骨架。
    目前什么都不做——你说什么，它回什么。
    但它是能跑的。这就是一切的基础。
    """
    return f"客服收到：{user_message}"

if __name__ == "__main__":
    # 模拟几次用户对话
    test_messages = [
        "你好",
        "我的订单什么时候到？",
        "谢谢"
    ]
    
    for msg in test_messages:
        response = simple_agent(msg)
        print(f"👤 用户: {msg}")
        print(f"🤖 客服: {response}")
        print()

运行

python day1.py

你应该看到：

👤 用户: 你好
🤖 客服: 客服收到：你好

👤 用户: 我的订单什么时候到？
🤖 客服: 客服收到：我的订单什么时候到？

👤 用户: 谢谢
🤖 客服: 客服收到：谢谢

你学到了什么

你写了一个 Agent骨架。虽然它只是个回声筒，但它包含了一个Agent最核心的结构：

1. 输入：user_message — 用户说了什么
2. 处理：函数体里的逻辑（目前是空的，明天往里填）
3. 输出：返回值 — Agent回复用户什么

后面6天的所有代码，都是在这个骨架上填充和扩展。simple_agent 这个函数会变得越来越聪明，但它的"形状"不会变——接收消息，返回回答。

明天的预告

我们会给这个回声筒装上Prompt模板——让它知道自己是客服，应该好好说话。还会引入Mock LLM，让它能根据不同的问题给出不同的回答。同样零成本，不用API Key。

---

Day 1 完成。你的Agent现在什么都不会——但今天的目的达到了：它跑起来了。