在树莓派上搭建家用 Agent 服务

Sun, 18 Jan 2026 00:00:00 +0000

使用树莓派搭建 dive-into-langgraph/app 服务，在家庭局域网内部使用。

一键部署脚本：agent-server

一、制作 TF 卡

Note: 你可以参考我的这篇博客《树莓派 5 装机指南》，它写得更详细一些。但部分信息已经过时，请注意甄别。

1）下载

你需要下载两样东西：

Raspberry Pi Imager：将镜像写入 TF 卡的工具
Ubuntu 24.04.3 LTS：树莓派的 Ubuntu 镜像

Ubuntu 镜像有两种版本：桌面版、服务器版，我们下载服务器版。下载的时候可以检查一下，安装包的文件名应该是这个 ubuntu-24.04.3-preinstalled-server-arm64+raspi.img.xz

2）将镜像写入 TF 卡

根据 Raspberry Pi Imager 的指引，完成镜像烧录的过程就好了。并没有什么难的。唯一需要注意的是，由于我们已经下载了 Ubuntu 镜像，所以这里要选「使用自定义镜像」。

二、首次启动 Ubuntu

烧录完成后，按以下步骤操作：

先断电，然后将 TF 卡插入板子
连接外接显示屏、键盘、网线
最后插入电源

一般来讲，插电即可点亮。这时回车一下，即可输入账号密码，初始账密是：


账号	ubuntu
密码	ubuntu

输完账密，它会接着让你设置新密码。这里流程设计得有点人机，需要注意看提示，不然容易卡关。温馨提示：你输入 ubuntu 的次数比你想象中更多。

三、环境配置

1）更新软件包

# 更新软件源的索引列表
sudo apt update

# 根据更新后的索引，升级所有可更新的软件包
sudo apt upgrade -y

2）安装 pipx 和 uv

先安装 pipx，再用它安装 uv：

Agent 实战：智能路由、任务拆解和链路工程

Sun, 15 Jun 2025 00:00:00 +0000

大模型天生具有幻觉，为了工程的准确性，我们奉行“非必要不Agent”原则。我们是专业的，除非忍不住，否则绝不用 Agent。

特别声明：本文使用 Qwen Agent 实现。

本文包含以下两个项目：

1）智能路由

概述：如果一个业务可以分很多种情况处理。针对每种情况，我们开发一个工具函数 (Function Calling)，来处理此种情况内部的复杂性。此时，Agent 充当智能路由的角色，将对应的情况路由到对应的工具函数。工具函数内部带有描述信息，Agent 可以访问这些信息，以此判断在何种情况下，调用这个工具函数。

具体来讲，本项目开发了一个 客诉核查 Agent。针对物流逾期和假货两种客诉，分别开发了对应的工具函数。Agent 通过接入工具函数，获得了核查以上两种客诉真实性的能力。当我们将客诉信息传递给 Agent，它会输出针对该客诉的 核查结论 和 相应证据。

2）数据库查询优化

概述：数据库查询是一个非常通用的需求，其中 NL2SQL 是难点。为了提升 NL2SQL 的准确性，很容易想到把数据表的 Schema、样例数据、个别字段的枚举值作为上下文 (context) 注入到原始 Prompt 中。本项目实现了这一点。

具体来说，本项目做了以下工作：

启用 Qwen Agent 的 ReActChat 模式，以提升多步骤情况下的性能
开发定制的 Workflow，用于将 Schema 等上下文信息注入原始 Prompt 中
开发可流式对话的 Gradio WebUI，以方便调试 Agent 和 Workflow

✨ 所有代码见 GitHub 仓库：luochang212/agent-project

一、引言

1. 尚未到来的涌现

We always overestimate the change that will occur in the next two years and underestimate the change that will occur in the next ten. – Bill Gates

Gradio on Chang Luo