Merge pull request #272 from MuSan-Li/v3.0.0

fix: 还原 McpAgent 为通用工具调用版本
This commit is contained in:
evo
2026-03-04 16:37:28 +08:00
committed by GitHub

View File

@@ -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);
}