3 月 23 日, 又投出了一枚重磅炸弹:为 推出插件系统!
此举意味着 将迎来“APP Store”时刻,也就是围绕它的能力,形成一个开发者生态,打造出基于 AI 的“操作系统”!
插件系统将为 带来质的飞跃,因为借助于插件服务,它可以获取实时的互联网信息、调用第三方应用(预定酒店航班、点外卖、购物、查询股票价格等等)。
是一个无比聪明的大脑,而插件会成为它的眼睛、耳朵、手脚、甚至于翅膀,能力惊人,未来不敢想象!
官方目前提供了两个插件:
另外, 还开源了一个知识库检索插件 — ,这个插件通过自然语言从各种数据源(如文件、笔记、邮件和公共文档)检索信息。有了开源代码后,开发者可以部署自己的插件版本。
想象一下,假如我提供了一个“ 知识库插件”,以所有官方文档作为数据源,那以后有任何 使用上的问题,我就只需询问 ,然后它调用插件并解析数据,最后返回给我准确的答案。这将节省大量的时间!
不仅如此,你还可以用书籍作为数据源,打造出“西游记知识库”、“红楼梦知识库”、“百科全书知识库”、“个人图书馆知识库”,等等;以专业领域的论文与学术期刊为数据源,创造出一个专家助手,从此写论文查资料将无比轻松;以苏格拉底、乔布斯、马斯克等名人的资料为数据源,创造出人格化的个人顾问……
作为第一个开源的 插件,– 项目一经发布,就登上 趋势榜第一,发布仅一周就获得 11K stars。
这个项目完全是用 写的,不管是出于学习编程的目的,还是为了将来开发别的插件作借鉴,这都值得我们花时间好好研究一下。
接下来,我将分享自己在阅读项目文档和源码时,收获到的一些信息。
首先,该项目含 代码约 3 K,规模不算大。项目结构也很清晰,目录如下:
目录描述
包含使用各种向量数据库提供程序存储和查询文档嵌入的核心逻辑
包括配置示例、身份验证方法和面向程序提供方的示例
包含插件使用的数据模型,例如文档和元数据模型
存放实用的脚本,用于处理和上传来自不同数据源的文件
存放主要的 服务端实现
包含用于任务(如分块、元数据提取和 PII 检测)的实用服务
tests
包括各种向量数据库提供程序的集成测试
.well-known
存储插件清单文件和 格式,定义插件配置和 API 规范等信息
除去示例、测试、配置文件等内容外,最主要的三个目录如下:
数据存储
数据源的文本数据会被映射到低维度向量空间,然后存储到向量数据库中。官方已提供 、、、、、Redis 这几种数据存储方案的示例。另外,有几个 pull 想要加入 的支持,大概率将来会合入。
这里使用了抽象工厂设计模式 , 是一个抽象类,每种数据存储库是具体的实现类,需要实现三个抽象方法:
(1)(: Dict[str, List[]]) -> List[str] 方法,接收一个字典参数,包含有 对象列表,将它们插入到数据库中。返回值为文档 ID 的列表。
(2)(: List[]) -> List[] 方法,接收一个列表参数,包含被 的查询文本。返回一个包含匹配文档块和分数的查询结果列表。
(3)(ids: [List[str]] = None, : [er] = None, : [bool] = None, ) -> bool 方法,根据 id 和其它过滤条件删除,或者全部删除。返回操作是否成功。
值得注意的是,该目录下的.py 模块使用了 3.10 新引入的 match-case 语法,紧跟着 社区的新潮流呢~
服务端接口
这个目录只有一个main.py 文件,是整个项目的启动入口。它使用了目前主流的 框架,提供了增删改查的几个 API,另外使用 模块来启动服务。
在这几个接口中,增改删功能主要是给开发者/维护者使用的, 只需调用插件的查询接口。因此,代码中还创建了一个“/sub”子应用,只包含/query 接口,提供给 调用。
另外,它使用 的 mount 方法挂载了一个“/.well-known”静态文件目录,暴露了关于本插件的基本信息,例如名称、描述、作者、logo、邮箱、提供给 的接口文档等等。
任务处理方法
这个目录下是一些通用的函数,比如下面这些:
(1).py 文件包含了将字符串和 对象分割成小块、以及为每个块获取嵌入向量的函数。
(2)file.py 文件提供了从上传的文件中提取文本内容及元数据的函数。目前支持解析的文件类型包括 PDF、纯文本、、Word、CSV 和 PPTX。
(3).py 文件包含两个函数: 函数使用 的 text–ada-002 模型对给定的文本进行嵌入。 函数使用 的 API 生成对话。
整个而言,这个插件的几个接口功能很清晰,代码逻辑也不算复杂。核心的文本嵌入操作是借助于 的 接口,文本分块信息的存储及查询操作,则是依赖于各家向量数据库的功能。
上有博主手画了一张示意图,字体虽潦草,但大家可以意会一下:
他这个视频 值得推荐一看,因为 up 主不仅简明地介绍了插件的工作原理,还手把手演示如何部署到 Ocean、如何修改配置、如何调试,而且他有 的插件权限,可以将自己部署的插件接入 ,现场演示了知识库插件的使用!
视频:
目前,关于 插件的介绍、开发及配置等资料还比较少,毕竟是新推出的。但是,申请 的个人和组织已经数不胜数了,一旦开放使用,各式各样的插件一定会像 社区丰富的开源库一样,也将极大扩展 的生态。
最后,插件 — 的官方文档是最为详细的一手资料,推荐大家研究一番。
猫技术交流群开放啦!群里既有国内一二线大厂在职员工,也有国内外高校在读学生,既有十多年码龄的编程老鸟,也有中小学刚刚入门的新人,学习氛围良好!想入群的同学,请在公号内回复『交流群』,获取猫哥的微信(谢绝广告党,非诚勿扰!)~
还不过瘾?试试它们
▲
▲
▲
▲
▲
▲
如果你觉得本文有帮助
发表回复