极客前沿

AI 小白入门:从零搭建你的第一个本地知识库

2026-05-16 01:30
DEV Beginners
查看原文

学会安装 Python、OpenAI 和 Qdrant,一步步跑通本地 AI 知识库,存储并检索自己的文档。

准备工作:安装 Python 和必备工具

首先,你需要一个叫 Python 的编程语言环境,它是运行 AI 程序的基础。去 python.org 下载 Python 3.11 版本,安装时记得勾选“Add Python to PATH”。完成后打开命令行(Windows 搜索 cmd,Mac 打开终端),输入 python --version,如果显示版本号就成功了。

安装核心组件:OpenAI 和 Qdrant

接下来安装三个关键库:

Tutorial Image
  • OpenAI:提供 AI 大脑,用来理解文字和生成答案。在命令行输入 pip install openai
  • Qdrant:一个本地向量数据库,帮你把文档变成机器能理解的“向量”并快速搜索。安装命令 pip install qdrant-client
  • Watchdog:监控文件夹,有新文件自动处理。安装命令 pip install watchdog

注意:如果你遇到 pip 报错,试试用 python -m pip install 代替。

第一次跑通:写一个简单的测试脚本

新建一个文件 test.py,复制下面代码:

Tutorial Image
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

返回 AI技术