LangChain4j 常用注解速查表

LangChain4j 常用注解速查表说明按开发场景分类标注核心用途极简示例适配打印重点注解标红便于快速检索一、AI服务核心注解基础必用AiService - 标记接口为AI服务框架自动生成实现类入口注解示例AiService public interface ChatAssistant { … }SystemMessage - 设定AI角色、规则、语气可加在接口/方法上示例SystemMessage(“专业Java助手回答简洁带代码”)UserMessage - 定义用户提示词模板配合V注入变量示例UserMessage(“解释{{topic}}”) String explain(…)二、提示词模板注解变量填充VVariable - 绑定方法参数到提示词模板{{变量}}给框架用示例V(“text”) String content三、对话记忆/会话注解多轮对话必用MemoryId - 标记会话ID实现多用户对话隔离示例String chat(MemoryId Long userId, String msg)Moderate - 开启内容审核过滤违规输入/输出示例Moderate String chat(String msg)四、AI工具函数调用注解Tool - 标记方法为AI可调用工具需写清晰描述示例Tool(“查询当前天气”) String getWeather(…)PParameter - 描述工具参数让AI理解参数含义给AI用示例P(“城市名称”) String city五、RAG检索增强注解知识库必用Retrieval - 开启检索增强从知识库查询资料可设检索条件示例Retrieval(maxResults 3) String ask(String question)NeedsMemory - 检索时携带对话历史提升回答连贯性示例NeedsMemory Retrieval String chat(String question)六、文档/嵌入Embedding注解FromDocument - 标记参数为文档内容用于向量嵌入示例void embed(FromDocument String content)EmbeddingModel - 指定使用的嵌入模型多模型场景示例EmbeddingModel(“bge-small”) Embedding embed(String text)七、高级控制注解优化AI生成Timeout - 设置AI响应超时时间单位秒示例Timeout(30) String chat(String msg)Temperature - 控制AI生成随机性0严谨1创意示例Temperature(0.2) String writeCode(String task)TopK - 控制生成结果的候选数量影响随机性示例TopK(50) String story(String theme)八、Spring整合专用注解LangChain4jAiService - Spring中注册AI Service为Bean示例LangChain4jAiService(chatModel “openAiChatModel”)ChatModel / EmbeddingModel - 注入指定的模型Bean示例Autowired ChatModel(“openAi”) ChatModel chatModel核心8个必背注解重点标注AiServiceAI服务入口 2. SystemMessage设定角色 3. UserMessage提示词模板 4. V模板填充MemoryId会话隔离 6. Tool定义工具 7. P工具参数描述 8. Retrieval知识库检索关键区别速记• V给框架用填充提示词模板变量• P给AI用描述工具参数含义