# 前言
为了部署自己的私有AI智能体，让AI根据用户的个性数据来进行决策，实现RAG架构（retrieval，augmented，generation）检索外部知识→增强模型信息→生成精准回答，我们首先需要构建一个向量数据库，于是便有了这篇博客

数据库Chroma

# 前言
这个blog用来记录学习langchain框架的过程




# langgraph
#### langgraph有3要素：状态变量，节点，边
#### 流程如下：
1. 定义状态变量
```
# 定义状态
class ChatState(TypedDict):
    messages: Annotated[list, add_messages]
```

3. 创建llm节点
```
# 创建 LLM 节点
def chatbot(state: ChatState):
    llm = ChatOpenAI(
        model='qwen-plus',
        base_url='https://dashscope.aliyuncs.com/compatible-mode/v1',
        api_key=dotenv.get_key('.env', 'DASHSCOPE_API_KEY'),
    )
    
    response = llm.invoke(state["messages"])
    
    # 注意：这里只返回新消息，add_messages 会自动将它追加到状态中
    return {"messages": [response]}
```

5. 构建图
```
# 构建图
workflow = StateGraph(ChatState)
workflow.add_node("chatbot", chatbot)
workflow.add_edge(START, "chatbot")
workflow.add_edge("chatbot", END)

# 创建检查点存储
checkpointer = InMemorySaver()

# 编译图时指定检查点
graph = workflow.compile(checkpointer=checkpointer)

# 创建线程ID用于保存对话历史
thread_id = str(uuid.uuid4())
```

6. 生成选择和循环的边

```
### 选择 ###



workflow.add_conditional_edges(
    "router",              # 源节点：从哪个节点出发
    route_decision,         # 决策函数：根据状态决定走哪条路
    {                       # 路由映射：决策结果 → 目标节点
        "normal": "chatbot",                    # 如果返回"normal" → 去chatbot节点
        "complex_task": "complex_handler",      # 如果返回"complex_task" → 去complex_handler节点
        "confirmation": "confirmation_handler"  # 如果返回"confirmation" → 去confirmation_handler节点
    }
)
### 循环和选择差不多，就是把去的节点写到源节点就可以了
```
7. 创建工具
```
### 先定义工具函数 ###
@tool
def write_to_file(file_path: str, content: str, mode: str = "a") -> str:
    """将内容写入文件。支持追加模式（'a'）和覆盖模式（'w'）。
    
    Args:
        file_path: 文件路径
        content: 要写入的内容
        mode: 写入模式，'a'表示追加，'w'表示覆盖，默认为'a'
    
    Returns:
        操作结果信息
    """
    try:
        with open(file_path, mode, encoding='utf-8') as f:
            f.write(content)
        return f"✅ 成功写入文件: {file_path} (模式: {mode})"
    except Exception as e:
        return f"❌ 写入文件失败: {str(e)}"
### 将工具绑定到 LLM ###
    llm = ChatOpenAI(
        model='qwen-plus',
        base_url='https://dashscope.aliyuncs.com/compatible-mode/v1',
        api_key=dotenv.get_key('.env', 'DASHSCOPE_API_KEY'),
    ).bind_tools(tools)
```


#### 注：为了保证对话纪录被永久保存，这里需要引入两个变量，checkpoint和uuid，一个用来存档，保存对话，是langgraph的状态持久化机制，一个用来标记是哪一段对话，因为用户可能会开启两段与ai的对话

#### 工具


















