当前位置：首页 > news >正文

Spring AI Alibaba 文档检索使用

news 来源：原创 2025/9/20 19:01:18

一、文档检索 (Document Retriever)简介

1、核心概念

文档检索（DocumentRetriever）是一种信息检索技术，旨在从大量未结构化或半结构化文档中快速找到与特定查询相关的文档或信息。文档检索通常以在线(online)方式运行。

DocumentRetriever通常基于向量搜索。 它将用户的查询问题(query)转化为Embeddings后，在存储文档中进行相似性搜索，返回相关的片段。片段的用途之一是作为提示词(prompt)的一部分，发送给大模型(LLM)汇总处理后，作为答案呈现给用户。

public interface DocumentRetriever extends Function<Query, List<Document>> {/*** Retrieves relevant documents from an underlying data source based on the given* query.* @param query The query to use for retrieving documents* @return The list of relevant documents*/List<Document> retrieve(Query query);default List<Document> apply(Query query) {return retrieve(query);}}

DocumentRetriever API提供了简单、灵活的方式，供开发者使用自定义的检索系统。

DocumentRetriever API简单地将用户的查询作为输入，返回文档片段(Document)的列表。
Document表示一个文档片段，它包含一个文本内容，以及一个或多个元数据。
用户可以通过retrieve方法执行自定义的检索步骤。
DashScopeDocumentRetrieverOptions提供了DashScopeDocumentRetriever的配置信息，它通过构建器创建选项。
在构造DashScopeDocumentRetriever时，通过将一个DashScopeDocumentRetrieverOptions实例传入，已完成配置。

DashScopeDocumentCloudReader类：百炼云端文档解析，主要是走当前数据中心逻辑。

作用：将用户添加的文档上传到百炼平台云端。

通过查看 DashScopeDocumentCloudReader的get方法可以看到上传逻辑。

在这里插入图片描述

二、文档检索 (Document Retriever)使用

Spring AI Alibaba 文档检索 (Document Retriever)：https://java2ai.com/docs/1.0.0-M6.1/tutorials/retriever

Spring AI Alibaba 支持以上 Model 抽象与通义系列模型的适配，并通过 spring-ai-alibaba-starter AutoConfiguration 自动初始化了默认实例，因此我们可以在应用程序中直接注入 ChatModel、ImageModel 等 bean，当然在需要的时候也可以自定义 Model 实例。

在普通 Controller Bean 中注入 DocumentRetriever 实例，实现下面几个功能：

简单调用
流式调用
上传用户文档-向量存储

编写 Controller接口

