提示词模板与动态构建

PromptTemplate template = new PromptTemplate("""
    推荐适合 {major} 专业大{year}学生的 {count} 门选修课
    """);
template.add("major", "计算机科学");
template.add("year", "二");
template.add("count", "3");
Prompt prompt = template.create();

// RAG 场景的标准模板
PromptTemplate template = new PromptTemplate("""
    基于以下文档内容回答用户问题。
    如果文档中没有相关信息，请明确说明"未找到相关信息"。
    
    相关文档片段：
    {context}
    
    用户问题：{question}
    
    请用中文回答，引用时注明来源页码：
    """);
template.add("context", vectorSearchResult);   // 向量检索结果
template.add("question", userQuestion);
Prompt prompt = template.create();

@RestController
public class CourseRecommendController {

    private final ChatClient chatClient;

    public CourseRecommendController(ChatClient.Builder builder) {
        this.chatClient = builder
                .defaultSystem("你是飞翔科技大学的课程推荐专家。")
                .build();
    }

    @GetMapping("/course-recommend")
    public String recommend(@RequestParam String major,
                            @RequestParam(defaultValue = "二") String year) {
        // 步骤1：准备模板
        PromptTemplate template = new PromptTemplate("""
            请为{major}专业大{year}学生推荐3门选修课。
            
            要求：
            1. 每门课程说明适合什么方向的学生
            2. 列出课程的先修条件
            3. 给出课程编号（格式：DEPT-编号）
            
            请用结构化格式输出。
            """);

        // 步骤2：动态填充参数
        template.add("major", major);
        template.add("year", year);

        // 步骤3：使用模板
        return chatClient.prompt()
                .user(template.create().getInstructions().get(0).getContent())
                .call()
                .content();
    }
}

@Service
public class ProductQAService {

    private final ChatClient chatClient;
    private final VectorStore vectorStore;

    public ProductQAService(ChatClient.Builder builder,
                            VectorStore vectorStore) {
        this.chatClient = builder
                .defaultSystem("你是飞翔科技产品顾问。")
                .build();
        this.vectorStore = vectorStore;
    }

    public String ask(String question) {
        // 1. 从向量库检索相关文档
        List<Document> docs = vectorStore.similaritySearch(
            SearchRequest.builder()
                .query(question)
                .topK(3)
                .build()
        );

        // 2. 拼接检索结果
        String context = docs.stream()
                .map(doc -> doc.getContent() + "（来源：" 
                        + doc.getMetadata().get("source") + "）")
                .collect(Collectors.joining("\n---\n"));

        // 3. 用模板构造 Prompt
        PromptTemplate template = new PromptTemplate("""
            你是飞翔科技的产品顾问。基于以下产品手册内容回答用户问题。
            
            手册相关内容：
            {context}
            
            用户问题：{question}
            
            回答要求：
            - 如果手册中有明确信息，直接引用并注明来源
            - 如果手册中信息不完整，说明哪些是确定的，哪些需要进一步确认
            - 绝对不要编造手册中没有的信息
            """);
        template.add("context", context);
        template.add("question", question);

        // 4. 发送给 LLM
        return chatClient.prompt()
                .user(template.create().getInstructions().get(0).getContent())
                .call()
                .content();
    }
}

// ❌ 错误：忘记填充 {major}
PromptTemplate template = new PromptTemplate("推荐{major}专业的课程");
// 忘记调用 template.add("major", "计算机科学")
Prompt prompt = template.create();
// AI 收到："推荐{major}专业的课程" → 回复"请问你指的是什么专业？"

// ✅ 正确：确保所有占位符已填充
PromptTemplate template = new PromptTemplate("推荐{major}专业的课程");
template.add("major", major);    // 从方法参数获取
Prompt prompt = template.create();

public Prompt createPrompt(String templateStr, Map<String, Object> params) {
    PromptTemplate template = new PromptTemplate(templateStr);
    params.forEach((k, v) -> {
        if (v == null || v.toString().isBlank()) {
            throw new IllegalArgumentException("参数 " + k + " 不能为空");
        }
        template.add(k, v);
    });
    return template.create();
}