#### ai聊天机器人的完整代码如下：
```
from langgraph.graph import StateGraph, START, END
from langgraph.graph.message import add_messages
from typing import Annotated, TypedDict
from langchain_openai import ChatOpenAI
from langchain_core.messages import HumanMessage, AIMessage
import dotenv
from langgraph.checkpoint.memory import InMemorySaver
import uuid


# 定义状态
class ChatState(TypedDict):
    messages: Annotated[list, add_messages]


# 创建 LLM 节点
def chatbot(state: ChatState):
    llm = ChatOpenAI(
        model='qwen-plus',
        base_url='https://dashscope.aliyuncs.com/compatible-mode/v1',
        api_key=dotenv.get_key('.env', 'DASHSCOPE_API_KEY'),
    )
    
    response = llm.invoke(state["messages"])
    
    # 注意：这里只返回新消息，add_messages 会自动将它追加到状态中
    return {"messages": [response]}


# 构建图
workflow = StateGraph(ChatState)
workflow.add_node("chatbot", chatbot)
workflow.add_edge(START, "chatbot")
workflow.add_edge("chatbot", END)

# 创建检查点存储
checkpointer = InMemorySaver()

# 编译图时指定检查点
graph = workflow.compile(checkpointer=checkpointer)

# 创建线程ID用于保存对话历史
thread_id = str(uuid.uuid4())

print("=" * 60)
print("聊天机器人已启动！输入 'quit' 或 'exit' 退出")
print("=" * 60)
print()

# 显示初始欢迎消息
initial_input = {"messages": [HumanMessage(content="你好, 我的名字是大冉")]}
result = graph.invoke(initial_input, config={"configurable": {"thread_id": thread_id}})

# 显示AI的欢迎回复
print("🤖 机器人:", result["messages"][-1].content)
print()

# 交互式聊天循环
while True:
    # 获取用户输入
    user_input = input("👤 你: ").strip()
    
    # 检查退出条件
    if user_input.lower() in ['quit', 'exit', '退出', 'q']:
        print("\n再见！")
        break
    
    if not user_input:
        print("请输入有效内容！")
        continue
    
    # 调用图处理用户消息
    try:
        result = graph.invoke(
            {"messages": [HumanMessage(content=user_input)]},
            config={"configurable": {"thread_id": thread_id}}
        )
        
        # 显示AI回复
        ai_response = result["messages"][-1].content
        print(f"🤖 机器人: {ai_response}")
        print()
        
    except Exception as e:
        print(f"❌ 错误: {e}")
        print()

```



# 参考资料
https://zhuanlan.zhihu.com/p/1945401093786940263

langchain学习日记

# 第一章：浏览器生成信息
![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefinedd02afa269a54afead0b83cd4aa89f680.image.png)

## ip地址
ip地址一共有32位，由两部分组成，网络号和主机号，为了区分，设计了子网掩码


![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefineda602791921d3cb018306c98333b11c6a.image.png)

## DNS服务
DNS是域名解析
域名具有层级结构，比如blog.yxjxxr.site 就是yxjxxr.site的子域名

域名解析的流程

![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined3f48c1d48a8e3211388d14d6ac34864e.image.png)
先去找根域名服务器，在顺藤摸瓜，一步步找到到存放目标域名的服务器，从而获取IP地址

## 委托协议栈发送消息
知道了IP地址之后，就可以委托操作系统的协议栈向目标web服务器发送消息了
大概流程如下：
![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefinedf0f7f6c2fcef6cd0116c1f55a338249d.image.png)
1. 创建套接字
2. 连接
3. 传递消息
4. 断开连接

实际负责收发消息的是协议栈，网卡驱动和网卡。

# 第二章：用电信号传输tcp/ip数据 --探索协议与网卡
## 协议栈处理数据发送请求
协议栈是根据套接字中记录的控制信息来工作的。  
### 创建套接字

![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefinedc8a533f638667ea75cfccad3993d0508.image.png)
1. 像浏览器、邮件等一般的应用程序都是使用 TCP 收发数据的，而像 DNS 查询等收发较短的控制数据的时候则使用 UDP。
2. 下面一半是用 IP 协议控制网络包收发操作的部分此外，IP 中还包括 ICMPA 协议和 ARPB 协议。ICMP 用于告知网络包传送过程中产生的错误以及各种控制消息，ARP 用于根据 IP 地址查询相应的以太网 MAC 地址 C。
3. IP 下面的网卡驱动程序负责控制网卡硬件，而最下面的网卡则负责完成实际的收发操作，也就是对网线中的信号执行发送和接收的操作。


![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefinedf8323002ea4240a6d54b2a14906a3bff.image.png)

### 连接服务器
连接的目的是将客户端的请求发送给协议栈，同时客户端向服务端传递连接的请求


![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined01628b813ed2a66f3620fa71f2693230.image.png)

