From 80a6d9236ade191a5de0975abe4de5a6e7e63915 Mon Sep 17 00:00:00 2001
From: zhou zhou <3272660260@qq.com>
Date: 星期四, 19 三月 2026 14:03:10 +0800
Subject: [PATCH] #AI.注释
---
rsf-server/src/main/java/com/vincent/rsf/server/ai/service/impl/BuiltinMcpToolRegistryImpl.java | 24 ++++++++++++++++++++++++
1 files changed, 24 insertions(+), 0 deletions(-)
diff --git a/rsf-server/src/main/java/com/vincent/rsf/server/ai/service/impl/BuiltinMcpToolRegistryImpl.java b/rsf-server/src/main/java/com/vincent/rsf/server/ai/service/impl/BuiltinMcpToolRegistryImpl.java
index 2c4b725..398efba 100644
--- a/rsf-server/src/main/java/com/vincent/rsf/server/ai/service/impl/BuiltinMcpToolRegistryImpl.java
+++ b/rsf-server/src/main/java/com/vincent/rsf/server/ai/service/impl/BuiltinMcpToolRegistryImpl.java
@@ -28,6 +28,11 @@
private final RsfWmsTaskTools rsfWmsTaskTools;
private final RsfWmsBaseTools rsfWmsBaseTools;
+ /**
+ * 鏍￠獙鍐呯疆 MCP 缂栫爜鏄惁鍚堟硶銆�
+ * 褰撳墠鐗堟湰鍙厑璁镐娇鐢ㄦ樉寮忕櫥璁板湪娉ㄥ唽琛ㄤ腑鐨勭紪鐮侊紝鏈煡缂栫爜鐩存帴鎷掔粷锛�
+ * 杩欐牱鍙互纭繚鈥滈〉闈㈠彲閫夐」鈥濆拰鈥滆繍琛屾椂鍙寕杞介」鈥濆缁堜竴鑷淬��
+ */
@Override
public void validateBuiltinCode(String builtinCode) {
if (!StringUtils.hasText(builtinCode)) {
@@ -38,6 +43,10 @@
}
}
+ /**
+ * 鏍规嵁鎸傝浇璁板綍鍒涘缓鍐呯疆宸ュ叿鍥炶皟銆�
+ * 杩欓噷涓嶄細鍋氫换浣曞姩鎬佸彂鐜帮紝鎵�鏈夊伐鍏烽兘蹇呴』缁忚繃鏄惧紡娉ㄥ唽鍜屾不鐞嗙洰褰曟牎楠屽悗鎵嶈兘鏆撮湶缁欐ā鍨嬨��
+ */
@Override
public List<ToolCallback> createToolCallbacks(AiMcpMount mount, Long userId) {
String builtinCode = mount.getBuiltinCode();
@@ -52,6 +61,10 @@
throw new CoolException("涓嶆敮鎸佺殑鍐呯疆 MCP 缂栫爜: " + builtinCode);
}
+ /**
+ * 杩斿洖鏌愪釜鍐呯疆缂栫爜涓嬪彲棰勮鐨勫伐鍏风洰褰曚俊鎭��
+ * 璇ョ洰褰曟瘮杩愯鏃跺洖璋冨浜嗗伐鍏风敤閫斻�佹煡璇㈣竟鐣屽拰绀轰緥鎻愰棶锛屼緵绠＄悊椤靛睍绀恒��
+ */
@Override
public List<AiMcpToolPreviewDto> listBuiltinToolCatalog(String builtinCode) {
validateBuiltinCode(builtinCode);
@@ -62,6 +75,11 @@
}
private List<ToolCallback> createValidatedCallbacks(Object toolBean, String builtinCode) {
+ /**
+ * 鎶� `@Tool` Bean 杞垚 Spring AI ToolCallback锛屽苟寮哄埗鏍￠獙锛�
+ * 1. 宸ュ叿鍚嶅繀椤荤鍚堝懡鍚嶈鑼�
+ * 2. 姣忎釜宸ュ叿閮藉繀椤诲嚭鐜板湪娌荤悊鐩綍閲�
+ */
List<ToolCallback> callbacks = Arrays.asList(ToolCallbacks.from(toolBean));
Map<String, AiMcpToolPreviewDto> catalog = catalogByBuiltinCode(builtinCode);
for (ToolCallback callback : callbacks) {
@@ -80,10 +98,15 @@
}
private List<String> supportedBuiltinCodes() {
+ /** 褰撳墠鐗堟湰鍏佽鎸傝浇鐨勫叏閮ㄥ唴缃� MCP 缂栫爜銆� */
return List.of(AiDefaults.MCP_BUILTIN_RSF_WMS);
}
private Map<String, AiMcpToolPreviewDto> catalogByBuiltinCode(String builtinCode) {
+ /**
+ * 鏋勯�犲唴缃伐鍏锋不鐞嗙洰褰曘��
+ * 杩欓噷鐨勭洰褰曟槸杩愯鏃舵牎楠屽拰绠＄悊绔瑙堢殑鍏卞悓浜嬪疄鏉ユ簮锛屼笉鑳戒笌宸ュ叿瀹炵幇鑴辫妭銆�
+ */
if (AiDefaults.MCP_BUILTIN_RSF_WMS.equals(builtinCode)) {
Map<String, AiMcpToolPreviewDto> catalog = new LinkedHashMap<>();
catalog.put("rsf_query_available_inventory", buildCatalogItem(
@@ -142,6 +165,7 @@
private AiMcpToolPreviewDto buildCatalogItem(String name, String toolGroup, String toolPurpose,
String queryBoundary, List<String> exampleQuestions) {
+ /** 缁熶竴鍒涘缓宸ュ叿鐩綍鏉＄洰锛岄伩鍏嶄笉鍚屽伐鍏风粍鍑虹幇瀛楁椋庢牸涓嶄竴鑷淬�� */
return AiMcpToolPreviewDto.builder()
.name(name)
.toolGroup(toolGroup)
--
Gitblit v1.9.1