{"id":99682,"date":"2026-09-03T00:37:11","date_gmt":"2026-09-02T16:37:11","guid":{"rendered":"https:\/\/www.wsisp.com\/helps\/99682.html"},"modified":"2026-09-03T00:37:11","modified_gmt":"2026-09-02T16:37:11","slug":"agentscope-2-0%ef%bc%9a8-tool-%e5%b7%a5%e5%85%b7%e7%b3%bb%e7%bb%9f%e6%9e%b6%e6%9e%84%e4%b8%8e%e7%94%9f%e4%ba%a7%e7%ba%a7%e5%ae%9e%e8%b7%b5%e6%b7%b1%e5%ba%a6%e8%a7%a3%e6%9e%90","status":"publish","type":"post","link":"https:\/\/www.wsisp.com\/helps\/99682.html","title":{"rendered":"AgentScope 2.0\uff1a8. Tool \u2014\u2014 \u5de5\u5177\u7cfb\u7edf\u67b6\u6784\u4e0e\u751f\u4ea7\u7ea7\u5b9e\u8df5\u6df1\u5ea6\u89e3\u6790"},"content":{"rendered":"<p>\u76ee\u5f55&#xff1a; 1. \u9762\u5411\u751f\u4ea7\u73af\u5883\u7684\u667a\u80fd\u4f53\u5de5\u7a0b\u5e73\u53f0 2. \u5feb\u901f\u4e0a\u624b \u4ece\u96f6\u6784\u5efa\u751f\u4ea7\u7ea7\u667a\u80fd\u4f53 3. Agent \u2014\u2014 \u667a\u80fd\u4f53\u7684\u6838\u5fc3\u62bd\u8c61\u4e0e\u5de5\u7a0b\u5316\u5b9e\u8df5 4. Message &amp; Event \u2014\u2014 \u6d88\u606f\u6a21\u578b\u4e0e\u4e8b\u4ef6\u6d41\u6df1\u5ea6\u89e3 5. Middleware \u2014\u2014 \u65e0\u4fb5\u5165\u5f0f\u667a\u80fd\u4f53\u6269\u5c55\u673a\u5236\u6df1\u5ea6\u89e3\u6790 6. Model \u2014\u2014 \u7edf\u4e00\u6a21\u578b\u63a5\u5165\u5c42\u4e0e\u5bb9\u9519\u673a\u5236\u6df1\u5ea6\u89e3\u6790 7. Permission System \u2014\u2014 \u6743\u9650\u63a7\u5236\u7cfb\u7edf\u6df1\u5ea6\u89e3\u6790 8. Tool \u2014\u2014 \u5de5\u5177\u7cfb\u7edf\u67b6\u6784\u4e0e\u751f\u4ea7\u7ea7\u5b9e\u8df5\u6df1\u5ea6\u89e3\u6790 9. Context \u2014\u2014 \u8fd0\u884c\u65f6\u4e0a\u4e0b\u6587\u4e0e\u72b6\u6001\u7ba1\u7406\u6df1\u5ea6\u89e3\u6790<\/p>\n<h3>\u4e00\u3001\u5f15\u8a00&#xff1a;\u5de5\u5177\u662f\u667a\u80fd\u4f53\u7684&#034;\u624b\u548c\u811a&#034;<\/h3>\n<p>\u6ca1\u6709\u5de5\u5177\u7684 LLM \u53ea\u80fd&#034;\u8bf4&#034;\u3002\u6709\u4e86\u5de5\u5177&#xff0c;\u667a\u80fd\u4f53\u624d\u80fd&#034;\u505a&#034;\u2014\u2014\u67e5\u8be2\u6570\u636e\u5e93\u3001\u8c03\u7528 API\u3001\u6267\u884c\u8ba1\u7b97\u3001\u8bfb\u5199\u6587\u4ef6\u3001\u641c\u7d22\u7f51\u7edc\u3002<\/p>\n<p>\u5728 AgentScope Java 2.0 \u7684\u6784\u5efa\u5757\u4f53\u7cfb\u4e2d&#xff0c;Tool&#xff08;\u5de5\u5177&#xff09; \u662f\u8fde\u63a5\u667a\u80fd\u4f53\u63a8\u7406\u80fd\u529b\u4e0e\u5916\u90e8\u4e16\u754c\u7684\u6267\u884c\u5c42\u3002\u5b98\u65b9\u6587\u6863\u5c06\u5176\u5b9a\u4f4d\u4e3a io.agentscope.core.tool \u5305\u4e0b\u7684\u5b8c\u6574\u5de5\u5177\u6846\u67b6&#xff0c;\u63d0\u4f9b&#xff1a;<\/p>\n<p>\u6ce8\u89e3\u9a71\u52a8\u5b9a\u4e49 \u00d7 \u81ea\u52a8 JSON Schema \u751f\u6210 \u00d7 \u54cd\u5e94\u5f0f\u6267\u884c \u00d7 \u5de5\u5177\u7ec4\u52a8\u6001\u7ba1\u7406 \u00d7 MCP \u534f\u8bae\u96c6\u6210 \u00d7 \u6743\u9650\u7ba1\u63a7 \u00d7 \u6c99\u7bb1\u9694\u79bb<\/p>\n<p>AgentScope Java \u7684\u5de5\u5177\u7cfb\u7edf\u6709\u56db\u4e2a\u663e\u8457\u7279\u70b9&#xff1a;<\/p>\n<ul>\n<li>\u6ce8\u89e3\u9a71\u52a8&#xff1a;&#064;Tool &#043; &#064;ToolParam&#xff0c;\u4e00\u4e2a\u666e\u901a Java \u65b9\u6cd5\u79d2\u53d8\u5de5\u5177<\/li>\n<li>\u54cd\u5e94\u5f0f\u539f\u751f&#xff1a;\u540c\u6b65\u3001\u5f02\u6b65 Mono\u3001\u6d41\u5f0f Flux \u5168\u652f\u6301<\/li>\n<li>\u81ea\u52a8 Schema&#xff1a;\u6846\u67b6\u81ea\u52a8\u751f\u6210 JSON Schema&#xff0c;LLM \u53ef\u4ee5\u76f4\u63a5\u7406\u89e3<\/li>\n<li>\u5de5\u5177\u7ec4\u7ba1\u7406&#xff1a;\u6309\u573a\u666f\u52a8\u6001\u6fc0\u6d3b\/\u505c\u7528\u5de5\u5177 \u672c\u6587\u5c06\u7cfb\u7edf\u89e3\u6790 AgentScope Java 2.0 \u5de5\u5177\u7cfb\u7edf\u7684\u5b8c\u6574\u67b6\u6784\u3002<\/li>\n<\/ul>\n<h3>\u4e8c\u3001\u5de5\u5177\u7cfb\u7edf\u67b6\u6784\u603b\u89c8<\/h3>\n<h4>2.1 \u5206\u5c42\u67b6\u6784<\/h4>\n<p>\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<br \/>\n\u2502                        Agent \u5c42                                   \u2502<br \/>\n\u2502   ReActAgent \/ HarnessAgent                                     \u2502<br \/>\n\u2502   \u5728 ReAct \u5faa\u73af\u4e2d\u81ea\u4e3b\u51b3\u5b9a\u8c03\u7528\u54ea\u4e2a\u5de5\u5177\u3001\u4f55\u65f6\u8c03\u7528                     \u2502<br \/>\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<br \/>\n                               \u2502<br \/>\n                               \u25bc<br \/>\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<br \/>\n\u2502                     Toolkit&#xff08;\u5de5\u5177\u7f16\u6392\u4e2d\u5fc3&#xff09;                        \u2502<br \/>\n\u2502   \u6ce8\u518c\u5168\u91cf\u5de5\u5177 \u2192 toolFilter \u8fc7\u6ee4 \u2192 \u751f\u6210 JSON Schema \u2192 \u5206\u53d1\u7ed9\u6a21\u578b  \u2502<br \/>\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<br \/>\n                               \u2502<br \/>\n                               \u25bc<br \/>\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<br \/>\n\u2502                     ToolGroup&#xff08;\u5de5\u5177\u5206\u7ec4&#xff09;                          \u2502<br \/>\n\u2502   \u6309\u57df\u7ec4\u7ec7\u5de5\u5177&#xff0c;\u652f\u6301\u52a8\u6001\u6fc0\u6d3b\/\u505c\u7528                                   \u2502<br \/>\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<br \/>\n                               \u2502<br \/>\n                               \u25bc<br \/>\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<br \/>\n\u2502                     ToolBase&#xff08;\u5de5\u5177\u57fa\u7c7b&#xff09;                           \u2502<br \/>\n\u2502   \u7edf\u4e00\u62bd\u8c61&#xff1a;\u540d\u79f0\u3001\u63cf\u8ff0\u3001\u53c2\u6570 Schema\u3001\u6267\u884c\u903b\u8f91\u3001\u5b89\u5168\u68c0\u67e5             \u2502<br \/>\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<br \/>\n                               \u2502<br \/>\n              \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<br \/>\n              \u25bc                \u25bc                \u25bc<br \/>\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<br \/>\n\u2502  ReflectiveTool  \u2502 \u2502   \u5185\u7f6e\u5de5\u5177        \u2502 \u2502   MCP \u5de5\u5177       \u2502<br \/>\n\u2502  (&#064;Tool \u6ce8\u89e3)    \u2502 \u2502  Bash\/Read\/Write \u2502 \u2502  \u5916\u90e8 MCP Server \u2502<br \/>\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<\/p>\n<h4>2.2 \u6838\u5fc3\u7ec4\u4ef6\u5173\u7cfb<\/h4>\n<table>\n<tr>\u7ec4\u4ef6\u804c\u8d23\u5305\u8def\u5f84<\/tr>\n<tbody>\n<tr>\n<td>&#064;Tool \/ &#064;ToolParam<\/td>\n<td>\u6ce8\u89e3\u9a71\u52a8\u7684\u5de5\u5177\u5b9a\u4e49<\/td>\n<td>io.agentscope.core.tool<\/td>\n<\/tr>\n<tr>\n<td>Toolkit<\/td>\n<td>\u5de5\u5177\u6ce8\u518c\u3001\u7f16\u6392\u3001Schema \u751f\u6210<\/td>\n<td>io.agentscope.core.tool<\/td>\n<\/tr>\n<tr>\n<td>ToolGroup<\/td>\n<td>\u6309\u57df\u5206\u7ec4\u3001\u52a8\u6001\u6fc0\u6d3b<\/td>\n<td>io.agentscope.core.tool<\/td>\n<\/tr>\n<tr>\n<td>ToolBase \/ AgentTool<\/td>\n<td>\u5de5\u5177\u7edf\u4e00\u62bd\u8c61\u57fa\u7c7b<\/td>\n<td>io.agentscope.core.tool<\/td>\n<\/tr>\n<tr>\n<td>ReflectiveFunctionTool<\/td>\n<td>\u6ce8\u89e3 \u2192 \u53ef\u6267\u884c\u5de5\u5177\u7684\u9002\u914d\u5668<\/td>\n<td>io.agentscope.core.tool<\/td>\n<\/tr>\n<tr>\n<td>ToolsConfig<\/td>\n<td>\u5de5\u5177\u8fc7\u6ee4\u914d\u7f6e&#xff08;allow\/deny&#xff09;<\/td>\n<td>io.agentscope.harness.agent.tools<\/td>\n<\/tr>\n<tr>\n<td>\u5185\u7f6e\u5de5\u5177\u96c6<\/td>\n<td>Bash\/Read\/Write\/Edit\/Glob\/Grep\/Skill<\/td>\n<td>io.agentscope.harness.tools<\/td>\n<\/tr>\n<tr>\n<td>MCP \u96c6\u6210<\/td>\n<td>\u5916\u90e8 MCP Server \u5de5\u5177\u53d1\u73b0<\/td>\n<td>io.agentscope.core.tool.mcp<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>\u4e09\u3001\u6ce8\u89e3\u9a71\u52a8&#xff1a;&#064;Tool &#043; &#064;ToolParam<\/h3>\n<h4>3.1 \u57fa\u672c\u5b9a\u4e49<\/h4>\n<p>AgentScope 2.0 \u91c7\u7528\u6ce8\u89e3\u9a71\u52a8\u65b9\u5f0f\u5b9a\u4e49\u5de5\u5177&#xff0c;\u5f00\u53d1\u8005\u53ea\u9700\u5728\u666e\u901a Java \u65b9\u6cd5\u4e0a\u6dfb\u52a0\u6ce8\u89e3&#xff0c;\u6846\u67b6\u81ea\u52a8\u5b8c\u6210&#xff1a;<\/p>\n<ul>\n<li>\u65b9\u6cd5\u7b7e\u540d\u89e3\u6790<\/li>\n<li>JSON Schema \u751f\u6210<\/li>\n<li>\u53c2\u6570\u7c7b\u578b\u6620\u5c04<\/li>\n<li>\u5de5\u5177\u6ce8\u518c<\/li>\n<\/ul>\n<p><span class=\"token keyword\">import<\/span> <span class=\"token import\"><span class=\"token namespace\">io<span class=\"token punctuation\">.<\/span>agentscope<span class=\"token punctuation\">.<\/span>core<span class=\"token punctuation\">.<\/span>tool<span class=\"token punctuation\">.<\/span><\/span><span class=\"token class-name\">Tool<\/span><\/span><span class=\"token punctuation\">;<\/span><br \/>\n<span class=\"token keyword\">import<\/span> <span class=\"token import\"><span class=\"token namespace\">io<span class=\"token punctuation\">.<\/span>agentscope<span class=\"token punctuation\">.<\/span>core<span class=\"token punctuation\">.<\/span>tool<span class=\"token punctuation\">.<\/span><\/span><span class=\"token class-name\">ToolParam<\/span><\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p><span class=\"token keyword\">public<\/span> <span class=\"token keyword\">class<\/span> <span class=\"token class-name\">WeatherTools<\/span> <span class=\"token punctuation\">{<\/span><\/p>\n<p>    <span class=\"token annotation punctuation\">&#064;Tool<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;get_weather&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u83b7\u53d6\u6307\u5b9a\u57ce\u5e02\u7684\u5f53\u524d\u5929\u6c14\u4fe1\u606f&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token keyword\">public<\/span> <span class=\"token class-name\">String<\/span> <span class=\"token function\">getWeather<\/span><span class=\"token punctuation\">(<\/span><br \/>\n            <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;city&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u57ce\u5e02\u540d\u79f0&#xff0c;\u5982&#xff1a;\u5317\u4eac\u3001\u4e0a\u6d77&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token class-name\">String<\/span> city<span class=\"token punctuation\">,<\/span><br \/>\n            <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;unit&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u6e29\u5ea6\u5355\u4f4d&#xff1a;celsius \u6216 fahrenheit&#034;<\/span><span class=\"token punctuation\">,<\/span> required <span class=\"token operator\">&#061;<\/span> <span class=\"token boolean\">false<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token class-name\">String<\/span> unit<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><\/p>\n<p>        <span class=\"token comment\">\/\/ \u5b9e\u9645\u4e1a\u52a1\u903b\u8f91<\/span><br \/>\n        <span class=\"token keyword\">return<\/span> <span class=\"token class-name\">String<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">format<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;%s&#xff1a;\u6674\u5929&#xff0c;\u6c14\u6e29 25\u2103&#034;<\/span><span class=\"token punctuation\">,<\/span> city<span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n    <span class=\"token punctuation\">}<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<h4>3.2 \u81ea\u52a8\u751f\u6210\u7684 JSON Schema<\/h4>\n<p>\u6846\u67b6\u901a\u8fc7\u53cd\u5c04\u81ea\u52a8\u5c06\u4e0a\u8ff0\u65b9\u6cd5\u8f6c\u6362\u4e3a LLM \u53ef\u7406\u89e3\u7684 JSON Schema&#xff1a;<\/p>\n<p><span class=\"token punctuation\">{<\/span><br \/>\n  <span class=\"token string-property property\">&#034;type&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token string\">&#034;function&#034;<\/span><span class=\"token punctuation\">,<\/span><br \/>\n  <span class=\"token string-property property\">&#034;function&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n    <span class=\"token string-property property\">&#034;name&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token string\">&#034;get_weather&#034;<\/span><span class=\"token punctuation\">,<\/span><br \/>\n    <span class=\"token string-property property\">&#034;description&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token string\">&#034;\u83b7\u53d6\u6307\u5b9a\u57ce\u5e02\u7684\u5f53\u524d\u5929\u6c14\u4fe1\u606f&#034;<\/span><span class=\"token punctuation\">,<\/span><br \/>\n    <span class=\"token string-property property\">&#034;parameters&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n      <span class=\"token string-property property\">&#034;type&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token string\">&#034;object&#034;<\/span><span class=\"token punctuation\">,<\/span><br \/>\n      <span class=\"token string-property property\">&#034;properties&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n        <span class=\"token string-property property\">&#034;city&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n          <span class=\"token string-property property\">&#034;type&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token string\">&#034;string&#034;<\/span><span class=\"token punctuation\">,<\/span><br \/>\n          <span class=\"token string-property property\">&#034;description&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token string\">&#034;\u57ce\u5e02\u540d\u79f0&#xff0c;\u5982&#xff1a;\u5317\u4eac\u3001\u4e0a\u6d77&#034;<\/span><br \/>\n        <span class=\"token punctuation\">}<\/span><span class=\"token punctuation\">,<\/span><br \/>\n        <span class=\"token string-property property\">&#034;unit&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n          <span class=\"token string-property property\">&#034;type&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token string\">&#034;string&#034;<\/span><span class=\"token punctuation\">,<\/span><br \/>\n          <span class=\"token string-property property\">&#034;description&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token string\">&#034;\u6e29\u5ea6\u5355\u4f4d&#xff1a;celsius \u6216 fahrenheit&#034;<\/span><br \/>\n        <span class=\"token punctuation\">}<\/span><br \/>\n      <span class=\"token punctuation\">}<\/span><span class=\"token punctuation\">,<\/span><br \/>\n      <span class=\"token string-property property\">&#034;required&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">[<\/span><span class=\"token string\">&#034;city&#034;<\/span><span class=\"token punctuation\">]<\/span><br \/>\n    <span class=\"token punctuation\">}<\/span><br \/>\n  <span class=\"token punctuation\">}<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<p>\u6838\u5fc3\u4ef7\u503c&#xff1a;\u5f00\u53d1\u8005\u65e0\u9700\u624b\u52a8\u7f16\u5199 JSON Schema&#xff0c;\u6846\u67b6\u81ea\u52a8\u751f\u6210&#xff0c;LLM \u53ef\u4ee5\u76f4\u63a5\u7406\u89e3\u5e76\u8c03\u7528\u3002<\/p>\n<h4>3.3 \u652f\u6301\u7684\u8fd4\u56de\u7c7b\u578b<\/h4>\n<table>\n<tr>\u8fd4\u56de\u7c7b\u578b\u8bf4\u660e\u9002\u7528\u573a\u666f<\/tr>\n<tbody>\n<tr>\n<td>String<\/td>\n<td>\u540c\u6b65\u8fd4\u56de\u6587\u672c\u7ed3\u679c<\/td>\n<td>\u7b80\u5355\u67e5\u8be2<\/td>\n<\/tr>\n<tr>\n<td>Mono<\/td>\n<td>\u5f02\u6b65\u8fd4\u56de<\/td>\n<td>\u7f51\u7edc\u8bf7\u6c42\u3001\u6570\u636e\u5e93\u67e5\u8be2<\/td>\n<\/tr>\n<tr>\n<td>Flux<\/td>\n<td>\u6d41\u5f0f\u8fd4\u56de<\/td>\n<td>\u5927\u6587\u4ef6\u8bfb\u53d6\u3001\u5b9e\u65f6\u6570\u636e<\/td>\n<\/tr>\n<tr>\n<td>byte[]<\/td>\n<td>\u4e8c\u8fdb\u5236\u6570\u636e<\/td>\n<td>\u56fe\u7247\u3001\u6587\u4ef6\u4e0b\u8f7d<\/td>\n<\/tr>\n<tr>\n<td>\u81ea\u5b9a\u4e49\u5bf9\u8c61<\/td>\n<td>\u81ea\u52a8\u5e8f\u5217\u5316\u4e3a<\/td>\n<td>JSON \u7ed3\u6784\u5316\u6570\u636e<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h4>3.4 \u5f02\u6b65\u5de5\u5177\u793a\u4f8b<\/h4>\n<p><span class=\"token annotation punctuation\">&#064;Tool<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;search_database&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u5728\u6570\u636e\u5e93\u4e2d\u641c\u7d22\u8bb0\u5f55&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n<span class=\"token keyword\">public<\/span> <span class=\"token class-name\">Mono<\/span><span class=\"token generics\"><span class=\"token punctuation\">&lt;<\/span><span class=\"token class-name\">String<\/span><span class=\"token punctuation\">&gt;<\/span><\/span> <span class=\"token function\">searchDatabase<\/span><span class=\"token punctuation\">(<\/span><br \/>\n        <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;query&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u641c\u7d22\u5173\u952e\u8bcd&#034;<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">String<\/span> query<span class=\"token punctuation\">,<\/span><br \/>\n        <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;table&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u76ee\u6807\u8868\u540d&#034;<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">String<\/span> table<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><\/p>\n<p>    <span class=\"token keyword\">return<\/span> <span class=\"token class-name\">Mono<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">fromCallable<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token operator\">-&gt;<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n        <span class=\"token comment\">\/\/ \u5f02\u6b65\u6570\u636e\u5e93\u67e5\u8be2<\/span><br \/>\n        <span class=\"token class-name\">List<\/span><span class=\"token generics\"><span class=\"token punctuation\">&lt;<\/span><span class=\"token class-name\">Record<\/span><span class=\"token punctuation\">&gt;<\/span><\/span> results <span class=\"token operator\">&#061;<\/span> dbService<span class=\"token punctuation\">.<\/span><span class=\"token function\">search<\/span><span class=\"token punctuation\">(<\/span>table<span class=\"token punctuation\">,<\/span> query<span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n        <span class=\"token keyword\">return<\/span> <span class=\"token function\">formatResults<\/span><span class=\"token punctuation\">(<\/span>results<span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n    <span class=\"token punctuation\">}<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">subscribeOn<\/span><span class=\"token punctuation\">(<\/span><span class=\"token class-name\">Schedulers<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">boundedElastic<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<h4>3.5 \u4e0a\u4e0b\u6587\u6ce8\u5165<\/h4>\n<p>\u5de5\u5177\u65b9\u6cd5\u53ef\u4ee5\u6ce8\u5165\u8fd0\u884c\u65f6\u4e0a\u4e0b\u6587\u4fe1\u606f&#xff1a;<\/p>\n<p><span class=\"token annotation punctuation\">&#064;Tool<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;get_user_orders&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u83b7\u53d6\u5f53\u524d\u7528\u6237\u7684\u8ba2\u5355\u5217\u8868&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n<span class=\"token keyword\">public<\/span> <span class=\"token class-name\">String<\/span> <span class=\"token function\">getUserOrders<\/span><span class=\"token punctuation\">(<\/span><br \/>\n        <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;status&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u8ba2\u5355\u72b6\u6001\u8fc7\u6ee4&#034;<\/span><span class=\"token punctuation\">,<\/span> required <span class=\"token operator\">&#061;<\/span> <span class=\"token boolean\">false<\/span><span class=\"token punctuation\">)<\/span><br \/>\n        <span class=\"token class-name\">String<\/span> status<span class=\"token punctuation\">,<\/span><br \/>\n        <span class=\"token class-name\">RuntimeContext<\/span> ctx<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span>  <span class=\"token comment\">\/\/ \u81ea\u52a8\u6ce8\u5165&#xff0c;\u4e0d\u66b4\u9732\u7ed9 LLM<\/span><\/p>\n<p>    <span class=\"token class-name\">String<\/span> userId <span class=\"token operator\">&#061;<\/span> ctx<span class=\"token punctuation\">.<\/span><span class=\"token function\">getUserId<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n    <span class=\"token keyword\">return<\/span> orderService<span class=\"token punctuation\">.<\/span><span class=\"token function\">getOrders<\/span><span class=\"token punctuation\">(<\/span>userId<span class=\"token punctuation\">,<\/span> status<span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">toString<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<p>\u8bbe\u8ba1\u7cbe\u5999\u4e4b\u5904&#xff1a;RuntimeContext \u53c2\u6570\u4e0d\u4f1a\u51fa\u73b0\u5728 JSON Schema \u4e2d&#xff0c;LLM \u4e0d\u77e5\u9053\u5b83\u7684\u5b58\u5728&#xff0c;\u4f46\u5de5\u5177\u6267\u884c\u65f6\u53ef\u4ee5\u83b7\u53d6\u5f53\u524d\u7528\u6237\u3001\u4f1a\u8bdd\u7b49\u4e0a\u4e0b\u6587\u4fe1\u606f\u3002<\/p>\n<h3>\u56db\u3001Toolkit&#xff1a;\u5de5\u5177\u7f16\u6392\u4e2d\u5fc3<\/h3>\n<h4>4.1 \u6838\u5fc3\u804c\u8d23<\/h4>\n<p>Toolkit \u662f\u5de5\u5177\u7cfb\u7edf\u7684\u7f16\u6392\u4e2d\u5fc3&#xff0c;\u8d1f\u8d23&#xff1a;<\/p>\n<li>\u6ce8\u518c\u6240\u6709\u5de5\u5177&#xff08;Java \u5de5\u5177 &#043; MCP \u5de5\u5177&#xff09;<\/li>\n<li>\u751f\u6210\u5de5\u5177\u63cf\u8ff0\u5217\u8868&#xff08;JSON Schema&#xff09;<\/li>\n<li>\u6839\u636e toolFilter \u8fc7\u6ee4\u53ef\u89c1\u5de5\u5177<\/li>\n<li>\u5206\u53d1\u5de5\u5177\u8c03\u7528\u8bf7\u6c42<\/li>\n<li>\u7ba1\u7406\u5de5\u5177\u751f\u547d\u5468\u671f<\/li>\n<h4>4.2 \u6ce8\u518c\u4e0e\u4f7f\u7528<\/h4>\n<p><span class=\"token comment\">\/\/ \u521b\u5efa Toolkit \u5e76\u6ce8\u518c\u5de5\u5177<\/span><br \/>\n<span class=\"token class-name\">Toolkit<\/span> toolkit <span class=\"token operator\">&#061;<\/span> <span class=\"token keyword\">new<\/span> <span class=\"token class-name\">Toolkit<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\ntoolkit<span class=\"token punctuation\">.<\/span><span class=\"token function\">registerTool<\/span><span class=\"token punctuation\">(<\/span><span class=\"token keyword\">new<\/span> <span class=\"token class-name\">WeatherTools<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\ntoolkit<span class=\"token punctuation\">.<\/span><span class=\"token function\">registerTool<\/span><span class=\"token punctuation\">(<\/span><span class=\"token keyword\">new<\/span> <span class=\"token class-name\">DatabaseTools<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\ntoolkit<span class=\"token punctuation\">.<\/span><span class=\"token function\">registerTool<\/span><span class=\"token punctuation\">(<\/span><span class=\"token keyword\">new<\/span> <span class=\"token class-name\">FileOperationTools<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p><span class=\"token comment\">\/\/ \u6784\u5efa Agent \u65f6\u4f20\u5165 Toolkit<\/span><br \/>\n<span class=\"token class-name\">ReActAgent<\/span> agent <span class=\"token operator\">&#061;<\/span> <span class=\"token class-name\">ReActAgent<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">builder<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">name<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;assistant&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">model<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;dashscope:qwen-plus&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">sysPrompt<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;\u4f60\u662f\u4e00\u4e2a\u5168\u80fd\u52a9\u624b\u3002&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">toolkit<\/span><span class=\"token punctuation\">(<\/span>toolkit<span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">build<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p>4.3 \u5de5\u5177\u8c03\u7528\u6d41\u7a0b<\/p>\n<p>\u7528\u6237\u6d88\u606f\u5230\u8fbe<br \/>\n    \u2502<br \/>\n    \u25bc<br \/>\nAgent \u63a8\u7406&#xff08;Reasoning&#xff09;<br \/>\n    \u2502<br \/>\n    \u25bc \u6a21\u578b\u51b3\u5b9a\u8c03\u7528\u5de5\u5177<br \/>\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<br \/>\n\u2502  Toolkit.execute(toolUseBlock)                           \u2502<br \/>\n\u2502                                                          \u2502<br \/>\n\u2502  1. \u6839\u636e toolName \u67e5\u627e\u5df2\u6ce8\u518c\u5de5\u5177                          \u2502<br \/>\n\u2502  2. \u6743\u9650\u68c0\u67e5&#xff08;PermissionEngine&#xff09;                          \u2502<br \/>\n\u2502  3. \u53c2\u6570\u53cd\u5e8f\u5217\u5316&#xff08;JSON \u2192 Java \u5bf9\u8c61&#xff09;                      \u2502<br \/>\n\u2502  4. \u8c03\u7528\u5de5\u5177\u65b9\u6cd5                                         \u2502<br \/>\n\u2502  5. \u7ed3\u679c\u5e8f\u5217\u5316&#xff08;Java \u5bf9\u8c61 \u2192 String\/JSON&#xff09;                 \u2502<br \/>\n\u2502  6. \u8fd4\u56de ToolResultBlock                                 \u2502<br \/>\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<br \/>\n    \u2502<br \/>\n    \u25bc<br \/>\nAgent \u7ee7\u7eed\u63a8\u7406&#xff08;\u4e0b\u4e00\u8f6e Reasoning&#xff09;<\/p>\n<h4>4.4 \u5de5\u5177\u6279\u5904\u7406&#xff08;_ToolCallBatch&#xff09;<\/h4>\n<p>\u5f53\u6a21\u578b\u5728\u4e00\u8f6e\u63a8\u7406\u4e2d\u540c\u65f6\u8bf7\u6c42\u8c03\u7528\u591a\u4e2a\u5de5\u5177\u65f6&#xff0c;Toolkit \u652f\u6301\u5e76\u53d1\u6279\u5904\u7406&#xff1a;<\/p>\n<p>\u6a21\u578b\u8f93\u51fa: [ToolUseBlock_1, ToolUseBlock_2, ToolUseBlock_3]<br \/>\n    \u2502<br \/>\n    \u25bc<br \/>\nToolkit.executeBatch()<br \/>\n    \u2502<br \/>\n    \u251c\u2500\u2500 \u5e76\u53d1\u6267\u884c Tool_1 \u2500\u2500\u2192 Result_1<br \/>\n    \u251c\u2500\u2500 \u5e76\u53d1\u6267\u884c Tool_2 \u2500\u2500\u2192 Result_2<br \/>\n    \u2514\u2500\u2500 \u5e76\u53d1\u6267\u884c Tool_3 \u2500\u2500\u2192 Result_3<br \/>\n    \u2502<br \/>\n    \u25bc<br \/>\n\u5408\u5e76\u4e3a [ToolResultBlock_1, ToolResultBlock_2, ToolResultBlock_3]<\/p>\n<p>\u751f\u4ea7\u610f\u4e49&#xff1a;\u5e76\u53d1\u6267\u884c\u663e\u8457\u51cf\u5c11\u591a\u5de5\u5177\u8c03\u7528\u573a\u666f\u7684\u603b\u8017\u65f6&#xff0c;\u4ece\u4e32\u884c\u7684 T1&#043;T2&#043;T3 \u964d\u4f4e\u4e3a max(T1,T2,T3)\u3002<\/p>\n<h3>\u4e94\u3001ToolGroup&#xff1a;\u6309\u57df\u7ec4\u7ec7\u4e0e\u52a8\u6001\u6fc0\u6d3b<\/h3>\n<h4>5.1 \u8bbe\u8ba1\u52a8\u673a<\/h4>\n<p>\u5728\u5b9e\u9645\u4e1a\u52a1\u4e2d&#xff0c;\u4e00\u4e2a Agent \u53ef\u80fd\u6ce8\u518c\u4e86 20&#043; \u4e2a\u5de5\u5177&#xff0c;\u4f46\u4e0d\u540c\u573a\u666f\u4e0b\u53ea\u9700\u8981\u6fc0\u6d3b\u5176\u4e2d\u4e00\u90e8\u5206&#xff1a;<\/p>\n<ul>\n<li>\u5ba2\u670d\u573a\u666f&#xff1a;\u53ea\u9700\u8ba2\u5355\u67e5\u8be2\u3001\u7269\u6d41\u8ffd\u8e2a<\/li>\n<li>\u8fd0\u7ef4\u573a\u666f&#xff1a;\u9700\u8981\u670d\u52a1\u5668\u76d1\u63a7\u3001\u65e5\u5fd7\u67e5\u8be2<\/li>\n<li>\u5f00\u53d1\u573a\u666f&#xff1a;\u9700\u8981\u4ee3\u7801\u641c\u7d22\u3001\u6587\u4ef6\u7f16\u8f91<\/li>\n<\/ul>\n<h4>5.2 ToolGroup \u5b9a\u4e49<\/h4>\n<p><span class=\"token comment\">\/\/ \u5b9a\u4e49\u5de5\u5177\u7ec4<\/span><br \/>\n<span class=\"token class-name\">ToolGroup<\/span> customerServiceGroup <span class=\"token operator\">&#061;<\/span> <span class=\"token class-name\">ToolGroup<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">builder<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">name<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;customer-service&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">description<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;\u5ba2\u670d\u76f8\u5173\u5de5\u5177&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">tools<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;query_order&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;track_logistics&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;refund_request&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">build<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p><span class=\"token class-name\">ToolGroup<\/span> devOpsGroup <span class=\"token operator\">&#061;<\/span> <span class=\"token class-name\">ToolGroup<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">builder<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">name<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;devops&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">description<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;\u8fd0\u7ef4\u76f8\u5173\u5de5\u5177&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">tools<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;check_server&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;query_logs&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;restart_service&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">build<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p><span class=\"token comment\">\/\/ \u6ce8\u518c\u5230 Toolkit<\/span><br \/>\ntoolkit<span class=\"token punctuation\">.<\/span><span class=\"token function\">registerGroup<\/span><span class=\"token punctuation\">(<\/span>customerServiceGroup<span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\ntoolkit<span class=\"token punctuation\">.<\/span><span class=\"token function\">registerGroup<\/span><span class=\"token punctuation\">(<\/span>devOpsGroup<span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<h4>5.3 \u52a8\u6001\u6fc0\u6d3b\/\u505c\u7528<\/h4>\n<p><span class=\"token comment\">\/\/ \u8fd0\u884c\u65f6\u52a8\u6001\u5207\u6362\u5de5\u5177\u7ec4<\/span><br \/>\ntoolkit<span class=\"token punctuation\">.<\/span><span class=\"token function\">activateGroup<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;customer-service&#034;<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\ntoolkit<span class=\"token punctuation\">.<\/span><span class=\"token function\">deactivateGroup<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;devops&#034;<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p><span class=\"token comment\">\/\/ Agent \u6b64\u65f6\u53ea\u80fd\u770b\u5230\u5ba2\u670d\u5de5\u5177<\/span><br \/>\n<span class=\"token comment\">\/\/ \u6a21\u578b\u4e0d\u4f1a\u6536\u5230 devops \u5de5\u5177\u7684\u63cf\u8ff0<\/span><\/p>\n<h4>5.4 Agent \u81ea\u4e3b\u7ba1\u7406\u5de5\u5177\u7ec4<\/h4>\n<p>AgentScope 2.0 \u652f\u6301 Agent \u81ea\u4e3b\u51b3\u5b9a\u6fc0\u6d3b\/\u505c\u7528\u5de5\u5177\u7ec4&#xff1a;<\/p>\n<p><span class=\"token comment\">\/\/ \u5185\u7f6e\u5143\u5de5\u5177&#xff1a;ResetTools<\/span><br \/>\n<span class=\"token comment\">\/\/ Agent \u53ef\u4ee5\u901a\u8fc7\u8c03\u7528 reset_tools \u5de5\u5177\u6765\u5207\u6362\u81ea\u5df1\u7684\u5de5\u5177\u96c6<\/span><br \/>\n<span class=\"token annotation punctuation\">&#064;Tool<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;reset_tools&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u5207\u6362\u5f53\u524d\u53ef\u7528\u7684\u5de5\u5177\u7ec4&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n<span class=\"token keyword\">public<\/span> <span class=\"token class-name\">String<\/span> <span class=\"token function\">resetTools<\/span><span class=\"token punctuation\">(<\/span><br \/>\n        <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;group_name&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u8981\u6fc0\u6d3b\u7684\u5de5\u5177\u7ec4\u540d\u79f0&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n        <span class=\"token class-name\">String<\/span> groupName<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n    toolkit<span class=\"token punctuation\">.<\/span><span class=\"token function\">activateGroup<\/span><span class=\"token punctuation\">(<\/span>groupName<span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n    <span class=\"token keyword\">return<\/span> <span class=\"token string\">&#034;\u5df2\u5207\u6362\u5230\u5de5\u5177\u7ec4: &#034;<\/span> <span class=\"token operator\">&#043;<\/span> groupName<span class=\"token punctuation\">;<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<p>\u8bbe\u8ba1\u54f2\u5b66&#xff1a;\u8ba9\u6a21\u578b\u81ea\u5df1\u51b3\u5b9a\u9700\u8981\u4ec0\u4e48\u80fd\u529b&#xff0c;\u800c\u975e\u6846\u67b6\u5f3a\u5236\u7f16\u6392\u3002<\/p>\n<h3>\u516d\u3001\u5185\u7f6e\u5de5\u5177\u96c6\u8be6\u89e3<\/h3>\n<h3>6.1 \u5de5\u5177\u5168\u666f<\/h3>\n<p>AgentScope Java 2.0 \u901a\u8fc7 HarnessAgent \u63d0\u4f9b\u4e86\u4e00\u5957\u5f00\u7bb1\u5373\u7528\u7684\u5185\u7f6e\u5de5\u5177&#xff1a;<\/p>\n<table>\n<tr>\u5de5\u5177\u529f\u80fd\u6743\u9650\u7ea7\u522b<\/tr>\n<tbody>\n<tr>\n<td>Bash<\/td>\n<td>\u6267\u884c Shell \u547d\u4ee4<\/td>\n<td>\u9ad8\u5371&#xff08;\u9700\u6743\u9650\u7ba1\u63a7&#xff09;<\/td>\n<\/tr>\n<tr>\n<td>Read<\/td>\n<td>\u8bfb\u53d6\u6587\u4ef6\u5185\u5bb9<\/td>\n<td>\u4f4e\u5371<\/td>\n<\/tr>\n<tr>\n<td>Write<\/td>\n<td>\u5199\u5165\u6587\u4ef6<\/td>\n<td>\u4e2d\u5371<\/td>\n<\/tr>\n<tr>\n<td>Edit<\/td>\n<td>\u7f16\u8f91\u6587\u4ef6&#xff08;\u7cbe\u786e\u66ff\u6362&#xff09;<\/td>\n<td>\u4e2d\u5371<\/td>\n<\/tr>\n<tr>\n<td>Glob<\/td>\n<td>\u6587\u4ef6\u540d\u6a21\u5f0f\u5339\u914d<\/td>\n<td>\u4f4e\u5371<\/td>\n<\/tr>\n<tr>\n<td>Grep<\/td>\n<td>\u6587\u4ef6\u5185\u5bb9\u641c\u7d22<\/td>\n<td>\u4f4e\u5371<\/td>\n<\/tr>\n<tr>\n<td>Skill<\/td>\n<td>\u67e5\u770b\u53ef\u7528\u6280\u80fd<\/td>\n<td>\u4f4e\u5371<\/td>\n<\/tr>\n<tr>\n<td>ResetTools<\/td>\n<td>\u5207\u6362\u5de5\u5177\u7ec4&#xff08;\u5143\u5de5\u5177&#xff09;<\/td>\n<td>\u4e2d\u5371<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h4>6.2 Bash \u5de5\u5177&#xff1a;\u6700\u590d\u6742\u7684\u6743\u9650\u68c0\u67e5<\/h4>\n<p><span class=\"token keyword\">public<\/span> <span class=\"token keyword\">class<\/span> <span class=\"token class-name\">BashTool<\/span> <span class=\"token keyword\">extends<\/span> <span class=\"token class-name\">ToolBase<\/span> <span class=\"token punctuation\">{<\/span><\/p>\n<p>    <span class=\"token annotation punctuation\">&#064;Override<\/span><br \/>\n    <span class=\"token keyword\">public<\/span> <span class=\"token class-name\">ToolResult<\/span> <span class=\"token function\">execute<\/span><span class=\"token punctuation\">(<\/span><span class=\"token class-name\">Map<\/span><span class=\"token generics\"><span class=\"token punctuation\">&lt;<\/span><span class=\"token class-name\">String<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token class-name\">Object<\/span><span class=\"token punctuation\">&gt;<\/span><\/span> input<span class=\"token punctuation\">,<\/span> <span class=\"token class-name\">ToolContext<\/span> ctx<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n        <span class=\"token class-name\">String<\/span> command <span class=\"token operator\">&#061;<\/span> <span class=\"token punctuation\">(<\/span><span class=\"token class-name\">String<\/span><span class=\"token punctuation\">)<\/span> input<span class=\"token punctuation\">.<\/span><span class=\"token function\">get<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;command&#034;<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p>        <span class=\"token comment\">\/\/ 1. \u5185\u7f6e\u5b89\u5168\u68c0\u67e5&#xff08;\u4e0d\u53ef\u7ed5\u8fc7&#xff09;<\/span><br \/>\n        <span class=\"token class-name\">SecurityCheckResult<\/span> check <span class=\"token operator\">&#061;<\/span> <span class=\"token function\">validateCommand<\/span><span class=\"token punctuation\">(<\/span>command<span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n        <span class=\"token keyword\">if<\/span> <span class=\"token punctuation\">(<\/span><span class=\"token operator\">!<\/span>check<span class=\"token punctuation\">.<\/span><span class=\"token function\">isSafe<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n            <span class=\"token keyword\">return<\/span> <span class=\"token class-name\">ToolResult<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">error<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;\u547d\u4ee4\u88ab\u5b89\u5168\u7b56\u7565\u62e6\u622a: &#034;<\/span> <span class=\"token operator\">&#043;<\/span> check<span class=\"token punctuation\">.<\/span><span class=\"token function\">getReason<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n        <span class=\"token punctuation\">}<\/span><\/p>\n<p>        <span class=\"token comment\">\/\/ 2. \u5728\u6c99\u7bb1\u4e2d\u6267\u884c<\/span><br \/>\n        <span class=\"token class-name\">ProcessResult<\/span> result <span class=\"token operator\">&#061;<\/span> sandbox<span class=\"token punctuation\">.<\/span><span class=\"token function\">execute<\/span><span class=\"token punctuation\">(<\/span>command<span class=\"token punctuation\">,<\/span><br \/>\n            <span class=\"token class-name\">Duration<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">ofSeconds<\/span><span class=\"token punctuation\">(<\/span><span class=\"token number\">30<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span>  <span class=\"token comment\">\/\/ \u8d85\u65f6\u4fdd\u62a4<\/span><\/p>\n<p>        <span class=\"token comment\">\/\/ 3. \u622a\u65ad\u8fc7\u957f\u8f93\u51fa<\/span><br \/>\n        <span class=\"token class-name\">String<\/span> output <span class=\"token operator\">&#061;<\/span> <span class=\"token function\">truncate<\/span><span class=\"token punctuation\">(<\/span>result<span class=\"token punctuation\">.<\/span><span class=\"token function\">getOutput<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token constant\">MAX_OUTPUT_LENGTH<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p>        <span class=\"token keyword\">return<\/span> <span class=\"token class-name\">ToolResult<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">success<\/span><span class=\"token punctuation\">(<\/span>output<span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n    <span class=\"token punctuation\">}<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<p>\u5b89\u5168\u7279\u6027&#xff1a;<\/p>\n<ul>\n<li>\u5371\u9669\u547d\u4ee4\u9ed1\u540d\u5355&#xff08;rm -rf \/\u3001mkfs\u3001dd if&#061;&#xff09;<\/li>\n<li>\u654f\u611f\u8def\u5f84\u4fdd\u62a4&#xff08;~\/.ssh\/\u3001\/etc\/passwd\u3001.env&#xff09;<\/li>\n<li>\u6267\u884c\u8d85\u65f6\u4fdd\u62a4<\/li>\n<li>\u8f93\u51fa\u957f\u5ea6\u622a\u65ad<\/li>\n<li>\u6c99\u7bb1\u9694\u79bb\u6267\u884c<\/li>\n<\/ul>\n<h4>6.3 \u6587\u4ef6\u64cd\u4f5c\u5de5\u5177&#xff08;Read\/Write\/Edit&#xff09;<\/h4>\n<p><span class=\"token comment\">\/\/ Read&#xff1a;\u8bfb\u53d6\u6587\u4ef6<\/span><br \/>\n<span class=\"token annotation punctuation\">&#064;Tool<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;read_file&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u8bfb\u53d6\u6307\u5b9a\u6587\u4ef6\u7684\u5185\u5bb9&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n<span class=\"token keyword\">public<\/span> <span class=\"token class-name\">String<\/span> <span class=\"token function\">readFile<\/span><span class=\"token punctuation\">(<\/span><br \/>\n        <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;file_path&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u6587\u4ef6\u8def\u5f84&#034;<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">String<\/span> filePath<span class=\"token punctuation\">,<\/span><br \/>\n        <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;offset&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u8d77\u59cb\u884c\u53f7&#034;<\/span><span class=\"token punctuation\">,<\/span> required <span class=\"token operator\">&#061;<\/span> <span class=\"token boolean\">false<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">Integer<\/span> offset<span class=\"token punctuation\">,<\/span><br \/>\n        <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;limit&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u8bfb\u53d6\u884c\u6570&#034;<\/span><span class=\"token punctuation\">,<\/span> required <span class=\"token operator\">&#061;<\/span> <span class=\"token boolean\">false<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">Integer<\/span> limit<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n    <span class=\"token comment\">\/\/ \u652f\u6301\u5206\u9875\u8bfb\u53d6\u5927\u6587\u4ef6<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<p><span class=\"token comment\">\/\/ Write&#xff1a;\u5199\u5165\u6587\u4ef6<\/span><br \/>\n<span class=\"token annotation punctuation\">&#064;Tool<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;write_file&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u5c06\u5185\u5bb9\u5199\u5165\u6307\u5b9a\u6587\u4ef6&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n<span class=\"token keyword\">public<\/span> <span class=\"token class-name\">String<\/span> <span class=\"token function\">writeFile<\/span><span class=\"token punctuation\">(<\/span><br \/>\n        <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;file_path&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u6587\u4ef6\u8def\u5f84&#034;<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">String<\/span> filePath<span class=\"token punctuation\">,<\/span><br \/>\n        <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;content&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u8981\u5199\u5165\u7684\u5185\u5bb9&#034;<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">String<\/span> content<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n    <span class=\"token comment\">\/\/ \u81ea\u52a8\u521b\u5efa\u76ee\u5f55\u3001\u6743\u9650\u68c0\u67e5<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<p><span class=\"token comment\">\/\/ Edit&#xff1a;\u7cbe\u786e\u7f16\u8f91<\/span><br \/>\n<span class=\"token annotation punctuation\">&#064;Tool<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;edit_file&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u7cbe\u786e\u66ff\u6362\u6587\u4ef6\u4e2d\u7684\u6307\u5b9a\u5185\u5bb9&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n<span class=\"token keyword\">public<\/span> <span class=\"token class-name\">String<\/span> <span class=\"token function\">editFile<\/span><span class=\"token punctuation\">(<\/span><br \/>\n        <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;file_path&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u6587\u4ef6\u8def\u5f84&#034;<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">String<\/span> filePath<span class=\"token punctuation\">,<\/span><br \/>\n        <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;old_string&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u8981\u66ff\u6362\u7684\u539f\u6587&#034;<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">String<\/span> oldString<span class=\"token punctuation\">,<\/span><br \/>\n        <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;new_string&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u66ff\u6362\u540e\u7684\u5185\u5bb9&#034;<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">String<\/span> newString<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n    <span class=\"token comment\">\/\/ \u7cbe\u786e\u5339\u914d\u66ff\u6362&#xff0c;\u907f\u514d\u5168\u6587\u91cd\u5199<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<h4>6.4 \u641c\u7d22\u5de5\u5177&#xff08;Glob\/Grep&#xff09;<\/h4>\n<p><span class=\"token comment\">\/\/ Glob&#xff1a;\u6587\u4ef6\u540d\u5339\u914d<\/span><br \/>\n<span class=\"token annotation punctuation\">&#064;Tool<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;glob&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u6309\u6a21\u5f0f\u5339\u914d\u641c\u7d22\u6587\u4ef6&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n<span class=\"token keyword\">public<\/span> <span class=\"token class-name\">String<\/span> <span class=\"token function\">glob<\/span><span class=\"token punctuation\">(<\/span><br \/>\n        <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;pattern&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u5339\u914d\u6a21\u5f0f&#xff0c;\u5982 **\/*.java&#034;<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">String<\/span> pattern<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n    <span class=\"token comment\">\/\/ \u8fd4\u56de\u5339\u914d\u7684\u6587\u4ef6\u8def\u5f84\u5217\u8868<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<p><span class=\"token comment\">\/\/ Grep&#xff1a;\u5185\u5bb9\u641c\u7d22<\/span><br \/>\n<span class=\"token annotation punctuation\">&#064;Tool<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;grep&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u5728\u6587\u4ef6\u4e2d\u641c\u7d22\u6307\u5b9a\u5185\u5bb9&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n<span class=\"token keyword\">public<\/span> <span class=\"token class-name\">String<\/span> <span class=\"token function\">grep<\/span><span class=\"token punctuation\">(<\/span><br \/>\n        <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;pattern&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u641c\u7d22\u6a21\u5f0f&#xff08;\u6b63\u5219&#xff09;&#034;<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">String<\/span> pattern<span class=\"token punctuation\">,<\/span><br \/>\n        <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;path&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u641c\u7d22\u8def\u5f84&#034;<\/span><span class=\"token punctuation\">,<\/span> required <span class=\"token operator\">&#061;<\/span> <span class=\"token boolean\">false<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">String<\/span> path<span class=\"token punctuation\">,<\/span><br \/>\n        <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;include&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u6587\u4ef6\u8fc7\u6ee4&#034;<\/span><span class=\"token punctuation\">,<\/span> required <span class=\"token operator\">&#061;<\/span> <span class=\"token boolean\">false<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">String<\/span> include<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n    <span class=\"token comment\">\/\/ \u8fd4\u56de\u5339\u914d\u884c\u53ca\u4e0a\u4e0b\u6587<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<h4>6.5 Skill \u5de5\u5177\u4e0e ResetTools \u5143\u5de5\u5177<\/h4>\n<p><span class=\"token comment\">\/\/ Skill&#xff1a;\u67e5\u770b\u53ef\u7528\u6280\u80fd\u63cf\u8ff0<\/span><br \/>\n<span class=\"token annotation punctuation\">&#064;Tool<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;skill&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u67e5\u770b\u6307\u5b9a\u6280\u80fd\u7684\u8be6\u7ec6\u8bf4\u660e&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n<span class=\"token keyword\">public<\/span> <span class=\"token class-name\">String<\/span> <span class=\"token function\">viewSkill<\/span><span class=\"token punctuation\">(<\/span><br \/>\n        <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;skill_name&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u6280\u80fd\u540d\u79f0&#034;<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">String<\/span> skillName<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n    <span class=\"token comment\">\/\/ \u8fd4\u56de workspace\/skills\/ \u76ee\u5f55\u4e0b\u7684\u6280\u80fd\u6587\u6863<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<p><span class=\"token comment\">\/\/ ResetTools&#xff1a;\u5207\u6362\u5de5\u5177\u7ec4<\/span><br \/>\n<span class=\"token annotation punctuation\">&#064;Tool<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;reset_tools&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u91cd\u7f6e\u5f53\u524d\u53ef\u7528\u7684\u5de5\u5177\u96c6&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n<span class=\"token keyword\">public<\/span> <span class=\"token class-name\">String<\/span> <span class=\"token function\">resetTools<\/span><span class=\"token punctuation\">(<\/span><br \/>\n        <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;tools&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u8981\u6fc0\u6d3b\u7684\u5de5\u5177\u5217\u8868&#034;<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">List<\/span><span class=\"token generics\"><span class=\"token punctuation\">&lt;<\/span><span class=\"token class-name\">String<\/span><span class=\"token punctuation\">&gt;<\/span><\/span> tools<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n    <span class=\"token comment\">\/\/ \u52a8\u6001\u8c03\u6574 Agent \u53ef\u89c1\u7684\u5de5\u5177\u96c6<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<h3>\u4e03\u3001ToolBase \u534f\u8bae&#xff1a;\u7edf\u4e00\u5de5\u5177\u62bd\u8c61<\/h3>\n<h4>7.1 \u63a5\u53e3\u5b9a\u4e49<\/h4>\n<p><span class=\"token keyword\">public<\/span> <span class=\"token keyword\">interface<\/span> <span class=\"token class-name\">AgentTool<\/span> <span class=\"token punctuation\">{<\/span><\/p>\n<p>    <span class=\"token comment\">\/** \u5de5\u5177\u540d\u79f0&#xff08;\u552f\u4e00\u6807\u8bc6&#xff09; *\/<\/span><br \/>\n    <span class=\"token class-name\">String<\/span> <span class=\"token function\">getName<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p>    <span class=\"token comment\">\/** \u5de5\u5177\u63cf\u8ff0&#xff08;\u7ed9 LLM \u770b\u7684&#xff09; *\/<\/span><br \/>\n    <span class=\"token class-name\">String<\/span> <span class=\"token function\">getDescription<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p>    <span class=\"token comment\">\/** \u53c2\u6570 JSON Schema *\/<\/span><br \/>\n    <span class=\"token class-name\">Map<\/span><span class=\"token generics\"><span class=\"token punctuation\">&lt;<\/span><span class=\"token class-name\">String<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token class-name\">Object<\/span><span class=\"token punctuation\">&gt;<\/span><\/span> <span class=\"token function\">getParameterSchema<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p>    <span class=\"token comment\">\/** \u6267\u884c\u5de5\u5177 *\/<\/span><br \/>\n    <span class=\"token class-name\">ToolResult<\/span> <span class=\"token function\">execute<\/span><span class=\"token punctuation\">(<\/span><span class=\"token class-name\">Map<\/span><span class=\"token generics\"><span class=\"token punctuation\">&lt;<\/span><span class=\"token class-name\">String<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token class-name\">Object<\/span><span class=\"token punctuation\">&gt;<\/span><\/span> input<span class=\"token punctuation\">,<\/span> <span class=\"token class-name\">ToolContext<\/span> ctx<span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p>    <span class=\"token comment\">\/** \u662f\u5426\u4e3a\u5916\u90e8\u5de5\u5177&#xff08;\u524d\u7aef\u6267\u884c&#xff09; *\/<\/span><br \/>\n    <span class=\"token keyword\">default<\/span> <span class=\"token keyword\">boolean<\/span> <span class=\"token function\">isExternalTool<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span> <span class=\"token keyword\">return<\/span> <span class=\"token boolean\">false<\/span><span class=\"token punctuation\">;<\/span> <span class=\"token punctuation\">}<\/span><\/p>\n<p>    <span class=\"token comment\">\/** \u5b89\u5168\u68c0\u67e5&#xff08;\u4e0d\u53ef\u7ed5\u8fc7&#xff09; *\/<\/span><br \/>\n    <span class=\"token keyword\">default<\/span> <span class=\"token keyword\">boolean<\/span> <span class=\"token function\">isSafe<\/span><span class=\"token punctuation\">(<\/span><span class=\"token class-name\">Map<\/span><span class=\"token generics\"><span class=\"token punctuation\">&lt;<\/span><span class=\"token class-name\">String<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token class-name\">Object<\/span><span class=\"token punctuation\">&gt;<\/span><\/span> input<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span> <span class=\"token keyword\">return<\/span> <span class=\"token boolean\">true<\/span><span class=\"token punctuation\">;<\/span> <span class=\"token punctuation\">}<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<h4>7.2 ToolBase \u62bd\u8c61\u57fa\u7c7b<\/h4>\n<p><span class=\"token keyword\">public<\/span> <span class=\"token keyword\">abstract<\/span> <span class=\"token keyword\">class<\/span> <span class=\"token class-name\">ToolBase<\/span> <span class=\"token keyword\">implements<\/span> <span class=\"token class-name\">AgentTool<\/span> <span class=\"token punctuation\">{<\/span><\/p>\n<p>    <span class=\"token keyword\">private<\/span> <span class=\"token keyword\">final<\/span> <span class=\"token class-name\">String<\/span> name<span class=\"token punctuation\">;<\/span><br \/>\n    <span class=\"token keyword\">private<\/span> <span class=\"token keyword\">final<\/span> <span class=\"token class-name\">String<\/span> description<span class=\"token punctuation\">;<\/span><br \/>\n    <span class=\"token keyword\">private<\/span> <span class=\"token keyword\">final<\/span> <span class=\"token class-name\">Map<\/span><span class=\"token generics\"><span class=\"token punctuation\">&lt;<\/span><span class=\"token class-name\">String<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token class-name\">Object<\/span><span class=\"token punctuation\">&gt;<\/span><\/span> parameterSchema<span class=\"token punctuation\">;<\/span><br \/>\n    <span class=\"token keyword\">private<\/span> <span class=\"token keyword\">final<\/span> <span class=\"token keyword\">boolean<\/span> externalTool<span class=\"token punctuation\">;<\/span><\/p>\n<p>    <span class=\"token comment\">\/**<br \/>\n     * \u5b89\u5168\u68c0\u67e5 \u2014\u2014 \u5728 PermissionEngine \u4e4b\u524d\u6267\u884c&#xff0c;\u4e0d\u53ef\u7ed5\u8fc7<br \/>\n     *\/<\/span><br \/>\n    <span class=\"token annotation punctuation\">&#064;Override<\/span><br \/>\n    <span class=\"token keyword\">public<\/span> <span class=\"token keyword\">boolean<\/span> <span class=\"token function\">isSafe<\/span><span class=\"token punctuation\">(<\/span><span class=\"token class-name\">Map<\/span><span class=\"token generics\"><span class=\"token punctuation\">&lt;<\/span><span class=\"token class-name\">String<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token class-name\">Object<\/span><span class=\"token punctuation\">&gt;<\/span><\/span> input<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n        <span class=\"token keyword\">return<\/span> <span class=\"token boolean\">true<\/span><span class=\"token punctuation\">;<\/span>  <span class=\"token comment\">\/\/ \u5b50\u7c7b\u53ef\u8986\u5199<\/span><br \/>\n    <span class=\"token punctuation\">}<\/span><\/p>\n<p>    <span class=\"token comment\">\/**<br \/>\n     * \u5b9e\u9645\u6267\u884c\u903b\u8f91<br \/>\n     *\/<\/span><br \/>\n    <span class=\"token annotation punctuation\">&#064;Override<\/span><br \/>\n    <span class=\"token keyword\">public<\/span> <span class=\"token keyword\">abstract<\/span> <span class=\"token class-name\">ToolResult<\/span> <span class=\"token function\">execute<\/span><span class=\"token punctuation\">(<\/span><span class=\"token class-name\">Map<\/span><span class=\"token generics\"><span class=\"token punctuation\">&lt;<\/span><span class=\"token class-name\">String<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token class-name\">Object<\/span><span class=\"token punctuation\">&gt;<\/span><\/span> input<span class=\"token punctuation\">,<\/span> <span class=\"token class-name\">ToolContext<\/span> ctx<span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<h4>7.3 \u4e24\u79cd\u9002\u914d\u5668<\/h4>\n<table>\n<tr>\u9002\u914d\u5668\u8bf4\u660e\u9002\u7528\u573a\u666f<\/tr>\n<tbody>\n<tr>\n<td>ReflectiveFunctionTool<\/td>\n<td>\u5c06 &#064;Tool \u6ce8\u89e3\u65b9\u6cd5\u9002\u914d\u4e3a AgentTool<\/td>\n<td>\u4e1a\u52a1\u81ea\u5b9a\u4e49\u5de5\u5177<\/td>\n<\/tr>\n<tr>\n<td>McpTool<\/td>\n<td>\u5c06 MCP Server \u7684\u8fdc\u7a0b\u5de5\u5177\u9002\u914d\u4e3a AgentTool<\/td>\n<td>\u5916\u90e8 MCP \u96c6\u6210<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h4>7.4 externalTool \u673a\u5236<\/h4>\n<p><span class=\"token comment\">\/\/ \u524d\u7aef\u5de5\u5177&#xff1a;\u4e0d\u5728\u540e\u7aef\u6267\u884c&#xff0c;\u800c\u662f\u53d1\u9001\u4e8b\u4ef6\u7ed9\u524d\u7aef<\/span><br \/>\n<span class=\"token keyword\">public<\/span> <span class=\"token keyword\">class<\/span> <span class=\"token class-name\">ApprovalTool<\/span> <span class=\"token keyword\">extends<\/span> <span class=\"token class-name\">ToolBase<\/span> <span class=\"token punctuation\">{<\/span><\/p>\n<p>    <span class=\"token keyword\">public<\/span> <span class=\"token class-name\">ApprovalTool<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n        <span class=\"token keyword\">super<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;request_approval&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;\u8bf7\u6c42\u4eba\u5de5\u5ba1\u6279&#034;<\/span><span class=\"token punctuation\">,<\/span> schema<span class=\"token punctuation\">,<\/span> <span class=\"token boolean\">true<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span>  <span class=\"token comment\">\/\/ externalTool &#061; true<\/span><br \/>\n    <span class=\"token punctuation\">}<\/span><\/p>\n<p>    <span class=\"token annotation punctuation\">&#064;Override<\/span><br \/>\n    <span class=\"token keyword\">public<\/span> <span class=\"token class-name\">ToolResult<\/span> <span class=\"token function\">execute<\/span><span class=\"token punctuation\">(<\/span><span class=\"token class-name\">Map<\/span><span class=\"token generics\"><span class=\"token punctuation\">&lt;<\/span><span class=\"token class-name\">String<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token class-name\">Object<\/span><span class=\"token punctuation\">&gt;<\/span><\/span> input<span class=\"token punctuation\">,<\/span> <span class=\"token class-name\">ToolContext<\/span> ctx<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n        <span class=\"token comment\">\/\/ \u4e0d\u4f1a\u5b9e\u9645\u6267\u884c&#xff0c;\u800c\u662f\u89e6\u53d1 PermissionRequestEvent<\/span><br \/>\n        <span class=\"token comment\">\/\/ Agent \u6682\u505c&#xff0c;\u7b49\u5f85\u524d\u7aef\u7528\u6237\u64cd\u4f5c\u540e\u6062\u590d<\/span><br \/>\n        <span class=\"token keyword\">throw<\/span> <span class=\"token keyword\">new<\/span> <span class=\"token class-name\">ExternalToolExecutionException<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n    <span class=\"token punctuation\">}<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<p>\u8bbe\u8ba1\u610f\u56fe&#xff1a;\u652f\u6301 HITL&#xff08;Human-in-the-Loop&#xff09;\u573a\u666f&#xff0c;\u67d0\u4e9b&#034;\u5de5\u5177&#034;\u7684\u6267\u884c\u4e3b\u4f53\u662f\u524d\u7aef\u7528\u6237\u800c\u975e\u540e\u7aef\u670d\u52a1\u3002<\/p>\n<h3>\u516b\u3001MCP \u534f\u8bae\u96c6\u6210<\/h3>\n<h4>8.1 \u58f0\u660e\u5f0f\u63a5\u5165<\/h4>\n<p>AgentScope 2.0 \u901a\u8fc7 workspace\/tools.json \u5b9e\u73b0\u4e00\u884c\u58f0\u660e\u4e00\u4e2a MCP Server&#xff1a;<\/p>\n<p><span class=\"token punctuation\">{<\/span><br \/>\n  <span class=\"token string-property property\">&#034;mcpServers&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n    <span class=\"token string-property property\">&#034;github&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n      <span class=\"token string-property property\">&#034;command&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token string\">&#034;npx&#034;<\/span><span class=\"token punctuation\">,<\/span><br \/>\n      <span class=\"token string-property property\">&#034;args&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">[<\/span><span class=\"token string\">&#034;-y&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;&#064;modelcontextprotocol\/server-github&#034;<\/span><span class=\"token punctuation\">]<\/span><span class=\"token punctuation\">,<\/span><br \/>\n      <span class=\"token string-property property\">&#034;env&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n        <span class=\"token string-property property\">&#034;GITHUB_TOKEN&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token string\">&#034;${GITHUB_TOKEN}&#034;<\/span><br \/>\n      <span class=\"token punctuation\">}<\/span><br \/>\n    <span class=\"token punctuation\">}<\/span><span class=\"token punctuation\">,<\/span><br \/>\n    <span class=\"token string-property property\">&#034;postgres&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n      <span class=\"token string-property property\">&#034;url&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token string\">&#034;http:\/\/localhost:3001\/sse&#034;<\/span><span class=\"token punctuation\">,<\/span><br \/>\n      <span class=\"token string-property property\">&#034;transport&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token string\">&#034;sse&#034;<\/span><br \/>\n    <span class=\"token punctuation\">}<\/span><span class=\"token punctuation\">,<\/span><br \/>\n    <span class=\"token string-property property\">&#034;slack&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n      <span class=\"token string-property property\">&#034;command&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token string\">&#034;python&#034;<\/span><span class=\"token punctuation\">,<\/span><br \/>\n      <span class=\"token string-property property\">&#034;args&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">[<\/span><span class=\"token string\">&#034;-m&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;mcp_slack_server&#034;<\/span><span class=\"token punctuation\">]<\/span><span class=\"token punctuation\">,<\/span><br \/>\n      <span class=\"token string-property property\">&#034;transport&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token string\">&#034;stdio&#034;<\/span><br \/>\n    <span class=\"token punctuation\">}<\/span><br \/>\n  <span class=\"token punctuation\">}<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<h4>8.2 \u652f\u6301\u7684\u4f20\u8f93\u534f\u8bae<\/h4>\n<table>\n<tr>\u534f\u8bae\u8bf4\u660e\u9002\u7528\u573a\u666f<\/tr>\n<tbody>\n<tr>\n<td>stdio<\/td>\n<td>\u6807\u51c6\u8f93\u5165\u8f93\u51fa<\/td>\n<td>\u672c\u5730\u8fdb\u7a0b<\/td>\n<\/tr>\n<tr>\n<td>sse<\/td>\n<td>Server-Sent Events<\/td>\n<td>HTTP \u957f\u8fde\u63a5<\/td>\n<\/tr>\n<tr>\n<td>ws<\/td>\n<td>WebSocket<\/td>\n<td>\u53cc\u5411\u5b9e\u65f6\u901a\u4fe1<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h4>8.3 \u5de5\u5177\u53d1\u73b0\u6d41\u7a0b<\/h4>\n<p>Agent \u542f\u52a8<br \/>\n    \u2502<br \/>\n    \u25bc<br \/>\n\u8bfb\u53d6 workspace\/tools.json<br \/>\n    \u2502<br \/>\n    \u25bc<br \/>\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<br \/>\n\u2502  \u5bf9\u6bcf\u4e2a MCP Server&#xff1a;                                     \u2502<br \/>\n\u2502  1. \u5efa\u7acb\u8fde\u63a5&#xff08;stdio\/sse\/ws&#xff09;                             \u2502<br \/>\n\u2502  2. \u8c03\u7528 tools\/list \u83b7\u53d6\u5de5\u5177\u5217\u8868                          \u2502<br \/>\n\u2502  3. \u5c06\u6bcf\u4e2a\u8fdc\u7a0b\u5de5\u5177\u9002\u914d\u4e3a McpTool&#xff08;\u5b9e\u73b0 AgentTool \u63a5\u53e3&#xff09;     \u2502<br \/>\n\u2502  4. \u6ce8\u518c\u5230 Toolkit                                      \u2502<br \/>\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<br \/>\n    \u2502<br \/>\n    \u25bc<br \/>\nAgent \u53ef\u8c03\u7528\u6240\u6709\u672c\u5730 &#043; \u8fdc\u7a0b\u5de5\u5177<\/p>\n<h4>8.4 \u5de5\u5177\u547d\u540d\u51b2\u7a81\u89e3\u51b3<\/h4>\n<p>\u5f53\u591a\u4e2a MCP Server \u66b4\u9732\u540c\u540d\u5de5\u5177\u65f6&#xff0c;\u6309\u4ee5\u4e0b\u4f18\u5148\u7ea7\u4fdd\u7559&#xff1a;<\/p>\n<table>\n<tr>\u4f18\u5148\u7ea7\u6765\u6e90\u8bf4\u660e<\/tr>\n<tbody>\n<tr>\n<td>\u6700\u9ad8<\/td>\n<td>Toolkit \u4e2d Java \u7aef\u6ce8\u518c\u7684\u5de5\u5177<\/td>\n<td>\u672c\u5730\u4f18\u5148<\/td>\n<\/tr>\n<tr>\n<td>\u4e2d<\/td>\n<td>\u7b2c\u4e00\u4e2a\u542f\u52a8\u6210\u529f\u7684 MCP Server<\/td>\n<td>\u5148\u5230\u5148\u5f97<\/td>\n<\/tr>\n<tr>\n<td>\u4f4e<\/td>\n<td>\u540e\u7eed\u540c\u540d\u5de5\u5177<\/td>\n<td>\u88ab\u5ffd\u7565 &#043; WARN \u65e5\u5fd7<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h4>8.5 McpMeta&#xff1a;\u8c03\u7528\u5143\u6570\u636e<\/h4>\n<p><span class=\"token comment\">\/\/ MCP \u5de5\u5177\u8c03\u7528\u65f6\u53ef\u4f20\u9012\u5143\u6570\u636e<\/span><br \/>\n<span class=\"token class-name\">McpMeta<\/span> meta <span class=\"token operator\">&#061;<\/span> <span class=\"token class-name\">McpMeta<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">builder<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">sessionId<\/span><span class=\"token punctuation\">(<\/span>ctx<span class=\"token punctuation\">.<\/span><span class=\"token function\">getSessionId<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">userId<\/span><span class=\"token punctuation\">(<\/span>ctx<span class=\"token punctuation\">.<\/span><span class=\"token function\">getUserId<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">build<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<h3>\u4e5d\u3001\u5de5\u5177\u5206\u7ec4\u4e0e\u8fc7\u6ee4&#xff1a;workspace\/tools.json &#043; toolFilter<\/h3>\n<h4>9.1 \u914d\u7f6e\u5316\u5de5\u5177\u8fc7\u6ee4<\/h4>\n<p>2.0 \u63d0\u4f9b ToolsConfig \u6309 allow\/deny \u7cbe\u786e\u5339\u914d\u8fc7\u6ee4&#xff1a;<\/p>\n<p><span class=\"token punctuation\">{<\/span><br \/>\n  <span class=\"token string-property property\">&#034;roles&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n    <span class=\"token string-property property\">&#034;customer-service&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n      <span class=\"token string-property property\">&#034;allow&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">[<\/span><span class=\"token string\">&#034;query_order&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;track_logistics&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;get_weather&#034;<\/span><span class=\"token punctuation\">]<\/span><span class=\"token punctuation\">,<\/span><br \/>\n      <span class=\"token string-property property\">&#034;deny&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">[<\/span><span class=\"token string\">&#034;bash&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;write_file&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;edit_file&#034;<\/span><span class=\"token punctuation\">]<\/span><br \/>\n    <span class=\"token punctuation\">}<\/span><span class=\"token punctuation\">,<\/span><br \/>\n    <span class=\"token string-property property\">&#034;dba&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n      <span class=\"token string-property property\">&#034;allow&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">[<\/span><span class=\"token string\">&#034;execute_sql&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;read_file&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;grep&#034;<\/span><span class=\"token punctuation\">]<\/span><span class=\"token punctuation\">,<\/span><br \/>\n      <span class=\"token string-property property\">&#034;deny&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">[<\/span><span class=\"token string\">&#034;bash&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;write_file&#034;<\/span><span class=\"token punctuation\">]<\/span><br \/>\n    <span class=\"token punctuation\">}<\/span><span class=\"token punctuation\">,<\/span><br \/>\n    <span class=\"token string-property property\">&#034;admin&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n      <span class=\"token string-property property\">&#034;allow&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">[<\/span><span class=\"token string\">&#034;*&#034;<\/span><span class=\"token punctuation\">]<\/span><span class=\"token punctuation\">,<\/span><br \/>\n      <span class=\"token string-property property\">&#034;deny&#034;<\/span><span class=\"token operator\">:<\/span> <span class=\"token punctuation\">[<\/span><span class=\"token punctuation\">]<\/span><br \/>\n    <span class=\"token punctuation\">}<\/span><br \/>\n  <span class=\"token punctuation\">}<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<h4>9.2 Java \u7aef\u914d\u7f6e<\/h4>\n<p><span class=\"token class-name\">HarnessAgent<\/span> agent <span class=\"token operator\">&#061;<\/span> <span class=\"token class-name\">HarnessAgent<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">builder<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">name<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;customer-service-agent&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">model<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;dashscope:qwen-plus&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">toolkit<\/span><span class=\"token punctuation\">(<\/span>toolkit<span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">toolFilter<\/span><span class=\"token punctuation\">(<\/span><span class=\"token class-name\">ToolsConfig<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">builder<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><br \/>\n        <span class=\"token punctuation\">.<\/span><span class=\"token function\">allow<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;query_order&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;track_logistics&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;get_weather&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n        <span class=\"token punctuation\">.<\/span><span class=\"token function\">deny<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;bash&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;write_file&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;edit_file&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n        <span class=\"token punctuation\">.<\/span><span class=\"token function\">build<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">build<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<h4>9.3 \u8bbe\u8ba1\u4f18\u52bf<\/h4>\n<p>\u540c\u4e00\u5957\u5de5\u5177&#xff0c;\u4e24\u4e2a\u89d2\u8272&#xff0c;\u4e24\u4e2a\u89c6\u91ce\u3002<\/p>\n<ul>\n<li>Toolkit \u6ce8\u518c\u5168\u91cf\u5de5\u5177&#xff08;\u4e00\u6b21\u6ce8\u518c&#xff09;<\/li>\n<li>ToolsConfig \u6309\u89d2\u8272\u8fc7\u6ee4&#xff08;\u591a\u6b21\u590d\u7528&#xff09;<\/li>\n<li>\u65b0\u589e\u89d2\u8272\u53ea\u9700\u52a0\u914d\u7f6e&#xff0c;\u4e0d\u6539 Java \u4ee3\u7801<\/li>\n<\/ul>\n<h3>\u5341\u3001\u5de5\u5177\u4e0e\u6743\u9650\u7cfb\u7edf\u7684\u96c6\u6210<\/h3>\n<h3>10.1 \u6267\u884c\u94fe\u8def<\/h3>\n<p>\u6a21\u578b\u51b3\u5b9a\u8c03\u7528\u5de5\u5177<br \/>\n    \u2502<br \/>\n    \u25bc<br \/>\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<br \/>\n\u2502 Step 1: ToolBase.isSafe() \u2014\u2014 \u5de5\u5177\u81ea\u8eab\u5b89\u5168\u68c0\u67e5&#xff08;\u4e0d\u53ef\u7ed5\u8fc7&#xff09;  \u2502<br \/>\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<br \/>\n                               \u2502 \u901a\u8fc7<br \/>\n                               \u25bc<br \/>\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<br \/>\n\u2502 Step 2: PermissionEngine.evaluate() \u2014\u2014 \u6743\u9650\u89c4\u5219\u5339\u914d       \u2502<br \/>\n\u2502   DENY \u89c4\u5219 \u2192 ASK \u89c4\u5219 \u2192 ALLOW \u89c4\u5219 \u2192 Mode \u9ed8\u8ba4 \u2192 \u515c\u5e95   \u2502<br \/>\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<br \/>\n                               \u2502 ALLOW<br \/>\n                               \u25bc<br \/>\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<br \/>\n\u2502 Step 3: Middleware.onActing() \u2014\u2014 \u4e2d\u95f4\u4ef6\u62e6\u622a               \u2502<br \/>\n\u2502   \u8ffd\u8e2a \/ \u5ba1\u8ba1 \/ \u9650\u6d41 \/ \u53c2\u6570\u6821\u9a8c                           \u2502<br \/>\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<br \/>\n                               \u2502<br \/>\n                               \u25bc<br \/>\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<br \/>\n\u2502 Step 4: ToolBase.execute() \u2014\u2014 \u5b9e\u9645\u6267\u884c                   \u2502<br \/>\n\u2502   \u5728\u6c99\u7bb1\u4e2d\u6267\u884c&#xff0c;\u8d85\u65f6\u4fdd\u62a4&#xff0c;\u8f93\u51fa\u622a\u65ad                         \u2502<br \/>\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<\/p>\n<h4>10.2 \u6c99\u7bb1\u6267\u884c<\/h4>\n<p><span class=\"token comment\">\/\/ \u5de5\u5177\u5728\u6c99\u7bb1\u4e2d\u6267\u884c&#xff0c;\u9694\u79bb\u5bbf\u4e3b\u73af\u5883<\/span><br \/>\n<span class=\"token class-name\">SandboxConfig<\/span> sandbox <span class=\"token operator\">&#061;<\/span> <span class=\"token class-name\">SandboxConfig<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">builder<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">type<\/span><span class=\"token punctuation\">(<\/span><span class=\"token class-name\">SandboxType<\/span><span class=\"token punctuation\">.<\/span><span class=\"token constant\">DOCKER<\/span><span class=\"token punctuation\">)<\/span>       <span class=\"token comment\">\/\/ LOCAL \/ DOCKER \/ E2B<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">image<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;agentscope-sandbox:latest&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">workspacePath<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;\/workspace&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">timeout<\/span><span class=\"token punctuation\">(<\/span><span class=\"token class-name\">Duration<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">ofSeconds<\/span><span class=\"token punctuation\">(<\/span><span class=\"token number\">30<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">memoryLimit<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;512m&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">cpuLimit<\/span><span class=\"token punctuation\">(<\/span><span class=\"token number\">1.0<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">build<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<h3>\u5341\u4e00\u3001\u5de5\u5177\u4e0e\u4e8b\u4ef6\u7cfb\u7edf\u7684\u96c6\u6210<\/h3>\n<h4>11.1 \u5de5\u5177\u8c03\u7528\u4e8b\u4ef6<\/h4>\n<p>\u6bcf\u6b21\u5de5\u5177\u8c03\u7528\u90fd\u4f1a\u4ea7\u751f\u5bf9\u5e94\u7684\u4e8b\u4ef6&#xff1a;<\/p>\n<p>agent<span class=\"token punctuation\">.<\/span><span class=\"token function\">streamEvents<\/span><span class=\"token punctuation\">(<\/span>userMsg<span class=\"token punctuation\">,<\/span> ctx<span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">doOnNext<\/span><span class=\"token punctuation\">(<\/span>event <span class=\"token operator\">-&gt;<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n        <span class=\"token keyword\">switch<\/span> <span class=\"token punctuation\">(<\/span>event<span class=\"token punctuation\">.<\/span><span class=\"token function\">getType<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n            <span class=\"token keyword\">case<\/span> <span class=\"token constant\">TOOL_CALL_START<\/span> <span class=\"token operator\">-&gt;<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n                <span class=\"token class-name\">ToolCallStartEvent<\/span> e <span class=\"token operator\">&#061;<\/span> <span class=\"token punctuation\">(<\/span><span class=\"token class-name\">ToolCallStartEvent<\/span><span class=\"token punctuation\">)<\/span> event<span class=\"token punctuation\">;<\/span><br \/>\n                <span class=\"token class-name\">System<\/span><span class=\"token punctuation\">.<\/span>out<span class=\"token punctuation\">.<\/span><span class=\"token function\">println<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;&#x1f527; \u8c03\u7528\u5de5\u5177: &#034;<\/span> <span class=\"token operator\">&#043;<\/span> e<span class=\"token punctuation\">.<\/span><span class=\"token function\">getToolCallName<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n                <span class=\"token class-name\">System<\/span><span class=\"token punctuation\">.<\/span>out<span class=\"token punctuation\">.<\/span><span class=\"token function\">println<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;   \u53c2\u6570: &#034;<\/span> <span class=\"token operator\">&#043;<\/span> e<span class=\"token punctuation\">.<\/span><span class=\"token function\">getParameters<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n            <span class=\"token punctuation\">}<\/span><br \/>\n            <span class=\"token keyword\">case<\/span> <span class=\"token constant\">TOOL_CALL_END<\/span> <span class=\"token operator\">-&gt;<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n                <span class=\"token class-name\">ToolCallEndEvent<\/span> e <span class=\"token operator\">&#061;<\/span> <span class=\"token punctuation\">(<\/span><span class=\"token class-name\">ToolCallEndEvent<\/span><span class=\"token punctuation\">)<\/span> event<span class=\"token punctuation\">;<\/span><br \/>\n                <span class=\"token class-name\">System<\/span><span class=\"token punctuation\">.<\/span>out<span class=\"token punctuation\">.<\/span><span class=\"token function\">println<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;\u2705 \u5de5\u5177\u5b8c\u6210: &#034;<\/span> <span class=\"token operator\">&#043;<\/span> e<span class=\"token punctuation\">.<\/span><span class=\"token function\">getToolCallName<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n                <span class=\"token class-name\">System<\/span><span class=\"token punctuation\">.<\/span>out<span class=\"token punctuation\">.<\/span><span class=\"token function\">println<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;   \u8017\u65f6: &#034;<\/span> <span class=\"token operator\">&#043;<\/span> e<span class=\"token punctuation\">.<\/span><span class=\"token function\">getDuration<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token operator\">&#043;<\/span> <span class=\"token string\">&#034;ms&#034;<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n            <span class=\"token punctuation\">}<\/span><br \/>\n            <span class=\"token keyword\">case<\/span> <span class=\"token constant\">TOOL_RESULT<\/span> <span class=\"token operator\">-&gt;<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n                <span class=\"token class-name\">ToolResultEvent<\/span> e <span class=\"token operator\">&#061;<\/span> <span class=\"token punctuation\">(<\/span><span class=\"token class-name\">ToolResultEvent<\/span><span class=\"token punctuation\">)<\/span> event<span class=\"token punctuation\">;<\/span><br \/>\n                <span class=\"token class-name\">System<\/span><span class=\"token punctuation\">.<\/span>out<span class=\"token punctuation\">.<\/span><span class=\"token function\">println<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;&#x1f4cb; \u7ed3\u679c: &#034;<\/span> <span class=\"token operator\">&#043;<\/span> <span class=\"token function\">truncate<\/span><span class=\"token punctuation\">(<\/span>e<span class=\"token punctuation\">.<\/span><span class=\"token function\">getContent<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token number\">200<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n            <span class=\"token punctuation\">}<\/span><br \/>\n        <span class=\"token punctuation\">}<\/span><br \/>\n    <span class=\"token punctuation\">}<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token punctuation\">.<\/span><span class=\"token function\">subscribe<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<h4>11.2 \u4e8b\u4ef6\u5e8f\u5217<\/h4>\n<p>ToolCallStartEvent (\u5de5\u5177\u540d\u3001\u53c2\u6570)<br \/>\n    \u2502<br \/>\n    \u251c\u2500\u2500 [\u5982\u679c ASK] \u2192 PermissionRequestEvent \u2192 \u7b49\u5f85 \u2192 PermissionResponseEvent<br \/>\n    \u2502<br \/>\n    \u251c\u2500\u2500 [\u6267\u884c\u4e2d&#8230;]<br \/>\n    \u2502<br \/>\n    \u2514\u2500\u2500 ToolCallEndEvent (\u8017\u65f6\u3001\u72b6\u6001)<br \/>\n         \u2514\u2500\u2500 ToolResultEvent (\u6267\u884c\u7ed3\u679c)<\/p>\n<h3>\u5341\u4e8c\u3001\u5b8c\u6574\u5b9e\u6218&#xff1a;\u6784\u5efa\u591a\u5de5\u5177\u4e1a\u52a1 Agent<\/h3>\n<h4>12.1 \u573a\u666f\u63cf\u8ff0<\/h4>\n<p>\u6784\u5efa\u4e00\u4e2a\u7535\u5546\u5ba2\u670d Agent&#xff1a;<\/p>\n<ul>\n<li>\u53ef\u67e5\u8be2\u8ba2\u5355\u3001\u8ffd\u8e2a\u7269\u6d41<\/li>\n<li>\u53ef\u7533\u8bf7\u9000\u6b3e&#xff08;\u9700\u4eba\u5de5\u5ba1\u6279&#xff09;<\/li>\n<li>\u53ef\u67e5\u8be2\u5929\u6c14&#xff08;\u8f85\u52a9\u63a8\u8350&#xff09;<\/li>\n<li>\u4e0d\u80fd\u6267\u884c\u7cfb\u7edf\u547d\u4ee4<\/li>\n<\/ul>\n<h4>12.2 \u5b8c\u6574\u4ee3\u7801<\/h4>\n<p><span class=\"token keyword\">public<\/span> <span class=\"token keyword\">class<\/span> <span class=\"token class-name\">EcommerceAgentDemo<\/span> <span class=\"token punctuation\">{<\/span><\/p>\n<p>    <span class=\"token keyword\">public<\/span> <span class=\"token keyword\">static<\/span> <span class=\"token keyword\">void<\/span> <span class=\"token function\">main<\/span><span class=\"token punctuation\">(<\/span><span class=\"token class-name\">String<\/span><span class=\"token punctuation\">[<\/span><span class=\"token punctuation\">]<\/span> args<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><\/p>\n<p>        <span class=\"token comment\">\/\/ &#061;&#061;&#061; 1. \u5b9a\u4e49\u4e1a\u52a1\u5de5\u5177 &#061;&#061;&#061;<\/span><br \/>\n        <span class=\"token class-name\">Toolkit<\/span> toolkit <span class=\"token operator\">&#061;<\/span> <span class=\"token keyword\">new<\/span> <span class=\"token class-name\">Toolkit<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p>        <span class=\"token comment\">\/\/ \u8ba2\u5355\u5de5\u5177<\/span><br \/>\n        toolkit<span class=\"token punctuation\">.<\/span><span class=\"token function\">registerTool<\/span><span class=\"token punctuation\">(<\/span><span class=\"token keyword\">new<\/span> <span class=\"token class-name\">Object<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n            <span class=\"token annotation punctuation\">&#064;Tool<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;query_order&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u67e5\u8be2\u8ba2\u5355\u8be6\u60c5&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token keyword\">public<\/span> <span class=\"token class-name\">String<\/span> <span class=\"token function\">queryOrder<\/span><span class=\"token punctuation\">(<\/span><br \/>\n                    <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;order_id&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u8ba2\u5355\u53f7&#034;<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">String<\/span> orderId<span class=\"token punctuation\">,<\/span><br \/>\n                    <span class=\"token class-name\">RuntimeContext<\/span> ctx<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n                <span class=\"token keyword\">return<\/span> orderService<span class=\"token punctuation\">.<\/span><span class=\"token function\">getOrder<\/span><span class=\"token punctuation\">(<\/span>ctx<span class=\"token punctuation\">.<\/span><span class=\"token function\">getUserId<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">,<\/span> orderId<span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">toJson<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n            <span class=\"token punctuation\">}<\/span><\/p>\n<p>            <span class=\"token annotation punctuation\">&#064;Tool<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;track_logistics&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u8ffd\u8e2a\u7269\u6d41\u72b6\u6001&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token keyword\">public<\/span> <span class=\"token class-name\">String<\/span> <span class=\"token function\">trackLogistics<\/span><span class=\"token punctuation\">(<\/span><br \/>\n                    <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;order_id&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u8ba2\u5355\u53f7&#034;<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">String<\/span> orderId<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n                <span class=\"token keyword\">return<\/span> logisticsService<span class=\"token punctuation\">.<\/span><span class=\"token function\">track<\/span><span class=\"token punctuation\">(<\/span>orderId<span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">toJson<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n            <span class=\"token punctuation\">}<\/span><br \/>\n        <span class=\"token punctuation\">}<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p>        <span class=\"token comment\">\/\/ \u9000\u6b3e\u5de5\u5177&#xff08;\u5916\u90e8\u5de5\u5177&#xff0c;\u9700\u524d\u7aef\u5ba1\u6279&#xff09;<\/span><br \/>\n        toolkit<span class=\"token punctuation\">.<\/span><span class=\"token function\">registerTool<\/span><span class=\"token punctuation\">(<\/span><span class=\"token keyword\">new<\/span> <span class=\"token class-name\">Object<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n            <span class=\"token annotation punctuation\">&#064;Tool<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;request_refund&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u7533\u8bf7\u9000\u6b3e&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token keyword\">public<\/span> <span class=\"token class-name\">String<\/span> <span class=\"token function\">requestRefund<\/span><span class=\"token punctuation\">(<\/span><br \/>\n                    <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;order_id&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u8ba2\u5355\u53f7&#034;<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">String<\/span> orderId<span class=\"token punctuation\">,<\/span><br \/>\n                    <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;reason&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u9000\u6b3e\u539f\u56e0&#034;<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">String<\/span> reason<span class=\"token punctuation\">,<\/span><br \/>\n                    <span class=\"token class-name\">RuntimeContext<\/span> ctx<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n                <span class=\"token comment\">\/\/ \u6807\u8bb0\u4e3a externalTool&#xff0c;\u89e6\u53d1 HITL \u5ba1\u6279<\/span><br \/>\n                <span class=\"token keyword\">return<\/span> <span class=\"token string\">&#034;REFUND_PENDING_APPROVAL&#034;<\/span><span class=\"token punctuation\">;<\/span><br \/>\n            <span class=\"token punctuation\">}<\/span><br \/>\n        <span class=\"token punctuation\">}<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p>        <span class=\"token comment\">\/\/ \u5929\u6c14\u5de5\u5177<\/span><br \/>\n        toolkit<span class=\"token punctuation\">.<\/span><span class=\"token function\">registerTool<\/span><span class=\"token punctuation\">(<\/span><span class=\"token keyword\">new<\/span> <span class=\"token class-name\">WeatherTools<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p>        <span class=\"token comment\">\/\/ &#061;&#061;&#061; 2. \u914d\u7f6e\u5de5\u5177\u8fc7\u6ee4 &#061;&#061;&#061;<\/span><br \/>\n        <span class=\"token class-name\">ToolsConfig<\/span> toolFilter <span class=\"token operator\">&#061;<\/span> <span class=\"token class-name\">ToolsConfig<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">builder<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">allow<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;query_order&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;track_logistics&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;request_refund&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;get_weather&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">deny<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;bash&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;write_file&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token string\">&#034;edit_file&#034;<\/span><span class=\"token punctuation\">)<\/span>  <span class=\"token comment\">\/\/ \u7981\u6b62\u5371\u9669\u64cd\u4f5c<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">build<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p>        <span class=\"token comment\">\/\/ &#061;&#061;&#061; 3. \u914d\u7f6e\u6743\u9650 &#061;&#061;&#061;<\/span><br \/>\n        <span class=\"token class-name\">PermissionContextState<\/span> permCtx <span class=\"token operator\">&#061;<\/span> <span class=\"token class-name\">PermissionContextState<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">builder<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">mode<\/span><span class=\"token punctuation\">(<\/span><span class=\"token class-name\">PermissionMode<\/span><span class=\"token punctuation\">.<\/span><span class=\"token constant\">DEFAULT<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">addAllowRule<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;query_order&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token class-name\">PermissionRule<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">allow<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;query_order&#034;<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">addAllowRule<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;track_logistics&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token class-name\">PermissionRule<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">allow<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;track_logistics&#034;<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">addAllowRule<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;get_weather&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token class-name\">PermissionRule<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">allow<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;get_weather&#034;<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">addAskRule<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;request_refund&#034;<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token class-name\">PermissionRule<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">ask<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;request_refund&#034;<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">build<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p>        <span class=\"token comment\">\/\/ &#061;&#061;&#061; 4. \u6784\u5efa Agent &#061;&#061;&#061;<\/span><br \/>\n        <span class=\"token class-name\">HarnessAgent<\/span> agent <span class=\"token operator\">&#061;<\/span> <span class=\"token class-name\">HarnessAgent<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">builder<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">name<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;ecommerce-cs&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">sysPrompt<\/span><span class=\"token punctuation\">(<\/span><span class=\"token triple-quoted-string string\">&#034;&#034;&#034;<br \/>\n                \u4f60\u662f\u7535\u5546\u5ba2\u670d\u52a9\u624b\u3002\u4f60\u53ef\u4ee5&#xff1a;<br \/>\n                &#8211; \u67e5\u8be2\u8ba2\u5355\u8be6\u60c5<br \/>\n                &#8211; \u8ffd\u8e2a\u7269\u6d41\u72b6\u6001<br \/>\n                &#8211; \u7533\u8bf7\u9000\u6b3e&#xff08;\u9700\u8981\u7528\u6237\u786e\u8ba4&#xff09;<br \/>\n                &#8211; \u67e5\u8be2\u5929\u6c14<br \/>\n                \u4f60\u4e0d\u80fd\u6267\u884c\u4efb\u4f55\u7cfb\u7edf\u547d\u4ee4\u6216\u4fee\u6539\u6587\u4ef6\u3002<br \/>\n                &#034;&#034;&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">model<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;dashscope:qwen-plus&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">toolkit<\/span><span class=\"token punctuation\">(<\/span>toolkit<span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">toolFilter<\/span><span class=\"token punctuation\">(<\/span>toolFilter<span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">permissionContext<\/span><span class=\"token punctuation\">(<\/span>permCtx<span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">middleware<\/span><span class=\"token punctuation\">(<\/span><span class=\"token keyword\">new<\/span> <span class=\"token class-name\">OtelTracingMiddleware<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">middleware<\/span><span class=\"token punctuation\">(<\/span><span class=\"token keyword\">new<\/span> <span class=\"token class-name\">AuditMiddleware<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">build<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p>        <span class=\"token comment\">\/\/ &#061;&#061;&#061; 5. \u6d41\u5f0f\u8c03\u7528 &#061;&#061;&#061;<\/span><br \/>\n        <span class=\"token class-name\">RuntimeContext<\/span> rt <span class=\"token operator\">&#061;<\/span> <span class=\"token class-name\">RuntimeContext<\/span><span class=\"token punctuation\">.<\/span><span class=\"token function\">builder<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">sessionId<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;session-001&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">userId<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;user-alice&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n            <span class=\"token punctuation\">.<\/span><span class=\"token function\">build<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><\/p>\n<p>        agent<span class=\"token punctuation\">.<\/span><span class=\"token function\">streamEvents<\/span><span class=\"token punctuation\">(<\/span><br \/>\n            <span class=\"token keyword\">new<\/span> <span class=\"token class-name\">UserMessage<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;\u5e2e\u6211\u67e5\u4e00\u4e0b\u8ba2\u5355 ORD-2024-001 \u7684\u7269\u6d41\u72b6\u6001&#034;<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">,<\/span><br \/>\n            rt<br \/>\n        <span class=\"token punctuation\">)<\/span><br \/>\n        <span class=\"token punctuation\">.<\/span><span class=\"token function\">doOnNext<\/span><span class=\"token punctuation\">(<\/span>event <span class=\"token operator\">-&gt;<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n            <span class=\"token keyword\">if<\/span> <span class=\"token punctuation\">(<\/span>event <span class=\"token keyword\">instanceof<\/span> <span class=\"token class-name\">TextBlockDeltaEvent<\/span> delta<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n                <span class=\"token class-name\">System<\/span><span class=\"token punctuation\">.<\/span>out<span class=\"token punctuation\">.<\/span><span class=\"token function\">print<\/span><span class=\"token punctuation\">(<\/span>delta<span class=\"token punctuation\">.<\/span><span class=\"token function\">getDelta<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n            <span class=\"token punctuation\">}<\/span><br \/>\n            <span class=\"token keyword\">if<\/span> <span class=\"token punctuation\">(<\/span>event <span class=\"token keyword\">instanceof<\/span> <span class=\"token class-name\">ToolCallStartEvent<\/span> toolStart<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n                <span class=\"token class-name\">System<\/span><span class=\"token punctuation\">.<\/span>out<span class=\"token punctuation\">.<\/span><span class=\"token function\">println<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;\\\\n&#x1f527; [&#034;<\/span> <span class=\"token operator\">&#043;<\/span> toolStart<span class=\"token punctuation\">.<\/span><span class=\"token function\">getToolCallName<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token operator\">&#043;<\/span> <span class=\"token string\">&#034;]&#034;<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n            <span class=\"token punctuation\">}<\/span><br \/>\n            <span class=\"token keyword\">if<\/span> <span class=\"token punctuation\">(<\/span>event <span class=\"token keyword\">instanceof<\/span> <span class=\"token class-name\">PermissionRequestEvent<\/span> permReq<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n                <span class=\"token class-name\">System<\/span><span class=\"token punctuation\">.<\/span>out<span class=\"token punctuation\">.<\/span><span class=\"token function\">println<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;\\\\n\u26a0\ufe0f \u9700\u8981\u5ba1\u6279: &#034;<\/span> <span class=\"token operator\">&#043;<\/span> permReq<span class=\"token punctuation\">.<\/span><span class=\"token function\">getToolName<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n            <span class=\"token punctuation\">}<\/span><br \/>\n        <span class=\"token punctuation\">}<\/span><span class=\"token punctuation\">)<\/span><br \/>\n        <span class=\"token punctuation\">.<\/span><span class=\"token function\">blockLast<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n    <span class=\"token punctuation\">}<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<h4>12.3 \u6267\u884c\u6548\u679c<\/h4>\n<p>\u7528\u6237: \u5e2e\u6211\u67e5\u4e00\u4e0b\u8ba2\u5355 ORD-2024-001 \u7684\u7269\u6d41\u72b6\u6001<\/p>\n<p>&#x1f527; [track_logistics]<br \/>\nAgent: \u60a8\u7684\u8ba2\u5355 ORD-2024-001 \u7684\u7269\u6d41\u72b6\u6001\u5982\u4e0b&#xff1a;<\/p>\n<p>&#x1f4e6; \u5f53\u524d\u72b6\u6001&#xff1a;\u8fd0\u8f93\u4e2d<br \/>\n&#x1f69a; \u627f\u8fd0\u5546&#xff1a;\u987a\u4e30\u901f\u8fd0<br \/>\n&#x1f4cd; \u5f53\u524d\u4f4d\u7f6e&#xff1a;\u676d\u5dde\u8f6c\u8fd0\u4e2d\u5fc3<br \/>\n\u23f0 \u9884\u8ba1\u9001\u8fbe&#xff1a;2026-08-09 14:00<\/p>\n<p>\u7269\u6d41\u8f68\u8ff9&#xff1a;<br \/>\n&#8211; 08-07 08:30 \u5230\u8fbe\u676d\u5dde\u8f6c\u8fd0\u4e2d\u5fc3<br \/>\n&#8211; 08-06 22:15 \u4ece\u4e0a\u6d77\u4ed3\u5e93\u53d1\u51fa<br \/>\n&#8211; 08-06 18:00 \u5546\u5bb6\u5df2\u53d1\u8d27<\/p>\n<p>\u5982\u9700\u8fdb\u4e00\u6b65\u5e2e\u52a9&#xff0c;\u8bf7\u968f\u65f6\u544a\u8bc9\u6211\u3002<\/p>\n<h3>\u5341\u4e09\u3001\u4ece 1.x \u5230 2.0 \u7684\u5de5\u5177\u7cfb\u7edf\u6f14\u8fdb<\/h3>\n<h4>13.1 \u5bf9\u6bd4\u603b\u7ed3<\/h4>\n<table>\n<tr>\u7ef4\u5ea61.x2.0<\/tr>\n<tbody>\n<tr>\n<td>\u5de5\u5177\u5b9a\u4e49<\/td>\n<td>\u7ee7\u627f Tool \u62bd\u8c61\u7c7b<\/td>\n<td>&#064;Tool \u6ce8\u89e3 &#043; \u53cd\u5c04<\/td>\n<\/tr>\n<tr>\n<td>Schema \u751f\u6210<\/td>\n<td>\u624b\u52a8\u7f16\u5199\u6216\u534a\u81ea\u52a8<\/td>\n<td>\u5168\u81ea\u52a8\u751f\u6210<\/td>\n<\/tr>\n<tr>\n<td>\u5de5\u5177\u7ba1\u7406<\/td>\n<td>\u7b80\u5355\u5217\u8868<\/td>\n<td>Toolkit &#043; ToolGroup<\/td>\n<\/tr>\n<tr>\n<td>\u52a8\u6001\u6fc0\u6d3b<\/td>\n<td>\u4e0d\u652f\u6301<\/td>\n<td>ToolGroup \u52a8\u6001\u5207\u6362<\/td>\n<\/tr>\n<tr>\n<td>\u6743\u9650\u7ba1\u63a7<\/td>\n<td>\u65e0<\/td>\n<td>PermissionEngine \u516d\u6b65\u51b3\u7b56<\/td>\n<\/tr>\n<tr>\n<td>\u6c99\u7bb1\u6267\u884c<\/td>\n<td>\u65e0<\/td>\n<td>LOCAL \/ DOCKER \/ E2B<\/td>\n<\/tr>\n<tr>\n<td>MCP \u96c6\u6210<\/td>\n<td>\u65e0<\/td>\n<td>tools.json \u58f0\u660e\u5f0f<\/td>\n<\/tr>\n<tr>\n<td>\u5de5\u5177\u8fc7\u6ee4<\/td>\n<td>\u786c\u7f16\u7801<\/td>\n<td>ToolsConfig \u914d\u7f6e\u5316<\/td>\n<\/tr>\n<tr>\n<td>\u6279\u5904\u7406<\/td>\n<td>\u4e32\u884c<\/td>\n<td>\u5e76\u53d1\u6267\u884c<\/td>\n<\/tr>\n<tr>\n<td>\u4e8b\u4ef6\u8ffd\u8e2a<\/td>\n<td>\u65e0<\/td>\n<td>ToolCallStart\/End\/Result<\/td>\n<\/tr>\n<tr>\n<td>\u524d\u7aef\u5de5\u5177<\/td>\n<td>\u65e0<\/td>\n<td>externalTool \u673a\u5236<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h4>13.2 \u8fc1\u79fb\u793a\u4f8b<\/h4>\n<p>1.x \u5199\u6cd5&#xff1a;<\/p>\n<p><span class=\"token comment\">\/\/ 1.x: \u7ee7\u627f\u62bd\u8c61\u7c7b&#xff0c;\u624b\u52a8\u5b9e\u73b0<\/span><br \/>\n<span class=\"token keyword\">public<\/span> <span class=\"token keyword\">class<\/span> <span class=\"token class-name\">WeatherTool<\/span> <span class=\"token keyword\">extends<\/span> <span class=\"token class-name\">Tool<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n    <span class=\"token annotation punctuation\">&#064;Override<\/span><br \/>\n    <span class=\"token keyword\">public<\/span> <span class=\"token class-name\">String<\/span> <span class=\"token function\">getName<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span> <span class=\"token keyword\">return<\/span> <span class=\"token string\">&#034;get_weather&#034;<\/span><span class=\"token punctuation\">;<\/span> <span class=\"token punctuation\">}<\/span><\/p>\n<p>    <span class=\"token annotation punctuation\">&#064;Override<\/span><br \/>\n    <span class=\"token keyword\">public<\/span> <span class=\"token class-name\">String<\/span> <span class=\"token function\">getDescription<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span> <span class=\"token keyword\">return<\/span> <span class=\"token string\">&#034;\u83b7\u53d6\u5929\u6c14&#034;<\/span><span class=\"token punctuation\">;<\/span> <span class=\"token punctuation\">}<\/span><\/p>\n<p>    <span class=\"token annotation punctuation\">&#064;Override<\/span><br \/>\n    <span class=\"token keyword\">public<\/span> <span class=\"token class-name\">Map<\/span><span class=\"token generics\"><span class=\"token punctuation\">&lt;<\/span><span class=\"token class-name\">String<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token class-name\">Object<\/span><span class=\"token punctuation\">&gt;<\/span><\/span> <span class=\"token function\">getParameterSchema<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n        <span class=\"token comment\">\/\/ \u624b\u52a8\u7f16\u5199 JSON Schema&#8230;<\/span><br \/>\n    <span class=\"token punctuation\">}<\/span><\/p>\n<p>    <span class=\"token annotation punctuation\">&#064;Override<\/span><br \/>\n    <span class=\"token keyword\">public<\/span> <span class=\"token class-name\">String<\/span> <span class=\"token function\">execute<\/span><span class=\"token punctuation\">(<\/span><span class=\"token class-name\">Map<\/span><span class=\"token generics\"><span class=\"token punctuation\">&lt;<\/span><span class=\"token class-name\">String<\/span><span class=\"token punctuation\">,<\/span> <span class=\"token class-name\">Object<\/span><span class=\"token punctuation\">&gt;<\/span><\/span> params<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n        <span class=\"token keyword\">return<\/span> weatherApi<span class=\"token punctuation\">.<\/span><span class=\"token function\">query<\/span><span class=\"token punctuation\">(<\/span><span class=\"token punctuation\">(<\/span><span class=\"token class-name\">String<\/span><span class=\"token punctuation\">)<\/span> params<span class=\"token punctuation\">.<\/span><span class=\"token function\">get<\/span><span class=\"token punctuation\">(<\/span><span class=\"token string\">&#034;city&#034;<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n    <span class=\"token punctuation\">}<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<p>2.0 \u5199\u6cd5&#xff1a;<\/p>\n<p><span class=\"token comment\">\/\/ 2.0: \u6ce8\u89e3\u9a71\u52a8&#xff0c;\u96f6\u6837\u677f\u4ee3\u7801<\/span><br \/>\n<span class=\"token keyword\">public<\/span> <span class=\"token keyword\">class<\/span> <span class=\"token class-name\">WeatherTools<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n    <span class=\"token annotation punctuation\">&#064;Tool<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;get_weather&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u83b7\u53d6\u5929\u6c14&#034;<\/span><span class=\"token punctuation\">)<\/span><br \/>\n    <span class=\"token keyword\">public<\/span> <span class=\"token class-name\">String<\/span> <span class=\"token function\">getWeather<\/span><span class=\"token punctuation\">(<\/span><br \/>\n            <span class=\"token annotation punctuation\">&#064;ToolParam<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;city&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u57ce\u5e02\u540d&#034;<\/span><span class=\"token punctuation\">)<\/span> <span class=\"token class-name\">String<\/span> city<span class=\"token punctuation\">)<\/span> <span class=\"token punctuation\">{<\/span><br \/>\n        <span class=\"token keyword\">return<\/span> weatherApi<span class=\"token punctuation\">.<\/span><span class=\"token function\">query<\/span><span class=\"token punctuation\">(<\/span>city<span class=\"token punctuation\">)<\/span><span class=\"token punctuation\">;<\/span><br \/>\n    <span class=\"token punctuation\">}<\/span><br \/>\n<span class=\"token punctuation\">}<\/span><\/p>\n<h3>\u5341\u56db\u3001\u8bbe\u8ba1\u54f2\u5b66\u4e0e\u6700\u4f73\u5b9e\u8df5<\/h3>\n<h4>14.1 \u6838\u5fc3\u8bbe\u8ba1\u539f\u5219<\/h4>\n<table>\n<tr>\u539f\u5219\u4f53\u73b0<\/tr>\n<tbody>\n<tr>\n<td>\u6ce8\u89e3\u9a71\u52a8 &gt; \u7ee7\u627f<\/td>\n<td>&#064;Tool \u6bd4\u7ee7\u627f Tool \u7c7b\u66f4\u8f7b\u91cf\u3001\u66f4 Java \u5316<\/td>\n<\/tr>\n<tr>\n<td>\u81ea\u52a8 &gt; \u624b\u52a8<\/td>\n<td>JSON Schema \u81ea\u52a8\u751f\u6210&#xff0c;\u65e0\u9700\u624b\u5199<\/td>\n<\/tr>\n<tr>\n<td>\u914d\u7f6e &gt; \u4ee3\u7801<\/td>\n<td>tools.json \u58f0\u660e MCP&#xff0c;toolFilter \u914d\u7f6e\u8fc7\u6ee4<\/td>\n<\/tr>\n<tr>\n<td>\u5b89\u5168\u4e0d\u53ef\u7ed5\u8fc7<\/td>\n<td>ToolBase.isSafe() \u5728\u6743\u9650\u7cfb\u7edf\u4e4b\u524d\u6267\u884c<\/td>\n<\/tr>\n<tr>\n<td>\u6a21\u578b\u81ea\u4e3b<\/td>\n<td>Agent \u81ea\u5df1\u51b3\u5b9a\u8c03\u7528\u54ea\u4e2a\u5de5\u5177\u3001\u4f55\u65f6\u8c03\u7528<\/td>\n<\/tr>\n<tr>\n<td>\u54cd\u5e94\u5f0f\u539f\u751f<\/td>\n<td>\u540c\u6b65\/\u5f02\u6b65\/\u6d41\u5f0f\u5168\u8986\u76d6<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h4>14.2 \u6700\u4f73\u5b9e\u8df5<\/h4>\n<li>\u5de5\u5177\u63cf\u8ff0\u8981\u7cbe\u786e&#xff1a;LLM \u4f9d\u8d56 description \u51b3\u5b9a\u4f55\u65f6\u8c03\u7528&#xff0c;\u6a21\u7cca\u63cf\u8ff0\u4f1a\u5bfc\u81f4\u8bef\u8c03\u7528<\/li>\n<li>\u53c2\u6570\u63cf\u8ff0\u8981\u5177\u4f53&#xff1a;\u5305\u542b\u793a\u4f8b\u503c\u3001\u53d6\u503c\u8303\u56f4\u3001\u683c\u5f0f\u8981\u6c42<\/li>\n<li>\u5355\u4e00\u804c\u8d23&#xff1a;\u6bcf\u4e2a\u5de5\u5177\u53ea\u505a\u4e00\u4ef6\u4e8b&#xff0c;\u907f\u514d&#034;\u4e07\u80fd\u5de5\u5177&#034;<\/li>\n<li>\u9519\u8bef\u4fe1\u606f\u8981\u6709\u7528&#xff1a;\u8fd4\u56de\u7684\u9519\u8bef\u4fe1\u606f\u5e94\u6307\u5bfc LLM \u5982\u4f55\u4fee\u6b63<\/li>\n<li>\u8f93\u51fa\u8981\u622a\u65ad&#xff1a;\u907f\u514d\u8d85\u957f\u8f93\u51fa\u6491\u7206\u4e0a\u4e0b\u6587<\/li>\n<li>\u654f\u611f\u64cd\u4f5c\u52a0 ASK&#xff1a;\u5220\u9664\u3001\u4fee\u6539\u3001\u652f\u4ed8\u7b49\u64cd\u4f5c\u5fc5\u987b\u4eba\u5de5\u786e\u8ba4<\/li>\n<li>\u4f7f\u7528 ToolGroup \u7ba1\u7406\u53ef\u89c1\u6027&#xff1a;\u907f\u514d 20&#043; \u5de5\u5177\u5168\u90e8\u66b4\u9732\u7ed9\u6a21\u578b<\/li>\n<h4>14.3 \u5de5\u5177\u63cf\u8ff0\u7f16\u5199\u6307\u5357<\/h4>\n<p><span class=\"token comment\">\/\/ \u274c \u5dee\u7684\u63cf\u8ff0<\/span><br \/>\n<span class=\"token annotation punctuation\">&#064;Tool<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;search&#034;<\/span><span class=\"token punctuation\">,<\/span> description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u641c\u7d22&#034;<\/span><span class=\"token punctuation\">)<\/span><\/p>\n<p><span class=\"token comment\">\/\/ \u2705 \u597d\u7684\u63cf\u8ff0<\/span><br \/>\n<span class=\"token annotation punctuation\">&#064;Tool<\/span><span class=\"token punctuation\">(<\/span>name <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;search_orders&#034;<\/span><span class=\"token punctuation\">,<\/span><br \/>\n      description <span class=\"token operator\">&#061;<\/span> <span class=\"token string\">&#034;\u6839\u636e\u8ba2\u5355\u53f7\u3001\u7528\u6237ID\u6216\u65f6\u95f4\u8303\u56f4\u641c\u7d22\u8ba2\u5355\u3002&#034;<\/span> <span class=\"token operator\">&#043;<\/span><br \/>\n                    <span class=\"token string\">&#034;\u8fd4\u56de\u8ba2\u5355\u5217\u8868&#xff08;\u6700\u591a20\u6761&#xff09;\u3002&#034;<\/span> <span class=\"token operator\">&#043;<\/span><br \/>\n                    <span class=\"token string\">&#034;\u5982\u679c\u7528\u6237\u53ea\u63d0\u4f9b\u4e86\u6a21\u7cca\u4fe1\u606f&#xff0c;\u5148\u7528\u6b64\u5de5\u5177\u786e\u8ba4\u5177\u4f53\u8ba2\u5355\u3002&#034;<\/span><span class=\"token punctuation\">)<\/span><\/p>\n<h3>\u5341\u4e94\u3001\u4e0e\u5176\u4ed6\u6784\u5efa\u5757\u7684\u534f\u4f5c\u5173\u7cfb<\/h3>\n<p>\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<br \/>\n\u2502                        Agent \u5c42                                   \u2502<br \/>\n\u2502   ReAct \u5faa\u73af&#xff1a;Reasoning \u2192 Acting \u2192 Observation \u2192 Reasoning      \u2502<br \/>\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<br \/>\n                               \u2502 \u51b3\u5b9a\u8c03\u7528\u5de5\u5177<br \/>\n                               \u25bc<br \/>\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<br \/>\n\u2502                     Middleware \u5c42                                 \u2502<br \/>\n\u2502   onActing: \u8ffd\u8e2a \/ \u9650\u6d41 \/ \u5ba1\u8ba1 \/ \u53c2\u6570\u6821\u9a8c                        \u2502<br \/>\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<br \/>\n                               \u2502<br \/>\n                               \u25bc<br \/>\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<br \/>\n\u2502                     Permission \u5c42                                 \u2502<br \/>\n\u2502   PermissionEngine: DENY \u2192 ASK \u2192 ALLOW \u2192 Mode \u2192 \u515c\u5e95            \u2502<br \/>\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<br \/>\n                               \u2502 ALLOW<br \/>\n                               \u25bc<br \/>\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<br \/>\n\u2502                       Tool \u5c42                                     \u2502<br \/>\n\u2502   Toolkit \u2192 ToolBase.execute() \u2192 \u6c99\u7bb1\u6267\u884c \u2192 \u8fd4\u56de\u7ed3\u679c             \u2502<br \/>\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<br \/>\n                               \u2502<br \/>\n                               \u25bc<br \/>\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<br \/>\n\u2502                      Event \u5c42                                     \u2502<br \/>\n\u2502   ToolCallStartEvent \u2192 ToolCallEndEvent \u2192 ToolResultEvent        \u2502<br \/>\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<br \/>\n                               \u2502<br \/>\n                               \u25bc<br \/>\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510<br \/>\n\u2502                     Message \u5c42                                    \u2502<br \/>\n\u2502   ToolUseBlock (ASSISTANT) \u2192 ToolResultBlock (TOOL)             \u2502<br \/>\n\u2502   \u5199\u5165 AgentState&#xff0c;\u53c2\u4e0e\u4e0a\u4e0b\u6587\u538b\u7f29                                  \u2502<br \/>\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<\/p>\n<h3>\u5341\u516d\u3001\u7ed3\u8bed<\/h3>\n<p>AgentScope Java 2.0 \u7684 Tool \u6784\u5efa\u5757&#xff0c;\u7528\u6ce8\u89e3\u9a71\u52a8\u5c06\u5de5\u5177\u5b9a\u4e49\u7b80\u5316\u5230\u6781\u81f4&#xff0c;\u7528\u81ea\u52a8 Schema \u751f\u6210\u6d88\u9664\u4e86\u624b\u5199 JSON \u7684\u7e41\u7410&#xff0c;\u7528 Toolkit &#043; ToolGroup \u5b9e\u73b0\u4e86\u7075\u6d3b\u7684\u5de5\u5177\u7f16\u6392&#xff0c;\u7528 MCP \u534f\u8bae\u6253\u901a\u4e86\u5916\u90e8\u5de5\u5177\u751f\u6001&#xff0c;\u7528\u6743\u9650\u7cfb\u7edf &#043; \u6c99\u7bb1\u5b88\u4f4f\u4e86\u5b89\u5168\u5e95\u7ebf\u3002 \u5b83\u7684\u6838\u5fc3\u4ef7\u503c\u5728\u4e8e&#xff1a;<\/p>\n<p>\u8ba9&#034;\u7ed9 Agent \u52a0\u4e00\u4e2a\u80fd\u529b&#034;\u8fd9\u4ef6\u4e8b&#xff0c;\u4ece&#034;\u5199\u4e00\u4e2a\u7c7b &#043; \u914d\u4e00\u5806 Schema &#043; \u5904\u7406\u4e00\u5806\u5f02\u5e38&#034;&#xff0c;\u53d8\u6210&#034;\u52a0\u4e00\u4e2a\u6ce8\u89e3&#034;\u3002<\/p>\n<p>\u5bf9\u4e8e Java \u5f00\u53d1\u8005\u800c\u8a00&#xff0c;\u8fd9\u5957\u8bbe\u8ba1\u5b8c\u7f8e\u5951\u5408\u4e86 Spring \u751f\u6001\u7684\u6ce8\u89e3\u9a71\u52a8\u4f20\u7edf\u2014\u2014&#064;Tool \u4e4b\u4e8e AgentScope&#xff0c;\u5c31\u50cf &#064;RestController \u4e4b\u4e8e Spring MVC&#xff1a;\u4e00\u4e2a\u6ce8\u89e3&#xff0c;\u5f00\u542f\u4e00\u4e2a\u4e16\u754c\u3002<\/p>\n<p>\u5de5\u5177\u5b9a\u4e49\u4e86\u667a\u80fd\u4f53&#034;\u80fd\u505a\u4ec0\u4e48&#034;&#xff0c;\u6743\u9650\u5b9a\u4e49\u4e86&#034;\u5141\u8bb8\u505a\u4ec0\u4e48&#034;&#xff0c;\u4e8b\u4ef6\u5b9a\u4e49\u4e86&#034;\u6b63\u5728\u505a\u4ec0\u4e48&#034;\u3002\u4e09\u8005\u5408\u4e00&#xff0c;\u6784\u6210\u4e86\u4e00\u4e2a\u65e2\u80fd\u505a\u4e8b\u3001\u53c8\u53d7\u7ea6\u675f\u3001\u8fd8\u53ef\u89c2\u6d4b\u7684\u667a\u80fd\u4f53\u6267\u884c\u4f53\u7cfb\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u76ee\u5f55&#xff1a; 1. \u9762\u5411\u751f\u4ea7\u73af\u5883\u7684\u667a\u80fd\u4f53\u5de5\u7a0b\u5e73\u53f0 2. \u5feb\u901f\u4e0a\u624b \u4ece\u96f6\u6784\u5efa\u751f\u4ea7\u7ea7\u667a\u80fd\u4f53 3. Agent \u2014\u2014 \u667a\u80fd\u4f53\u7684\u6838\u5fc3\u62bd\u8c61\u4e0e\u5de5\u7a0b\u5316\u5b9e\u8df5 4. Message &amp; Event \u2014\u2014 \u6d88\u606f\u6a21\u578b\u4e0e\u4e8b\u4ef6\u6d41\u6df1\u5ea6\u89e3 5. Middleware \u2014\u2014 \u65e0\u4fb5\u5165\u5f0f\u667a\u80fd\u4f53\u6269\u5c55\u673a\u5236\u6df1\u5ea6\u89e3\u6790 6. Model \u2014\u2014 \u7edf\u4e00\u6a21\u578b\u63a5\u5165\u5c42\u4e0e\u5bb9\u9519\u673a\u5236\u6df1\u5ea6\u89e3\u6790 7. Permission System \u2014\u2014 \u6743\u9650\u63a7\u5236\u7cfb\u7edf\u6df1\u5ea6\u89e3\u6790 8. Tool \u2014\u2014 \u5de5\u5177\u7cfb\u7edf\u67b6\u6784\u4e0e\u751f\u4ea7\u7ea7\u5b9e\u8df5\u6df1\u5ea6\u89e3\u6790 9. Con<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[66,53,50,442],"topic":[],"class_list":["post-99682","post","type-post","status-publish","format-standard","hentry","category-server","tag-ai","tag-50","tag-442"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v20.3 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>AgentScope 2.0\uff1a8. Tool \u2014\u2014 \u5de5\u5177\u7cfb\u7edf\u67b6\u6784\u4e0e\u751f\u4ea7\u7ea7\u5b9e\u8df5\u6df1\u5ea6\u89e3\u6790 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.wsisp.com\/helps\/99682.html\" \/>\n<meta property=\"og:locale\" content=\"zh_CN\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"AgentScope 2.0\uff1a8. Tool \u2014\u2014 \u5de5\u5177\u7cfb\u7edf\u67b6\u6784\u4e0e\u751f\u4ea7\u7ea7\u5b9e\u8df5\u6df1\u5ea6\u89e3\u6790 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\" \/>\n<meta property=\"og:description\" content=\"\u76ee\u5f55&#xff1a; 1. \u9762\u5411\u751f\u4ea7\u73af\u5883\u7684\u667a\u80fd\u4f53\u5de5\u7a0b\u5e73\u53f0 2. \u5feb\u901f\u4e0a\u624b \u4ece\u96f6\u6784\u5efa\u751f\u4ea7\u7ea7\u667a\u80fd\u4f53 3. Agent \u2014\u2014 \u667a\u80fd\u4f53\u7684\u6838\u5fc3\u62bd\u8c61\u4e0e\u5de5\u7a0b\u5316\u5b9e\u8df5 4. Message &amp; Event \u2014\u2014 \u6d88\u606f\u6a21\u578b\u4e0e\u4e8b\u4ef6\u6d41\u6df1\u5ea6\u89e3 5. Middleware \u2014\u2014 \u65e0\u4fb5\u5165\u5f0f\u667a\u80fd\u4f53\u6269\u5c55\u673a\u5236\u6df1\u5ea6\u89e3\u6790 6. Model \u2014\u2014 \u7edf\u4e00\u6a21\u578b\u63a5\u5165\u5c42\u4e0e\u5bb9\u9519\u673a\u5236\u6df1\u5ea6\u89e3\u6790 7. Permission System \u2014\u2014 \u6743\u9650\u63a7\u5236\u7cfb\u7edf\u6df1\u5ea6\u89e3\u6790 8. Tool \u2014\u2014 \u5de5\u5177\u7cfb\u7edf\u67b6\u6784\u4e0e\u751f\u4ea7\u7ea7\u5b9e\u8df5\u6df1\u5ea6\u89e3\u6790 9. Con\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.wsisp.com\/helps\/99682.html\" \/>\n<meta property=\"og:site_name\" content=\"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\" \/>\n<meta property=\"article:published_time\" content=\"2026-09-02T16:37:11+00:00\" \/>\n<meta name=\"author\" content=\"admin\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"\u4f5c\u8005\" \/>\n\t<meta name=\"twitter:data1\" content=\"admin\" \/>\n\t<meta name=\"twitter:label2\" content=\"\u9884\u8ba1\u9605\u8bfb\u65f6\u95f4\" \/>\n\t<meta name=\"twitter:data2\" content=\"9 \u5206\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/99682.html\",\"url\":\"https:\/\/www.wsisp.com\/helps\/99682.html\",\"name\":\"AgentScope 2.0\uff1a8. Tool \u2014\u2014 \u5de5\u5177\u7cfb\u7edf\u67b6\u6784\u4e0e\u751f\u4ea7\u7ea7\u5b9e\u8df5\u6df1\u5ea6\u89e3\u6790 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\",\"isPartOf\":{\"@id\":\"https:\/\/www.wsisp.com\/helps\/#website\"},\"datePublished\":\"2026-09-02T16:37:11+00:00\",\"dateModified\":\"2026-09-02T16:37:11+00:00\",\"author\":{\"@id\":\"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41\"},\"breadcrumb\":{\"@id\":\"https:\/\/www.wsisp.com\/helps\/99682.html#breadcrumb\"},\"inLanguage\":\"zh-Hans\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.wsisp.com\/helps\/99682.html\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/99682.html#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"\u9996\u9875\",\"item\":\"https:\/\/www.wsisp.com\/helps\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"AgentScope 2.0\uff1a8. Tool \u2014\u2014 \u5de5\u5177\u7cfb\u7edf\u67b6\u6784\u4e0e\u751f\u4ea7\u7ea7\u5b9e\u8df5\u6df1\u5ea6\u89e3\u6790\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/#website\",\"url\":\"https:\/\/www.wsisp.com\/helps\/\",\"name\":\"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\",\"description\":\"\u9999\u6e2f\u670d\u52a1\u5668_\u9999\u6e2f\u4e91\u670d\u52a1\u5668\u8d44\u8baf_\u670d\u52a1\u5668\u5e2e\u52a9\u6587\u6863_\u670d\u52a1\u5668\u6559\u7a0b\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.wsisp.com\/helps\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"zh-Hans\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41\",\"name\":\"admin\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"zh-Hans\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery\",\"contentUrl\":\"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery\",\"caption\":\"admin\"},\"sameAs\":[\"http:\/\/wp.wsisp.com\"],\"url\":\"https:\/\/www.wsisp.com\/helps\/author\/admin\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"AgentScope 2.0\uff1a8. Tool \u2014\u2014 \u5de5\u5177\u7cfb\u7edf\u67b6\u6784\u4e0e\u751f\u4ea7\u7ea7\u5b9e\u8df5\u6df1\u5ea6\u89e3\u6790 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.wsisp.com\/helps\/99682.html","og_locale":"zh_CN","og_type":"article","og_title":"AgentScope 2.0\uff1a8. Tool \u2014\u2014 \u5de5\u5177\u7cfb\u7edf\u67b6\u6784\u4e0e\u751f\u4ea7\u7ea7\u5b9e\u8df5\u6df1\u5ea6\u89e3\u6790 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","og_description":"\u76ee\u5f55&#xff1a; 1. \u9762\u5411\u751f\u4ea7\u73af\u5883\u7684\u667a\u80fd\u4f53\u5de5\u7a0b\u5e73\u53f0 2. \u5feb\u901f\u4e0a\u624b \u4ece\u96f6\u6784\u5efa\u751f\u4ea7\u7ea7\u667a\u80fd\u4f53 3. Agent \u2014\u2014 \u667a\u80fd\u4f53\u7684\u6838\u5fc3\u62bd\u8c61\u4e0e\u5de5\u7a0b\u5316\u5b9e\u8df5 4. Message &amp; Event \u2014\u2014 \u6d88\u606f\u6a21\u578b\u4e0e\u4e8b\u4ef6\u6d41\u6df1\u5ea6\u89e3 5. Middleware \u2014\u2014 \u65e0\u4fb5\u5165\u5f0f\u667a\u80fd\u4f53\u6269\u5c55\u673a\u5236\u6df1\u5ea6\u89e3\u6790 6. Model \u2014\u2014 \u7edf\u4e00\u6a21\u578b\u63a5\u5165\u5c42\u4e0e\u5bb9\u9519\u673a\u5236\u6df1\u5ea6\u89e3\u6790 7. Permission System \u2014\u2014 \u6743\u9650\u63a7\u5236\u7cfb\u7edf\u6df1\u5ea6\u89e3\u6790 8. Tool \u2014\u2014 \u5de5\u5177\u7cfb\u7edf\u67b6\u6784\u4e0e\u751f\u4ea7\u7ea7\u5b9e\u8df5\u6df1\u5ea6\u89e3\u6790 9. Con","og_url":"https:\/\/www.wsisp.com\/helps\/99682.html","og_site_name":"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","article_published_time":"2026-09-02T16:37:11+00:00","author":"admin","twitter_card":"summary_large_image","twitter_misc":{"\u4f5c\u8005":"admin","\u9884\u8ba1\u9605\u8bfb\u65f6\u95f4":"9 \u5206"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.wsisp.com\/helps\/99682.html","url":"https:\/\/www.wsisp.com\/helps\/99682.html","name":"AgentScope 2.0\uff1a8. Tool \u2014\u2014 \u5de5\u5177\u7cfb\u7edf\u67b6\u6784\u4e0e\u751f\u4ea7\u7ea7\u5b9e\u8df5\u6df1\u5ea6\u89e3\u6790 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","isPartOf":{"@id":"https:\/\/www.wsisp.com\/helps\/#website"},"datePublished":"2026-09-02T16:37:11+00:00","dateModified":"2026-09-02T16:37:11+00:00","author":{"@id":"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41"},"breadcrumb":{"@id":"https:\/\/www.wsisp.com\/helps\/99682.html#breadcrumb"},"inLanguage":"zh-Hans","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.wsisp.com\/helps\/99682.html"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.wsisp.com\/helps\/99682.html#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"\u9996\u9875","item":"https:\/\/www.wsisp.com\/helps"},{"@type":"ListItem","position":2,"name":"AgentScope 2.0\uff1a8. Tool \u2014\u2014 \u5de5\u5177\u7cfb\u7edf\u67b6\u6784\u4e0e\u751f\u4ea7\u7ea7\u5b9e\u8df5\u6df1\u5ea6\u89e3\u6790"}]},{"@type":"WebSite","@id":"https:\/\/www.wsisp.com\/helps\/#website","url":"https:\/\/www.wsisp.com\/helps\/","name":"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","description":"\u9999\u6e2f\u670d\u52a1\u5668_\u9999\u6e2f\u4e91\u670d\u52a1\u5668\u8d44\u8baf_\u670d\u52a1\u5668\u5e2e\u52a9\u6587\u6863_\u670d\u52a1\u5668\u6559\u7a0b","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.wsisp.com\/helps\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"zh-Hans"},{"@type":"Person","@id":"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41","name":"admin","image":{"@type":"ImageObject","inLanguage":"zh-Hans","@id":"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/image\/","url":"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery","contentUrl":"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery","caption":"admin"},"sameAs":["http:\/\/wp.wsisp.com"],"url":"https:\/\/www.wsisp.com\/helps\/author\/admin"}]}},"_links":{"self":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/posts\/99682","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/comments?post=99682"}],"version-history":[{"count":0,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/posts\/99682\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/media?parent=99682"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/categories?post=99682"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/tags?post=99682"},{"taxonomy":"topic","embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/topic?post=99682"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}