当知道服务端的IP地址和端口号之后，这些信息会传递给协议栈中的 TCP 模块。然后，TCP 模块会与服务器的 TCP 模块交换控制信息。TCP模块将信息传递给IP模块并委托其发送，信息发送到服务端的IP模块再传到服务端的TCP模块。然后服务器的 TCP 模块会返回响应，向上面一样传回到客户端的TCP模块，然后客户端也需要将 ACK 比特设置为 1 并发回服务器，告诉服务器刚才的响应包已经收到，至此，连接完成（3次握手）

### 数据收发
数据收发操作是从应用程序调用 write 将要发送的数据交给协议栈开始的，协议栈收到数据后执行发送操作
（其中涉及很多很复杂的操作，这里先不写，看看视频教程再进行补充）
### 从服务器断开并删除套接字

![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined552f1acaa577948088125b0f9d407525.image.png)

![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefinedaa44b1efcbc104ee5813ed23e251c083.image.png)

## IP 与以太网的包收发操作

### 大概流程
![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefinedf342b157e988d5899105e98a4396212a.image.png)
### 包收发操作流程
![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined0783e85b6f186b9363cbe7844667e23f.image.png)
IP 头部中包含 IP 协议规定的、根据 IP 地址将包发往目的地所需的控制信息；MAC 头部包含通过以太网的局域网将包传输至最近的路由器所需的控制信息
### 以太网
以太网是一种为多台计算机能够彼此自由和廉价地相互通信而设计的通信技术

![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined1de49e71ccca9401676f15b123e61cea.image.png)

### 接下来讲了IP协议的具体工作过程，包括添加报头，将数据包传到网卡发送，将收到的数据返回给TCP协议等等，这里不细讲，等后面见的多了再进行补充




# 第三章：网线到网络设备
两个目标： 信号如何在网线和集线器上面传输？ 信号在传输的过程中会衰减，还会受到噪声的干扰而失真，如何抑制这些影响？
### 双绞线
双绞线通过交叉抵消相互产生的噪声和相邻网线产生的噪声

![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined94a428176c240786ab67506684c6f56a.image.png)



### 集线器会将信号发送给所有以太网内的设备，设备通过接收方mac地址判断是不是发给自己的，是自己的就接受，否则就忽略。

### 交换机

![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined16df9f560418721d9b5e3db9eeda4eed.image.png)

RJ-45是网线接口，PHY（MAU）模块进行接收，然后传入mac模块，将信号转化为数字信息。校验通过后将包放进内存（缓冲区），缓冲区通过包的接收方mac地址与mac地址表进行对比，在交换电路把包发往相应端口

#### mac地址表的维护
1. 更新维护：收到包时，将发送方 MAC 地址以及其输入端口的号码写入MAC 地址表中。
2. 删除维护：移动设备可能会移动，（比如手机从5教拿到宿舍楼）。这时候当一段时间的mac地址和端口没有进行手法操作的时候，就自动删除记该录

### 路由器

![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined91a9f0e348bc2efd830260e9f59055a8.image.png)
首先通过端口将包接收进来。转发模块会根据接收到的包的 IP 头部中记录的接收方 IP 地址，在路由表中进行查询，以此判断转发目标。然后，转发模块将包转移到转发目标对应的端口，端口再按照硬件的规则将包发送出去

![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined06b44e02244aa958af8d3f2ae3f6881e.image.png)
#### 路由表中的信息

![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefineddd21682b9e3e98b3826ce2f8c4eea5c4.image.png)

路由器在进行包的转发的时候只会将包发往对应的网络号。将包发往xxx区
![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined26d36837488b64391233228c3f2125fb.image.png)
在子网掩码的右边
还有网关和接口两列，它们表示网络包的转发目标。根据目标地址和子网
掩码匹配到某条记录后，路由器就会将网络包交给接口列中指定的网络接
口（即端口）B，并转发到网关列中指定的 IP 地址。

主机号部分比特全部为 0 可以表示一个子网，主机号部分比特不全部为 0 可以表示某一台计算机
#### 路由聚合
有时候同一个IP地址的子网掩码和路由表中的不一样，这是路由聚合的结果

![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined610daac9d12abbd865784bb13e64110d.image.png)
但在这个例子中，无论发往任何一个子网，都是通过路由器 A 来
进行转发，因此我们可以在路由表中将这 3 个子网合并成 10.10.0.0/16，这
样也可以正确地进行转发，但我们减少了路由表中的记录数量，这就是路
由聚合。