@Slf4j
@RestController
@RequestMapping("/dashscope/document-retriever")
public class DashScopeDocumentRetrieverController {private final ChatClient chatClient;private final DashScopeApi dashscopeApi;@Value("${spring.ai.dashscope.api-key}")private String apiKey;//private String apiKey = "sk-xxx";private static final String indexName = "高并发-知识库";private static final String retrievalSystemTemplate = """Context information is below.---------------------{question_answer_context}---------------------Given the context and provided history information and not prior knowledge,reply to the user comment. If the answer is not in the context, informthe user that you can't answer the question.""";public DashScopeDocumentRetrieverController(ChatClient.Builder builder) {// 暂时无法从Spring IOC容器中获取，所以这里手动创建 DashScopeApi 对象。this.dashscopeApi = new DashScopeApi(apiKey);DocumentRetriever retriever = new DashScopeDocumentRetriever(this.dashscopeApi,DashScopeDocumentRetrieverOptions.builder().withIndexName(indexName).build());this.chatClient = builder//.defaultAdvisors(new DocumentRetrievalAdvisor(retriever)).defaultAdvisors(new DocumentRetrievalAdvisor(retriever, retrievalSystemTemplate)).build();}/*** 导入用户文档*/@GetMapping("/importDocuments")private String importDocuments() {File file = new File("D:\\TempFiles\\高并发秒杀系统的设计与实现.pdf");// 获取文件或目录的绝对路径。String filePath = file.getAbsolutePath();// 1. import and split documentsDocumentReader reader = new DashScopeDocumentCloudReader(filePath, dashscopeApi, null);List<Document> documentList = reader.get();log.info("{} documents loaded and split", documentList.size());// 2. add documents to DashScope cloud storageVectorStore vectorStore = new DashScopeCloudStore(dashscopeApi, new DashScopeStoreOptions(indexName));vectorStore.add(documentList);log.info("{} documents added to dashscope cloud vector store", documentList.size());return "success";}/*** 简单调用方式*/@GetMapping("/simple/chat")public String simpleChat(@RequestParam(defaultValue = "你好，请问你的知识库文档主要是关于什么内容的?") String userInputPrompt) {String aiOutput = chatClient.prompt(userInputPrompt).call().content();log.info("simpleChat --> userInputPrompt = {}, aiOutput = {}", userInputPrompt, aiOutput);return aiOutput;}/*** Stream 流式调用。* 可以使大模型的输出信息实现打字机效果。*/@GetMapping("/stream/chat")public Flux<String> streamChat(HttpServletResponse response,@RequestParam(defaultValue = "你好，请问你的知识库文档主要是关于什么内容的?") String userInputPrompt) {// 避免接口返回乱码response.setCharacterEncoding("UTF-8");log.info("streamChat -->  userInputPrompt = {},", userInputPrompt);Flux<String> aiOutput = chatClient.prompt(userInputPrompt).stream().content();return aiOutput;}}

启动项目，用户上传文件之后，我们在阿里云百炼平台就可以查看到文档信息。

在这里插入图片描述

访问接口与 AI 大模型智能对话。

在这里插入图片描述

– 求知若饥，虚心若愚。

Spring AI Alibaba 文档检索使用

一、文档检索 (Document Retriever)简介 1、核心概念文档检索（DocumentRetriever）是一种信息检索技术，旨在从大量未结构化或半结构化文档中快速找到与特定查询相关的文档或信息。文档检索通常以在线(online)方式运行。 DocumentRetriever通…...

编程日记 2025/9/20 19:01:18

遍历算法及其应用详解

李升伟整理什么是遍历？ 遍历是指按照某种规则或顺序，系统地访问数据结构（如树、图等）中的每个节点一次且仅一次的过程。遍历是算法设计中的基本操作，用于访问、检查或修改数据结构中的所有元素。主要遍历算法 1…...

编程日记 2025/9/20 19:00:38

.NET-EFCore基础知识

.NET EF Core（Entity Framework Core）是微软开发的一款开源的对象关系映射（ORM）框架，用于在.NET 应用程序中与数据库进行交互。以下是一些.NET EF Core 的基础知识： 1. 什么是 EF Core EF Core 是.NET 平…...

编程日记 2025/9/9 12:28:27

R语言基础包可视化（一：axis函数）

R语言基础包可视化（一：axis函数）背景axis函数（坐标轴函数）各参数的图片示例hadj和padjline和poslty,lwd,lwd.ticksgap.axis总结背景之前在介绍正态Q-Q图的过程中，画过标准正态分布的随机数、分数数、分布函数、密度函数的图像，相关的文章连接参考此处：R语言正态Q-Q图…...

编程日记 2025/9/11 17:42:25

Axure疑难杂症：垂直菜单折叠与展开（玩转垂直菜单）

亲爱的小伙伴，在您浏览之前，烦请关注一下，在此深表感谢！课程主题：垂直菜单折叠与展开主要内容：折叠与展开效果应用场景：PC后台菜单、动态下拉菜单、商品分类选择等折叠与展开场景案例展示：案例视频：垂直菜单折叠与展开效果正文内容：关于垂直菜单的折叠与…...

编程日记 2025/9/18 12:39:36

docker 中跑faster-whisper 教程（1050显卡）

之前我本地机器运行faster-whisper 会报错类似 Could not load library libcudnn_ops_infer.so.8github 上也有类似的情况 ：https://github.com/SYSTRAN/faster-whisper/issues/516#issuecomment-2785038635 缺少.so.8 文件，我通过以下方式，…...

编程日记 2025/9/19 1:49:51

MySQL 在 CentOS 7 环境安装完整步骤

1. 卸载已有环境（MariaDB/旧版MySQL） 1.停止 MariaDB 服务 systemctl stop mariadb.service 2.检查并卸载 MariaDB/MySQL 安装包 rpm -qa | grep mariadb # 检查 MariaDB 相关包 rpm -qa | grep mysql # 检查 MySQL 相关包 sudo yum remo…...

编程日记 2025/9/11 11:18:26

下一代智能爬虫框架：ScrapeGraphAI 详解

更多内容请见：爬虫和逆向教程-专栏介绍和目录文章目录一、ScrapeGraphAI 概述1.1 ScrapeGraphAI介绍1.2 核心特点1.3 工作流程1.4 关键模块1.5 对比传统爬虫框架1.6 安装二、基础操作2.1 自定义解析规则2.2 数据后处理2.3 分布式爬取三、高级功能3.1 多步骤交互采集3.2 动态…...

编程日记 2025/9/15 20:01:46

C++-ffmpeg-2-3-工厂模式封装SDL-9-7

1.接口设计 2.窗口渲染器和材质初始化 3.渲染Draw并测试渲染YUV 4.渲染画面随窗口大小自动缩放并抗锯齿 5.清理接口和接收窗口退出事件 1.接口设计：原则主要的实现步骤： main的流程： 1打开文件 yuv_file.open("400_300_25.yuv&quo…...

编程日记 2025/9/19 8:20:06

下载极客漫画——Beautiful Soup实用案例

文章目录一、背景介绍二、实现思路三、效果图四、构思五、实现细节 1. 第一步下载网页 2. 寻找和下载漫画图像 3. 保存图像，找到前⼀张漫画六、完整代码七、程序输出八、附录九、总结一、背景介绍 XKCD网站是一个关于浪漫、隐喻、数字、以及…...

编程日记 2025/9/10 8:07:16

【大模型理论篇】SWIFT: 可扩展轻量级的大模型微调基础设施

1. 背景大模型(LLM)和多模态大模型(MLLM)利用基于Transformer的架构获得了很迅速的发展。为满足对这些模型的训练和轻量级微调需求，目前已有一些开源框架，如LLaMA-Factory、Firefly、FastChat、Axolotl和LMFlow等。但这些框架在支持的模型、技术和功能上…...

编程日记 2025/9/4 20:47:05

利用 schedule 模块在每日上午每 3 秒执行任务

一、schedule 模块基础原理与功能概述 schedule 模块维护了一个任务队列，每个任务都关联着一个特定的时间触发器和对应的执行函数。当系统时间到达任务设定的触发时间时，模块会从队列中取出相应的任务并执行其关联的函数。这种设计模式使得开发者无需过多关注底层的时间处理…...

编程日记 2025/9/9 17:52:34

ruby超高级语法

以下是 Ruby 中一些极度硬核的语法和底层特性，涉及元编程的深渊、虚拟机原理、语法黑魔法等，适用于追求极限的 Ruby 开发者： 一、语法核弹级操作 1. 动态修改继承链 class A; def foo; "A"; end end class B; def foo; "B…...

编程日记 2025/9/10 19:35:26

Java Stream API：现代化集合处理的艺术

Java Stream API：现代化集合处理的艺术引言在Java 8中引入的Stream API彻底改变了我们处理集合数据的方式。它不仅仅是一个新的工具集，更代表了一种声明式、函数式的编程范式。本文将深入探讨Java Stream的核心概念、使用场景和最佳实践。一、什么是Stream？ Stream（…...

编程日记 2025/9/18 16:49:01

ruby高级语法

以下是 Ruby 高级语法的详细总结，涵盖元编程、模式匹配、闭包、并发模型等核心主题： 一、元编程（Metaprogramming） 1. 动态定义方法 class DynamicClass# 使用 define_method 动态定义方法["foo", "bar"].e…...

编程日记 2025/9/9 18:08:39

特权FPGA之UART串口

0.简介通用异步收发器(Universal Asynchronous Receiver／Transmitter，UART)可以和各种标准串行接口，如RS 232和RS 485等进行全双工异步通信，具有传输距离远、成本低、可靠性高等优点。一般UART由专用芯片如8250，1645…...

编程日记 2025/9/19 17:21:53

oracle 索引失效

在 Oracle 11g 中，索引失效的常见原因包括函数修改列、隐式类型转换、统计信息过时等，解决方法需结合版本特性（如虚拟列、索引跳跃扫描）。通过执行计划分析、统计信息维护和合理使用提示（Hints）&#xff0c…...

编程日记 2025/9/9 9:48:58

MySQL查看binlog执行情况

因数据丢失，被要求使用binlog查看执行SQL的具体情况。拿到数据库压缩包，解压缩获得文件和文件夹若干。如图，有17个binlog文件，目标数据库名应为corr。已知这个数据库是安装在windows下，版本8.0. 先下载一个mysq…...

编程日记 2025/9/11 12:19:39

kotlin，Android，jetpack compose，日期时间设置

AI生成，调试出来学习，这些小组件会用了，就可以组合一个大点的程序了。 package com.example.mydatetimeimport android.app.AlertDialog import android.os.Bundle import androidx.activity.ComponentActivity import androidx.activity.co…...

编程日记 2025/9/3 7:21:02

sql-labs靶场 less-2

文章目录 sqli-labs靶场less 2 联合注入 sqli-labs靶场每道题都从以下模板讲解，并且每个步骤都有图片，清晰明了，便于复盘。 sql注入的基本步骤注入点注入类型字符型：判断闭合方式 （‘、"、’、“”&#xf…...

编程日记 2025/9/20 4:39:41

ssh密钥连接远程服务器并用scp传输文件

ssh密钥连接远程服务器私钥的权限必须是600chmod 600 id_rsa连接时在命令中加上私钥的地址ssh -i PATH_to_id_rsa usernameip -p port scp -P port -i PATH_to_id_rsa file usernameip:PATH...

编程日记 2025/8/17 23:42:53

【锂电池SOH预测】PSO-BP锂电池健康状态预测，锂电池SOH预测（Matlab完整源码和数据）

预测效果基于PSO-BP算法的锂电池健康状态预测研究一、引言 1.1 研究背景与意义在当今社会，锂电池凭借其高能量密度、长寿命及环境友好等特性，在现代能源系统中占据着举足轻重的地位。从消费电子领域如智能手机、笔记本电脑，到动力领域中…...

编程日记 2025/9/15 21:51:23

找搭子系统搭子经济新风口基于精准匹配的社交新生态探索

一、市场前景：为什么现在需要"找搭子"？ 孤独经济爆发超60%年轻人存在"精准陪伴"需求（2024社交报告） 传统社交App无法满足"非婚恋、非熟人"的中间态需求线下活动复苏剧本杀/飞盘等兴趣活动年增…...

编程日记 2025/9/20 14:43:22

《Spring Boot+策略模式：企业级度假订单Excel导入系统的架构演进与技术实现》

前言在数字化时代背景下，订单管理系统的高效性与灵活性成为企业竞争力的核心要素。本文档详细剖析了一个基于策略模式的度假订单导入系统，通过分层架构设计实现了多源异构数据的标准化处理。系统以 Spring Boot 为核心框架，结合 MyBatis …...

编程日记 2025/9/15 17:02:57

软件需求分析习题汇编

需求工程练习题一、选择题 1. 软件需求规格说明书的内容不应包括对（ ）的描述。 A. 主要功能B. 算法的详细过程C. 用户界面及运行环境D. 软件的性能 *正确答案:*B:算法的详细过程; 2. 需求分析最终结果是产生（ ） A. 项目开发…...

编程日记 2025/9/11 3:39:40

51单片机的汇编伪指令

目录一、ORG 汇编起始地址命令 1、功能 2、语法格式 3、使用示例 4、注意事项二、END 汇编终止命令 1、功能 2、语法格式 3、使用示例 4、注意事项三、EQU 赋值命令 1、功能 2、语法格式 3、使用示例 4、注意事项四、BIT 位定义命令 1、功能 2、语法格式…...

编程日记 2025/9/12 12:07:35

深入探究Python的re模块及其在爬虫中的应用

深入探究Python的re模块及其在爬虫中的应用一、引言在Python的强大生态系统中，re模块作为处理正则表达式的核心工具，发挥着举足轻重的作用。正则表达式是一种描述文本模式的强大语言，能够高效地进行字符串的匹配、查找、替换等操作。无论…...

编程日记 2025/9/14 4:35:50

aosp13增加摄像头控制功能实现

A13中，可以要求做一个开关来控制摄像头是否可用，约束所有使用摄像头的应用。思路：设置中增加开关设置一个属性值，在摄像头调用实现层增该值判断即可一开关的开发： 设置-安全中增加开关选项代码部分&#x…...

编程日记 2025/9/9 17:41:36

Kotlin 之 vararg 参数向下传递的几种方式

在 Kotlin 中，vararg 参数是一种特殊的参数类型，用于表示可变数量的参数。vararg 参数是否可以向下传递，需要根据目标方法的参数类型来决定。 1、目标方法参数也是vararg类型，可直接向下传递在 method 方法中，通过 …...

编程日记 2025/9/15 1:10:03

Kotlin学习

kotlin android 开源,Kotlin开源项目集合_晚安呼-华为开发者空间干货来袭，推荐几款开源的Kotlin的Android项目...

编程日记 2025/9/18 12:35:14

AI写程序:图片批量重命名工具 - 自动化整理您的图片库

图片批量重命名工具 - 自动化整理您的图片库 GitHub项目地址: https://github.com/dependon/renameImage 项目介绍这是一个基于Python开发的图形界面工具，用于批量重命名文件夹中的图片文件。它能够递归处理选定文件夹及其所有子文件夹中的图片，按照…...

编程日记 2025/9/11 13:37:45

git命令自动拉去远程分支到本地

是的，可以通过 Git 命令自动拉取远程分支并在本地创建同名分支。以下是几种方法： 方法 1：直接拉取远程分支并创建同名本地分支 git fetch origin <远程分支名> # 拉取远程分支 git checkout -b <本地分支名> origin/<远程分…...

编程日记 2025/9/9 12:56:29

[创业之路-364]：穿透表象：企业投资的深层逻辑与误区规避

前言： 透过现象看本质企业一生与人生相似看企业如同看人三岁看大，七岁看老三十年河东，三十年河西企业也有品行、文化、气质、性格、赚钱、生命周期与赚钱曲线投资公司的目的是未来赚钱，赚未来赚钱。投资创业中的企业主要看…...

编程日记 2025/9/18 10:54:23

UE5 蓝图里的声音

文章目录支持的格式设置循环播放在场景中放置音频设置音频的衰减与不衰减在UI动画中播放声音使用蓝图节点播放声音按钮本身就可以播放声音支持的格式支持：WAV 不支持：MP3 设置循环播放双击音频，打开音频设置，勾选Looping …...

编程日记 2025/9/12 11:21:25

Spring Boot 邮件发送配置遇到的坑：解决 JavaMailSenderImpl 未找到的错误

在使用 Spring Boot 开发时，我们经常需要通过邮件发送功能来实现某些业务逻辑。为了方便快速集成，Spring Boot 提供了一个非常好用的 spring-boot-starter-mail 模块，帮助我们轻松发送邮件。但是，在配置过程中可能会遇到一些问题&…...

编程日记 2025/9/8 13:57:20

路由表的最终地址 root 路由跟踪,最终到哪里去

在路由跟踪（如tranceroute或trancert命令）中，最终地址是目标主机或服务器的IP地址或域名所对应的实际网络地址；路由跟踪的目的是显示数据包从本地主机到目标主机所经过的每一跳路由器或网络节点，而最终地址是数据包要到达的目标设备。 1.路由跟踪的最终地址目标主机：路…...

编程日记 2025/9/15 11:07:31

Docker面试全攻略（一）：镜像打包、容器运行与高频问题解析

引言在云原生和微服务架构盛行的今天，Docker 已成为后端开发的必备技能。本文从面试高频考点出发，系统梳理 Docker 镜像构建、容器运行的核心知识点，助你轻松应对 Docker 相关的技术面试！一、Docker 镜像构建核心（面试必问） 1. Dockerfile 核心命令与参数 FROM：基…...

编程日记 2025/9/10 1:29:04

方法的重写

目录 1、重写的概念2、方法重写的规则3、重写 VS 重载 1、重写的概念重写，也称为覆盖，是子类对父类的非构造、非静态、非 final 修饰、非 private 修饰的方法的实现过程的重新编写。重写可以让子类根据需要来实现父类的方法。方法重写是子类与父类的一…...

编程日记 2025/9/16 3:54:17

搭建hadoop集群模式并运行

3.1 Hadoop的运行模式先去官方看一看Apache Hadoop 3.3.6 – Hadoop: Setting up a Single Node Cluster. 本地模式：数据直接存放在Linux的磁盘上，测试时偶尔用一下伪分布式：数据存放在HDFS，公司资金不足的时候用完全分布式&a…...

编程日记 2025/9/20 12:24:23

【学Rust写CAD】39 over_in_in 函数(alpha256补充方法）

源码 // Similar to over_in but includes an additional clip alpha value#[inline]pub fn over_in_in(self,src: Argb, dst: Argb, clip: Alpha) -> Argb {let src_alpha self * clip;let dst_alpha !(src_alpha*src.alpha_t());// we sum src and dst before reducing…...

编程日记 2025/9/20 1:29:38

一、文档检索 (Document Retriever)简介

1、核心概念

二、文档检索 (Document Retriever)使用

相关文章：