45.llama_index-全局配置(Settings)

内容参考于：图灵AI大模型全栈

llamaIndex中有一个全局配置，当我们没有指定模型的时候它会使用全局配置中设置的模型

效果图：

代码

# 导入 LlamaIndex 的全局配置对象 Settings # 核心作用：LlamaIndex 的全局单例配置中心，统一管理大模型、嵌入模型、文本切分等全局参数 # 设计逻辑：一次配置后，后续所有组件（索引、查询引擎、文档加载器等）都会自动复用这里的配置 # 不用每个组件都单独初始化模型，避免重复加载、代码冗余，切换模型也只需要改一处 from llama_index.core import Settings # 导入 Ollama 本地大模型适配类 from llama_index.llms.ollama import Ollama # 导入 HuggingFace 本地嵌入模型适配类 from llama_index.embeddings.huggingface import HuggingFaceEmbedding # ========== 全局配置大模型 ========== # 把初始化好的 Ollama 模型赋值给 Settings.llm # 效果：全局生效，之后所有需要调用大模型的地方（生成回答、总结、提取等）都会自动用这个模型 # 不用再给每个组件单独传 llm 参数，代码更简洁，配置统一 Settings.llm = Ollama( model='qwen2.5:7b', # 指定本地运行的模型名称 request_timeout=120, # 请求超时时间，单位秒 # 强烈建议调大：本地模型生成速度慢，默认超时短很容易中途报错 ) # ========== 全局配置嵌入模型 ========== # 把初始化好的本地嵌入模型赋值给 Settings.embed_model # 效果：全局生效，之后文档入库生成向量、查询生成问题向量，都会自动用这个模型 # 保证入库和查询用的是同一个嵌入模型，向量维度一致，检索不会出问题 Settings.embed_model = HuggingFaceEmbedding( # 本地模型文件路径，指向提前下载好的 bge-m3 模型文件夹 model_name=r"D:\huanjing\ai模型\BAAI\bge-m3", ) # ========== 测试：调用全局大模型 ========== # 直接通过 Settings.llm 调用大模型，验证全局配置是否生效 # complete 是单轮补全接口，输入文本直接返回回答 response = Settings.llm.complete("你好") # 取回答的纯文本内容并打印 print(response.text) # ========== 测试：调用全局嵌入模型 ========== # 直接通过 Settings.embed_model 生成查询向量，验证嵌入模型配置是否生效 embedding = Settings.embed_model.get_query_embedding('你好') # 打印生成的向量数组 print(embedding)