From 0130028952f0b597eb2c709bb6f75702f0d72760 Mon Sep 17 00:00:00 2001 From: evo <446796145@qq.com> Date: Wed, 4 Mar 2026 16:34:56 +0800 Subject: [PATCH] =?UTF-8?q?fix:=20=E8=BF=98=E5=8E=9F=20McpAgent=20?= =?UTF-8?q?=E4=B8=BA=E9=80=9A=E7=94=A8=E5=B7=A5=E5=85=B7=E8=B0=83=E7=94=A8?= =?UTF-8?q?=E7=89=88=E6=9C=AC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../main/java/org/ruoyi/agent/McpAgent.java | 45 +++++++++---------- 1 file changed, 20 insertions(+), 25 deletions(-) diff --git a/ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/agent/McpAgent.java b/ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/agent/McpAgent.java index 28d64c4f..fda33dce 100644 --- a/ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/agent/McpAgent.java +++ b/ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/agent/McpAgent.java @@ -8,40 +8,35 @@ import dev.langchain4j.service.V; public interface McpAgent { /** - * 系统提示词:定义智能体身份、核心职责、强制遵守的规则 - * 适配SSE流式特性,明确工具全来自远端MCP服务,仅做代理调用和结果整理 + * 系统提示词:通用工具调用智能体 + * 不限定具体工具类型,让 LangChain4j 自动传递工具描述给 LLM */ @SystemMessage(""" - 你是专业的MCP服务工具代理智能体,核心能力是通过HTTP SSE流式传输协议,调用本地http://localhost:8085/sse地址上MCP服务端注册的所有工具。 - 你的核心工作职责: - 1. 准确理解用户的自然语言请求,判断需要调用MCP服务端的哪一个/哪些工具; - 2. 通过绑定的工具提供者,向MCP服务端发起工具调用请求,传递完整的工具执行参数; - 3. 实时接收MCP服务端通过SSE流式返回的工具执行结果,保证结果片段的完整性; - 4. 将流式结果按原始顺序整理为清晰、易懂的自然语言答案,返回给用户。 + 你是一个AI助手,可以通过调用各种工具来帮助用户完成不同的任务。 - 【强制遵守的核心规则 - 无例外】 - 1. 所有工具调用必须通过远端MCP服务执行,严禁尝试本地执行任何业务逻辑; - 2. 处理SSE流式结果时,严格保留结果片段的返回顺序,不得打乱或遗漏; - 3. 若MCP服务返回错误(如工具未找到、参数错误、执行失败),直接将错误信息友好反馈给用户,无需额外推理; - 4. 工具执行结果若为结构化数据(如JSON、表格),需格式化后返回,提升可读性。 + 【工具使用规则】 + 1. 根据用户的请求,判断需要使用哪些工具 + 2. 仔细阅读每个工具的描述,确保理解工具的功能和参数要求 + 3. 使用正确的参数调用工具 + 4. 如果工具执行失败,向用户友好地说明错误原因,并尝试提供替代方案 + 5. 对于复杂任务,可以分步骤使用多个工具完成 + 6. 将工具执行结果以清晰易懂的方式呈现给用户 + + 【响应格式】 + - 直接回答用户的问题 + - 如果使用了工具,说明使用了什么工具以及结果 + - 如果遇到错误,提供友好的错误信息和解决建议 """) - /** - * 用户消息模板:{{query}}为参数占位符,与方法入参的@V("query")绑定 - */ @UserMessage(""" - 请通过调用MCP服务端的工具,处理用户的以下请求: {{query}} """) + + @Agent("通用工具调用智能体") /** - * 智能体标识:用于日志打印、监控追踪、多智能体协作时的身份识别 - */ - @Agent("MCP服务SSE流式代理智能体-连接本地8085端口") - /** - * 智能体对外调用入口方法 - * @param query 用户的自然语言请求(如:生成订单数据柱状图、查询今日天气) - * @V("query") 将方法入参值绑定到@UserMessage的{{query}}占位符中 - * @return 整理后的MCP工具执行结果(流式结果会自动拼接为完整字符串) + * 智能体对外调用入口 + * @param query 用户的自然语言请求 + * @return 处理结果 */ String callMcpTool(@V("query") String query); }