#### 网关的作用
当接收方的IP地址不在路由表里面的时候，就会触发兜底机制：子网掩码 0.0.0.0 ，这时候数据包会通过网关转发到互联网接入路由器


![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined73a18a480f67f2b72df90c82118ae662.image.png)
这样一来，无论目标地址是表示一个子网还是表示某台设备，都可以
用相同的方法查找出转发目标，而且也避免了不知道转发到哪里的问题。

### 路由器与交换机的关系

![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefinedf78549d13f254a6763e6058ac0408c2a.image.png)

### 路由器附加功能
1. 通过地址转换有效利用 IP 地址。
![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined6eab3b59554d5d7ca4cafbfc9a013a01.image.png)  
**虽然通过划分内网和外网可以有效缓解IP资源的压力，但是当内网地址与要访问的外网地址一样的话，就不能进行正确有效的数据传输了。为此，设计了以下结构来解决这个问题**



![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined4c320ef3e074a827ac22b1f4b185d869.image.png)  
将公司内网分成两个部分，一部分是对互联网开放的服务器，另一
部分是公司内部设备。其中对互联网开放的部分分配公有地址，可以和互
联网直接进行通信，这一部分和之前介绍的内容是一样的。相对地，内网
部分则分配私有地址，内网中的设备不能和互联网直接收发网络包，而是
通过一种特别的机制进行连接，这个机制就叫地址转换。
2. 地址转换基本原理

![QQ_1766306706124.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined4e1980b4a773f54bb0a848d2710f4654.QQ_1766306706124.png)
首先将发送方的私有IP地址改写为地址转换设备的接入互联网的公网地址，将地址和端口号进行对应，写在对应表里，发往服务器之后，从服务器接收数据之后，根据对应表，将公网IP和端口号映射到原来的内网IP和端口号，实现数据传输。当收发结束之后，进入断开阶段，访问互联网的操作全部完成后，对应表中的记录就
会被删除。

3. 路由器的包过滤规则

在对包进行转发时，根据 MAC 头部、IP 头部、TCP 头部的内容，按照事先设置好的规则决定是转发这个包，还是丢弃这个包。我们通常说的防火墙设备或软件，大多数都是利用这一机制来防止非法入侵的

# 第四章 通过接入网进入互联网内部
## ADSL接入网的结构和工作方式

![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined8921cd90a7d4741854c89130063ae651.image.png)

# 第五章 服务器端的局域网

![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefinedf04db8e29898b5edd03129ca0334e03a.image.png)

## 防火墙的结构和原理

![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined2f90c33cf0710dd6bbb157c5453881ff.image.png)

![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined4f06624f5210e6d2f9d1430085dcd08e.image.png)

网络是怎样连接的

# 前言
搭建一个ai agent,打soul的比赛，就从现在开始吧



# ai agent
1. 解释  
它会将自动调用大模型，完成文件写入与项目文件调用，全程无需用户操作。
2. agent运行模式


![f9ba1f61f7c10381c7199fac3ca183e.jpg](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined330a72a5cca92f9a42d8e5e6162cf69e.f9ba1f61f7c10381c7199fac3ca183e.jpg)

4. react模式实现原理：给模型安排了一个模拟剧本，引导模型一步步去执行


![7f818e4ea374a308497bb2677bf4e6d.jpg](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined4184264c6654f7e89135a4fb510eefb2.7f818e4ea374a308497bb2677bf4e6d.jpg)
![ef250bc9ecc793baf79d5b2b1cacec5.jpg](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined41ad2254562d97ae6ad690610b84e124.ef250bc9ecc793baf79d5b2b1cacec5.jpg)
包含4个部分，思考，执行，观察，最后输出最终答案。前三个部分不停的循环，直至最终答案出现
6. plan and execute模式
这个是个先规划再执行的模式，先把任务分成几步，然后一步步的去完成
https://github.com/langchain-ai/langgraph




# 学习路线

![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined43b89f3de03d9fc1e2e0a0fa8e57423b.image.png)

1. 先学langgraph，理解框架
2. 基于langgraph做一个电商回复智能体类似这样的产品，全程手写代码
3. 做需求调研，每天都要去研究一下需求在哪，痛点在哪，整理痛点清单
4. 每周写一篇技术博客


