AI 小白入门:从零搭建你的第一个本地知识库
学会安装 Python、OpenAI 和 Qdrant,一步步跑通本地 AI 知识库,存储并检索自己的文档。
准备工作:安装 Python 和必备工具
首先,你需要一个叫 Python 的编程语言环境,它是运行 AI 程序的基础。去 python.org 下载 Python 3.11 版本,安装时记得勾选“Add Python to PATH”。完成后打开命令行(Windows 搜索 cmd,Mac 打开终端),输入 python --version,如果显示版本号就成功了。
安装核心组件:OpenAI 和 Qdrant
接下来安装三个关键库:
- OpenAI:提供 AI 大脑,用来理解文字和生成答案。在命令行输入
pip install openai。 - Qdrant:一个本地向量数据库,帮你把文档变成机器能理解的“向量”并快速搜索。安装命令
pip install qdrant-client。 - Watchdog:监控文件夹,有新文件自动处理。安装命令
pip install watchdog。
注意:如果你遇到 pip 报错,试试用 python -m pip install 代替。
第一次跑通:写一个简单的测试脚本
新建一个文件 test.py,复制下面代码:
from openai import OpenAI
client = OpenAI(api_key='你的API密钥')
response = client.embeddings.create(
input='你好,世界',
model='text-embedding-3-small'
)
print(response.data[0].embedding[:5])然后打开命令行,运行 python test.py。如果看到一串数字(比如 [-0.012, 0.034, ...]),恭喜你,AI 已经能理解你的文字了!
常见坑:API 密钥需要去 OpenAI 官网申请,记得保管好;免费额度够你入门。
下一步:存储你自己的文档
现在你可以用 Qdrant 来存文档了。创建一个文件夹 my_knowledge,把你想让 AI 学习的文本文件放进去。然后用 Watchdog 监听这个文件夹,代码大致如下:
from watchdog.observers import Observer
from watchdog.events import FileSystemEventHandler
class MyHandler(FileSystemEventHandler):
def on_created(self, event):
print(f'新文件来了: {event.src_path}')
observer = Observer()
observer.schedule(MyHandler(), 'my_knowledge')
observer.start()运行后,你每次往文件夹里丢文档,程序都会自动处理。更多细节可以搜索“Qdrant 文档检索教程”。
内容来源
DEV Beginners
发布时间
2026-05-16 01:30