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

使用Spring AI集成Perplexity AI实现智能对话（详细配置指南）

ops 2025/7/21 13:54:19

使用Spring AI集成Perplexity AI实现智能对话（详细配置指南）

引言

Perplexity AI作为新兴的AI服务提供商，通过将语言模型与实时搜索引擎结合，提供了独特的对话体验。Spring AI通过复用OpenAI客户端实现了与Perplexity AI的无缝集成，开发者可快速构建智能对话应用。本文将详细介绍如何在Spring Boot项目中配置和使用Perplexity AI服务。
在这里插入图片描述

前提条件

API密钥申请
访问Perplexity API官网创建API密钥。
支持的模型选择
Perplexity提供多种优化模型，例如：
- llama-3.1-sonar-small-128k-online
- llama-3.1-sonar-large-128k-online
- 完整列表参考官方文档

集成步骤

1. 添加依赖

在pom.xml中添加Spring AI的OpenAI Starter依赖：

<dependency><groupId>org.springframework.ai</groupId><artifactId>spring-ai-starter-model-openai</artifactId>
</dependency>

2. 配置属性文件

在application.properties中配置关键参数：

# 必填配置
spring.ai.openai.api-key=<YOUR_API_KEY>
spring.ai.openai.base-url=https://api.perplexity.ai
spring.ai.openai.chat.model=llama-3.1-sonar-small-128k-online
spring.ai.openai.chat.completions-path=/chat/completions# 可选参数（默认值参考下方表格）
spring.ai.openai.chat.options.temperature=0.7
spring.ai.openai.chat.options.maxTokens=512

或使用YAML格式（application.yml）：

spring:ai:openai:api-key: ${PERPLEXITY_API_KEY}base-url: ${PERPLEXITY_BASE_URL}chat:model: ${PERPLEXITY_MODEL}completions-path: ${PERPLEXITY_COMPLETIONS_PATH}options:temperature: 0.7

3. 环境变量配置（增强安全性）

在.env文件中设置环境变量：

export PERPLEXITY_API_KEY=your_api_key_here
export PERPLEXITY_BASE_URL=https://api.perplexity.ai
export PERPLEXITY_MODEL=llama-3.1-sonar-small-128k-online
export PERPLEXITY_COMPLETIONS_PATH=/chat/completions

关键配置属性详解

连接与模型配置

属性	描述	默认值
`spring.ai.openai.api-key`	Perplexity API密钥	必填
`spring.ai.openai.base-url`	服务地址	`https://api.perplexity.ai`
`spring.ai.openai.chat.model`	模型名称	必填
`spring.ai.openai.chat.completions-path`	补全接口路径	`/chat/completions`

模型参数配置

属性	描述	范围	默认值
`spring.ai.openai.chat.options.temperature`	响应随机性	0 < x < 2	0.2
`spring.ai.openai.chat.options.topP`	核心采样阈值	0 < x < 1	0.9
`spring.ai.openai.chat.options.maxTokens`	最大生成Tokens数	-	模型默认
`spring.ai.openai.chat.options.frequencyPenalty`	重复惩罚因子	x > 0	1

重试机制配置

属性	描述	默认值
`spring.ai.retry.max-attempts`	最大重试次数	10
`spring.ai.retry.backoff.initial-interval`	初始重试间隔	2秒
`spring.ai.retry.backoff.max-interval`	最大重试间隔	3分钟

代码实现示例

控制器层实现

@RestController
public class ChatController {private final OpenAiChatModel chatModel;@Autowiredpublic ChatController(OpenAiChatModel chatModel) {this.chatModel = chatModel;}// 同步调用@GetMapping("/ai/generate")public Map<String, String> generate(@RequestParam String message) {return Map.of("response", chatModel.call(message));}// 流式响应@GetMapping(value = "/ai/stream", produces = MediaType.TEXT_EVENT_STREAM_VALUE)public Flux<ChatResponse> streamResponse(@RequestParam String message) {return chatModel.stream(new Prompt(message));}
}

动态参数覆盖

// 在请求中动态修改参数
ChatResponse response = chatModel.call(new Prompt("最新的AI技术有哪些？",OpenAiChatOptions.builder().model("llama-3.1-sonar-large-128k-online").temperature(0.5).maxTokens(1024).build()));

注意事项

功能限制
- 不支持OpenAI的toolCalls函数调用机制
- 暂不支持多模态消息（如图像处理）
禁用Embedding服务
在application.properties中添加：
```
spring.ai.openai.embedding.enabled=false
```
速率限制
Perplexity API设有调用频率限制，具体参考官方文档