![image.png](https://tuchuang-yxjxxr.oss-cn-beijing.aliyuncs.com/undefined85a8093d974a7448d45d060bd54cb2af.image.png)

ai agent

# 前言
收录英语小短文



# Venti's Wind AI Helper
The wind in Mondstadt always carried the scent of dandelions. Venti sat on the big tree at Windrise, plucking the strings of his lyre and humming a tune, while an apple core rolled beside his feet. Suddenly, he heard soft sobbing coming from Windwail Highland. With a light tap of his toes, he glided over on the wind.

Under a tree, a little girl named Nora was wiping her tears, clutching a wilted Cecilia flower tightly in her hand. "What's the matter? A young lady's tears can even weigh down the wind, you know." Venti landed in front of her, took off his hat, and bowed politely. Nora sniffled and said, "I wanted to pick a Cecilia flower for Mom's birthday present, but the wind on the mountain top was too strong. I didn't get the flower, and my basket got blown away too..."

Venti blinked his green-and-blue eyes, suddenly remembering the "little gadget" Lisa had slipped him the day before—a silver badge inlaid with the wing of a Windwheel Aster. "Don't worry, I have a helper who can talk to the wind." He pinned the badge to Nora's collar and blew gently on it. "This is 'Wind Whisper AI'. It can understand the wind and help us find things."

The badge suddenly lit up with a faint glow. Venti played a lively note on his lyre: "Could you help us find Nora's basket, and also point out the easiest place to pick Cecilia flowers?" The sound of the wind rustling through the treetops suddenly became clear. The light spot on the badge wobbled in one direction, and a soft prompt sound came out: "The basket is twenty steps to the southwest. The platform ahead has gentle wind, and the flowers there are the fullest~"

Nora's eyes widened in surprise. She followed the light spot and quickly retrieved her basket. When they reached the mountain-top platform, the wind there was indeed gentle, and the Cecilia flowers swayed softly in the sunlight. Venti sat aside playing his lyre, while Wind Whisper AI quietly blocked the disruptive strong winds for them. It even swept up a few glistening dewdrops and sprinkled them on the flowers, making them look even more delicate.

After picking the flowers, Nora suddenly remembered something: "Dad said we should write a poem for Mom, but I don't know how..." Venti smiled and pointed at the badge: "It also hides a little poetry magic." A faint light and shadow projected from the badge. Based on what Nora had said—"Mom likes dandelions and can make apple pies"—a few lines of poetry soon appeared: "The wind carries dandelions in a light dance, the oven holds a sweet fragrance. Mom's smile is like a Cecilia, blooming in my heart."

"That's perfect!" Nora hopped and skipped toward home. Venti waved: "Remember to tell Mom that the Anemo Archon (the God of Wind in Genshin Impact, and Venti himself is the incarnation of this god) and his little helper wish her a happy birthday~" After Nora ran far away, the glow of the badge gradually faded. Venti tucked it into his arms, took a sip of dandelion wine. The wind blew past, carrying the sound of distant laughter, and he softly hummed a new song—one that held the gentle secret of AI and the wind.

---

## Glossary of Genshin Impact Exclusive Terms
- **Venti**: The English name of 温迪，a playable character in Genshin Impact. He is the incarnation of the Anemo Archon and loves freedom and music.
- **Mondstadt**: The English name of 蒙德，one of the seven major regions in Genshin Impact. It is a city-state that advocates freedom, with wind as its core element.
- **Windrise**: The English name of 风起地，a landmark in Mondstadt. It has a huge oak tree and is one of Venti's favorite places to stay.
- **Windwail Highland**: The English name of 望风山地，a mountainous area in Mondstadt with open terrain and often strong winds.
- **Cecilia**: The English name of 塞西莉亚花，a rare flower in Mondstadt that grows on high mountains. It is one of Venti's favorite flowers.
- **Windwheel Aster**: The English name of 风晶蝶，a small creature in Mondstadt that is related to the wind element. Its wings glow with a faint blue light.
- **Anemo Archon**: The English name of 风神，one of the seven archons (gods who rule the seven regions) in Genshin Impact, in charge of the wind element and the region of Mondstadt.