{"id":678819,"date":"2026-02-12T10:23:52","date_gmt":"2026-02-12T09:23:52","guid":{"rendered":"https:\/\/blog.jetbrains.com\/?post_type=ai&#038;p=678819"},"modified":"2026-02-12T11:07:48","modified_gmt":"2026-02-12T10:07:48","slug":"building-ai-agents-in-kotlin-part-2-a-deeper-dive-into-tools","status":"publish","type":"ai","link":"https:\/\/blog.jetbrains.com\/zh-hans\/ai\/2026\/02\/building-ai-agents-in-kotlin-part-2-a-deeper-dive-into-tools\/","title":{"rendered":"\u4f7f\u7528 Kotlin \u6784\u5efa AI \u667a\u80fd\u4f53 \u2013 \u7b2c 2 \u90e8\u5206\uff1a\u6df1\u5165\u63a2\u8ba8\u5de5\u5177\u00a0"},"content":{"rendered":"<p>\u5728<a href=\"https:\/\/blog.jetbrains.com\/ai\/2025\/11\/building-ai-agents-in-kotlin-part-1-a-minimal-coding-agent\/\">\u4e0a\u4e00\u7bc7\u6587\u7ae0<\/a>\u4e2d\uff0c\u6211\u4eec\u4e86\u89e3\u4e86\u5982\u4f55\u6784\u5efa\u5177\u6709\u5217\u8868\u3001\u8bfb\u53d6\u3001\u5199\u5165\u548c\u7f16\u8f91\u80fd\u529b\u7684\u57fa\u672c\u7f16\u7801\u667a\u80fd\u4f53\u3002\u4eca\u5929\uff0c\u6211\u4eec\u5c06\u6df1\u5165\u63a2\u8ba8\u5982\u4f55\u901a\u8fc7\u5728 <a href=\"https:\/\/www.jetbrains.com\/koog\/\" target=\"_blank\" rel=\"noopener\">Koog<\/a> \u6846\u67b6\u5185\u521b\u5efa\u9644\u52a0\u5de5\u5177\u6765<a href=\"https:\/\/github.com\/JetBrains\/koog\/tree\/develop\/examples\/code-agent\/step-02-add-execution-tool\" target=\"_blank\" rel=\"noopener\">\u6269\u5c55\u667a\u80fd\u4f53\u7684\u80fd\u529b<\/a>\u3002\u6211\u4eec\u5c06\u4ee5\u6784\u5efa <code>ExecuteShellCommandTool<\/code> \u4e3a\u4f8b\uff0c\u6559\u4f1a\u667a\u80fd\u4f53\u8fd0\u884c\u4ee3\u7801\uff0c\u5e76\u5f62\u6210\u5b9e\u9645\u5de5\u7a0b\u6240\u4f9d\u8d56\u7684\u53cd\u9988\u56de\u8def\uff1a\u8fd0\u884c\u4ee3\u7801\u3001\u89c2\u5bdf\u5931\u8d25\uff0c\u5e76\u6839\u636e\u5b9e\u9645\u8f93\u51fa\u6539\u8fdb\u4ee3\u7801\u3002<\/p>\n<p>\u5c3d\u7ba1 LLM \u901a\u5e38\u64c5\u957f\u907f\u514d\u8bed\u6cd5\u9519\u8bef\uff0c\u4f46\u5728\u5904\u7406\u96c6\u6210\u95ee\u9898\u65f6\u4ecd\u5b58\u5728\u56f0\u96be\u3002\u4f8b\u5982\uff0c\u5b83\u4eec\u6709\u53ef\u80fd\u4f1a\u8c03\u7528\u4e0d\u5b58\u5728\u7684\u65b9\u6cd5\u3001\u9057\u6f0f\u5bfc\u5165\uff0c\u6216\u4ec5\u90e8\u5206\u5b9e\u73b0\u63a5\u53e3\u3002\u7f16\u8bd1\u548c\u8fd0\u884c\u4ee3\u7801\u7684\u4f20\u7edf\u65b9\u5f0f\u4f1a\u7acb\u5373\u66b4\u9732\u8fd9\u4e9b\u95ee\u9898\u3002\u4f46\u6709\u4e86\u5c11\u91cf\u7684\u989d\u5916\u63d0\u793a\uff0c\u6211\u4eec\u53ef\u4ee5\u4fc3\u4f7f LLM \u8fd0\u884c\u5c0f\u89c4\u6a21\u6d4b\u8bd5\u6765\u9a8c\u8bc1\u6b64\u7c7b\u884c\u4e3a\u3002<\/p>\n<p>\u90a3\u4e48\uff0c\u6211\u4eec\u5982\u4f55\u6784\u5efa\u8fd9\u7c7b\u5de5\u5177\u5462\uff1f \u6211\u4eec\u5148\u4ece\u57fa\u7840\u77e5\u8bc6\u8bb2\u8d77\u3002<\/p>\n<h2 class=\"wp-block-heading\">Koog \u5de5\u5177\u91c7\u7528\u7684\u5177\u4f53\u7ed3\u6784\u662f\u4ec0\u4e48\uff1f<\/h2>\n<p>\u9996\u5148\uff0c\u6211\u4eec\u8981\u7ee7\u627f\u62bd\u8c61<a href=\"https:\/\/docs.koog.ai\/class-based-tools\/\" target=\"_blank\" rel=\"noopener\">\u7c7b<\/a> <code>ai.koog.agents.core.tools.Tool<\/code>\uff0c\u5b83\u544a\u8bc9\u6211\u4eec\u9700\u8981\u63d0\u4f9b\uff1a<\/p>\n<ol>\n<li><strong>\u540d\u79f0<\/strong>\uff1a\u5728\u6211\u4eec\u56e2\u961f\u4e2d\uff0c\u6211\u4eec\u559c\u6b22\u9075\u5faa <code>snake_casing<\/code> \u7ea6\u5b9a\uff0c\u5373\u4f7f\u7528\u53cc\u4e0b\u5212\u7ebf\u5305\u56f4\u540d\u79f0\uff0c\u4f46\u8fd9\u53ea\u662f\u4e2a\u4eba\u504f\u597d\u3002<\/li>\n<li><strong>\u63cf\u8ff0<\/strong>\uff1a\u6b64\u5b57\u6bb5\u4f5c\u4e3a LLM \u7684\u4e3b\u8981\u6587\u6863\uff0c\u89e3\u91ca\u4e86\u5de5\u5177\u7684\u4f5c\u7528\u548c\u8c03\u7528\u539f\u56e0\u3002<\/li>\n<li><code>Args<\/code><strong> \u7c7b<\/strong>\uff1a\u6b64\u7c7b\u63cf\u8ff0\u4e86\u8c03\u7528\u5de5\u5177\u65f6 LLM \u9700\u8981\u63d0\u4f9b\u6216\u53ef\u4ee5\u63d0\u4f9b\u7684\u5f62\u53c2\u3002<\/li>\n<li><code>Result<\/code><strong> \u7c7b<\/strong>\uff1a\u6b64\u7c7b\u5b9a\u4e49\u4e86\u5c06\u683c\u5f0f\u5316\u4e3a\u6d88\u606f\u4f9b LLM \u8bfb\u53d6\u7684\u6570\u636e\u3002\u5b83\u53ef\u4ee5\u5305\u542b <code>textForLLM()<\/code> \u51fd\u6570\uff0c\u8be5\u51fd\u6570\u7528\u4e8e\u5c06\u6570\u636e\u683c\u5f0f\u5316\u4e3a\u5b57\u7b26\u4e32\uff0c\u4f9b LLM \u8bfb\u53d6\u3002\u5f15\u5165 <code>Result<\/code> \u7c7b\u7684\u4e3b\u8981\u76ee\u7684\u662f\u4e3a\u5f00\u53d1\u8005\u63d0\u4f9b\u4fbf\u5229\uff0c\u4ee5\u4fbf\u66f4\u8f7b\u677e\u5730\u8bb0\u5f55\u65e5\u5fd7\u6216\u5728 UI \u4e2d\u5448\u73b0\u5de5\u5177\u7ed3\u679c\u3002\u667a\u80fd\u4f53\u672c\u8eab\u53ea\u9700\u8981\u683c\u5f0f\u5316\u540e\u7684\u5b57\u7b26\u4e32\u3002<\/li>\n<li><code>Execute()<\/code><strong> \u65b9\u6cd5<\/strong>\uff1a\u6b64\u65b9\u6cd5\u63a5\u6536 Args \u7684\u5b9e\u4f8b\uff0c\u5e76\u8fd4\u56de <code>Result<\/code> \u7684\u5b9e\u4f8b\u3002\u5b83\u5b9a\u4e49\u4e86 LLM \u8c03\u7528\u5de5\u5177\u65f6\u6267\u884c\u7684\u903b\u8f91\u3002<\/li>\n<\/ol>\n<p>\u8fd9\u4e9b\u7ec4\u4ef6\u6784\u6210\u4e86\u6bcf\u4e2a Koog \u5de5\u5177\u7684\u57fa\u7840\uff0c\u65e0\u8bba\u662f\u6784\u5efa\u6570\u636e\u5e93\u8fde\u63a5\u5668\u3001API \u5ba2\u6237\u7aef\uff0c\u8fd8\u662f\u6211\u4eec\u4eca\u5929\u5c06\u770b\u5230\u7684 shell \u547d\u4ee4\u6267\u884c\u5668\u3002\u6211\u4eec\u901a\u8fc7\u6784\u5efa <code>ExecuteShellCommandTool<\/code> \u6765\u5177\u4f53\u4e86\u89e3\u8fd9\u4e9b\u539f\u5219\u7684\u5b9e\u9645\u5e94\u7528\u3002<\/p>\n<h3 class=\"wp-block-heading\"><strong>\u5173\u4e8e\u5b89\u5168\u7684\u7b80\u8981\u8bf4\u660e<\/strong><\/h3>\n<p>\u5728\u6df1\u5165\u63a2\u8ba8 <code>ExecuteShellCommandTool<\/code> \u7684\u7ec6\u8282\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u89e3\u51b3\u51e0\u4e2a\u5173\u952e\u7684\u5b89\u5168\u8003\u91cf\u56e0\u7d20\u3002<\/p>\n<p>\u867d\u7136 LLM \u5e76\u4e0d\u662f\u6709\u610f\u5236\u9020\u95ee\u9898\u7684\u6076\u610f\u884c\u4e3a\u8005\uff0c\u4f46\u5b83\u4eec\u786e\u5b9e\u5076\u5c14\u4f1a\u72af\u4e0b\u610f\u60f3\u4e0d\u5230\u7684\u9519\u8bef\uff0c\u8fdb\u800c\u53ef\u80fd\u5bfc\u81f4\u540e\u7eed\u95ee\u9898\u3002\u5982\u679c\u6211\u4eec\u5c06\u4e3a\u5176\u8d4b\u4e88\u547d\u4ee4\u884c\u6267\u884c\u7684\u6743\u529b\uff0c\u8fd9\u4e9b\u9519\u8bef\u53ef\u80fd\u5f15\u53d1\u4e25\u91cd\u540e\u679c\u3002<\/p>\n<p>\u4e0d\u8fc7\uff0c\u53ef\u4ee5\u901a\u8fc7\u51e0\u79cd\u65b9\u6cd5\u7f13\u89e3\u8fd9\u79cd\u98ce\u9669\uff0c\u5305\u62ec\u5728\u9694\u79bb\u73af\u5883\u4e2d\u5bf9\u547d\u4ee4\u6267\u884c\u8fdb\u884c\u6c99\u76d2\u5904\u7406\uff0c\u548c\/\u6216\u9650\u5236\u4f60\u6388\u4e88\u5b83\u4eec\u7684\u6743\u9650\u3002\u4f46\u8fd9\u4e9b\u65b9\u6cd5\u5b9e\u73b0\u8d77\u6765\u53ef\u80fd\u76f8\u5f53\u590d\u6742\uff0c\u6211\u4eec\u73b0\u5728\u7684\u5173\u6ce8\u70b9\u662f\u521b\u5efa\u5b9e\u9645\u5de5\u5177\u3002<\/p>\n<p>\u9274\u4e8e\u6b64\uff0c\u6211\u4eec\u5c06\u63d0\u4f9b\u4e24\u79cd\u6700\u7b80\u5355\u7684\u98ce\u9669\u7f13\u89e3\u7b56\u7565\uff1a<\/p>\n<ol>\n<li>\u5bf9\u6bcf\u6761\u547d\u4ee4\u8fdb\u884c<strong>\u547d\u4ee4\u6267\u884c\u786e\u8ba4<\/strong>\u3002\u8fd9\u662f\u6700\u5b89\u5168\u7684\u9009\u62e9\uff0c\u53ea\u8981\u6211\u4eec\u82b1\u4e00\u70b9\u65f6\u95f4\u68c0\u67e5 LLM \u60f3\u8981\u6267\u884c\u7684\u6bcf\u4e00\u6761\u547d\u4ee4\u5373\u53ef\uff0c\u4f46\u8fd9\u79cd\u65b9\u5f0f\u786e\u5b9e\u4e25\u91cd\u9650\u5236\u4e86\u667a\u80fd\u4f53\u7684\u81ea\u4e3b\u6027\u3002<\/li>\n<li><strong><em>Brave<\/em><\/strong><strong> \u6a21\u5f0f<\/strong>\uff0c\u5728\u8be5\u6a21\u5f0f\u4e0b\uff0c\u4f1a\u81ea\u52a8\u6279\u51c6\u6bcf\u6761\u547d\u4ee4\u3002\u867d\u7136\u6b64\u6a21\u5f0f\u4f1a\u5728\u672a\u6b63\u786e\u8fdb\u884c\u6c99\u76d2\u5904\u7406\u7684\u60c5\u51b5\u4e0b\u5bf9\u4f60\u5728\u4f7f\u7528\u7684\u673a\u5668\u6784\u6210\u98ce\u9669\uff0c\u4f46\u6211\u4eec\u53ea\u4f1a\u5728\u81ea\u5df1\u7684\u57fa\u51c6\u6d4b\u8bd5\u4e2d\u4f7f\u7528\u6b64\u6a21\u5f0f\uff0c\u8fd9\u4e9b\u57fa\u51c6\u6d4b\u8bd5\u5728\u53ef\u9500\u6bc1\u7684\u9694\u79bb\u73af\u5883\u4e2d\u8fd0\u884c\uff0c\u4e0d\u4f1a\u4ea7\u751f\u4efb\u4f55\u540e\u679c\u3002<\/li>\n<\/ol>\n<h2 class=\"wp-block-heading\">\u5b9e\u73b0 <strong><code>ExecuteShellCommandTool<\/code><\/strong><\/h2>\n<div class=\"slider slider-full\">\n<div class=\"slider__slide\">\n                    <a href=\"https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2025\/11\/DSGN-24422-01_Exec-tool.png\"><br \/>\n                        <img decoding=\"async\" src=\"https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2025\/11\/DSGN-24422-01_Exec-tool.png\" alt=\"\"><br \/>\n                    <\/a>\n                <\/div>\n<div class=\"slider__slide\">\n                    <a href=\"https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2025\/11\/DSGN-24422-02_Data-flow.png\"><br \/>\n                        <img decoding=\"async\" src=\"https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2025\/11\/DSGN-24422-02_Data-flow.png\" alt=\"\"><br \/>\n                    <\/a>\n                <\/div>\n<div class=\"slider__slide\">\n                    <a href=\"https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2025\/11\/DSGN-24422-03_Confirmation-handler.png\"><br \/>\n                        <img decoding=\"async\" src=\"https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2025\/11\/DSGN-24422-03_Confirmation-handler.png\" alt=\"\"><br \/>\n                    <\/a>\n                <\/div>\n<div class=\"slider__slide\">\n                    <a href=\"https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2025\/11\/DSGN-24422-04_Executor.png\"><br \/>\n                        <img decoding=\"async\" src=\"https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2025\/11\/DSGN-24422-04_Executor.png\" alt=\"\"><br \/>\n                    <\/a>\n                <\/div>\n<\/p>\n<\/div>\n<p><a href=\"https:\/\/github.com\/JetBrains\/koog\/blob\/develop\/agents\/agents-ext\/src\/commonMain\/kotlin\/ai\/koog\/agents\/ext\/tool\/shell\/ExecuteShellCommandTool.kt\" target=\"_blank\" rel=\"noopener\">\u5bf9\u4e8e\u6211\u4eec\u7684 <code>ExecuteShellCommandTool<\/code><\/a>\uff0c\u8fd9\u4e9b\u7ec4\u4ef6\u5982\u4e0b\uff1a<\/p>\n<ol>\n<li><strong>\u540d\u79f0<\/strong>\uff1a<code>__execute_shell_command__<\/code>\u3002<\/li>\n<li><strong>\u63cf\u8ff0<\/strong>\uff1a\u7c7b\u4f3c\u4e8e\u201c\u6267\u884c shell \u547d\u4ee4\u5e76\u8fd4\u56de\u5176\u8f93\u51fa\u201d\u3002<\/li>\n<li><code>Args<\/code> <strong>\u7c7b<\/strong>\uff1a<code>command<\/code>\u3001<code>timeoutSeconds<\/code>\u3001<code>workingDirectory<\/code><\/li>\n<li><code>Result<\/code> <strong>\u7c7b<\/strong>\uff1a<code>output<\/code>\u3001<code>exitCode<\/code>\u3001<code>command<\/code>\uff08\u770b\u4f3c\u4ee4\u4eba\u610f\u5916\uff0c\u4f46\u4fbf\u4e8e\u5728\u65e5\u5fd7\u6216 UI \u4e2d\u62a5\u544a\u8fd0\u884c\u7684\u547d\u4ee4\uff09\u3002<\/li>\n<li><code>Execute()<\/code><strong> \u65b9\u6cd5<\/strong>\uff1a\u8bf7\u6c42\u786e\u8ba4\uff0c\u7136\u540e\u6267\u884c\u547d\u4ee4\uff08\u6211\u4eec\u5c06\u5728\u540e\u6587\u4e2d\u5177\u4f53\u63a2\u8ba8\u5b9e\u73b0\u7ec6\u8282\uff09\u3002<\/li>\n<\/ol>\n<h2 class=\"wp-block-heading\"><code>Execute()<\/code><strong> \u65b9\u6cd5\u5b9e\u73b0<\/strong><\/h2>\n<p>\u73b0\u5728\uff0c\u6211\u4eec\u6765\u770b\u4e00\u4e0b\u5982\u4f55\u5b9e\u73b0 execute() \u65b9\u6cd5\u3002\u6211\u4eec\u901a\u8fc7\u5c06\u6838\u5fc3\u903b\u8f91\u59d4\u6258\u7ed9\u5e2e\u52a9\u7a0b\u5e8f\u65b9\u6cd5\u6765\u786e\u4fdd\u65b9\u6cd5\u7684\u7b80\u6d01\u6027\uff0c\u5177\u4f53\u5982\u4e0b\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"kotlin\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">override suspend fun execute(args: Args): Result = when (\n        val confirmation = confirmationHandler.requestConfirmation(args)\n    ) {\n        is ShellCommandConfirmation.Approved -&gt; try {\n            val result = executor.execute(\n                args.command, args.workingDirectory, args.timeoutSeconds\n            )\n            Result(args.command, result.exitCode, result.output)\n        } catch (e: CancellationException) {\n            throw e\n        } catch (e: Exception) {\n            Result(\n               args.command, null, \"Failed to execute command: ${e.message}\"\n            )\n        }\n\n        is ShellCommandConfirmation.Denied -&gt;\n            Result(\n                args.command, null, \n                \"Command execution denied with user response: ${confirmation.userResponse}\"\n            )\n    }<\/pre>\n<p>\u6d41\u7a0b\u5f88\u7b80\u5355\uff1a\u8bf7\u6c42\u7528\u6237\u786e\u8ba4\u662f\u5426\u8fd0\u884c\u547d\u4ee4\uff0c\u5982\u679c\u83b7\u5f97\u6279\u51c6\uff0c\u5219\u901a\u8fc7\u547d\u4ee4\u6267\u884c\u5668\u6267\u884c\u547d\u4ee4\uff0c\u5426\u5219\u5411 LLM \u8fd4\u56de\u62d2\u7edd\u6d88\u606f\u3002<\/p>\n<p>\u6211\u4eec\u4e5f\u53ef\u4ee5\u901a\u8fc7\u6b64\u65b9\u5f0f\u6355\u83b7\u5f02\u5e38\u5e76\u5c06\u9519\u8bef\u6d88\u606f\u8f6c\u53d1\u7ed9 LLM\uff0c\u4f7f\u5176\u80fd\u591f\u8c03\u6574\u7b56\u7565\u6216\u5c1d\u8bd5\u66ff\u4ee3\u65b9\u6cd5\u3002<\/p>\n<h3 class=\"wp-block-heading\"><code>ConfirmationHandler<\/code> \u914d\u7f6e<br \/><\/h3>\n<p>\u521b\u5efa <code>ExecuteShellCommandTool<\/code> \u65f6\uff0c<code>ConfirmationHandler<\/code> \u4f1a\u53d8\u4e3a\u53ef\u914d\u7f6e\u72b6\u6001\uff0c\u4ece\u800c\u652f\u6301\u591a\u79cd\u5b9e\u73b0\u3002\u76ee\u524d\uff0c\u6211\u4eec\u63d0\u4f9b<a href=\"https:\/\/github.com\/JetBrains\/koog\/blob\/develop\/agents\/agents-ext\/src\/commonMain\/kotlin\/ai\/koog\/agents\/ext\/tool\/shell\/ShellCommandConfirmationHandlers.kt\" target=\"_blank\" rel=\"noopener\">\u4e24\u79cd<\/a>\u5b9e\u73b0\uff1a<\/p>\n<ol>\n<li><code>PrintShellCommandConfirmationHandler<\/code>\uff1a\u901a\u8fc7\u547d\u4ee4\u884c\u63d0\u793a\u7528\u6237\u3002<\/li>\n<li><code>BraveModeConfirmationHandler<\/code>\uff1a\u81ea\u52a8\u6279\u51c6\u4e00\u5207\u8bf7\u6c42\u3002<\/li>\n<\/ol>\n<p>\u7b2c\u4e8c\u79cd\u5b9e\u73b0\u4f1a\u65e0\u6761\u4ef6\u6279\u51c6\u6240\u6709\u8bf7\u6c42\uff0c\u800c\u7b2c\u4e00\u79cd\u5b9e\u73b0\u5219\u6709\u4e00\u4e9b\u6709\u8da3\u7684\u7ec6\u8282\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"kotlin\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">override suspend fun requestConfirmation(\n        args: ExecuteShellCommandTool.Args\n    ): ShellCommandConfirmation {\n        println(\"Agent wants to execute: ${args.command}\")\n        args.workingDirectory?.let { println(\"In: $it\") }\n        println(\"Timeout: ${args.timeoutSeconds}s\")\n        print(\"Confirm (y \/ n \/ reason-for-denying): \")\n\n        val userResponse = readln().lowercase()\n        return when (userResponse) {\n            \"y\", \"yes\" -&gt; ShellCommandConfirmation.Approved\n            else -&gt; ShellCommandConfirmation.Denied(userResponse)\n        }\n    }<\/pre>\n<p>\u8bf7\u6ce8\u610f\uff0c\u867d\u7136\u7528\u6237\u770b\u5230\u4e09\u4e2a\u9009\u9879\uff08\u6279\u51c6\u3001\u62d2\u7edd\u3001\u62d2\u7edd\u5e76\u63d0\u4f9b\u539f\u56e0\uff09\uff0c\u4f46\u5b9e\u73b0\u65f6\u4f1a\u5bf9\u4e24\u79cd\u62d2\u7edd\u7c7b\u578b\u505a\u540c\u7b49\u5904\u7406\uff1a\u4e24\u8005\u90fd\u4f1a\u5411 LLM \u8fd4\u56de\u6d88\u606f\uff0c\u7531 LLM \u5206\u522b\u5bf9\u6bcf\u79cd\u7c7b\u578b\u8fdb\u884c\u89e3\u6790\u548c\u5904\u7406\u3002<\/p>\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" loading=\"lazy\" width=\"396\" height=\"366\" src=\"https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2025\/11\/demo-exec-print-confirmation.gif\" alt=\"\" class=\"wp-image-660074\" \/><\/figure>\n<h3 class=\"wp-block-heading\"><code>CommandExecutor<\/code> \u914d\u7f6e<\/h3>\n<p>\u4e0e <code>ConfirmationHandler<\/code> \u7c7b\u4f3c\uff0c<code>CommandExecutor<\/code> \u4e5f\u662f\u53ef\u914d\u7f6e\u7684\uff0c\u4f46\u6211\u4eec\u76ee\u524d\u53ea\u63d0\u4f9b JVM \u5b9e\u73b0\u3002\u7406\u8bba\u4e0a\u6765\u8bb2\uff0c\u4f60\u53ef\u4ee5\u4e3a Android\u3001iOS\u3001WebAssembly \u548c\u5176\u4ed6\u5e73\u53f0\u521b\u5efa\u5b9e\u73b0\uff0c\u4f46\u7531\u4e8e\u6ca1\u6709\u660e\u786e\u7684\u9700\u6c42\uff0c\u6211\u4eec\u5c06\u6682\u7f13\u6b64\u7c7b\u5de5\u4f5c\u3002<\/p>\n<h2 class=\"wp-block-heading\">\u5982\u4f55\u5904\u7406\u8d85\u65f6\uff1f<\/h2>\n<p>\u65e0\u8bba\u4f7f\u7528\u54ea\u4e00\u5e73\u53f0\uff0c<code>CommandExecutor<\/code> \u8d85\u65f6\u5904\u7406\u8fd9\u4e00\u65b9\u9762\u90fd\u9700\u8981\u7279\u522b\u5173\u6ce8\u3002\u6211\u4eec\u76ee\u524d\u7684\u5b9e\u73b0\u4e0d\u5141\u8bb8\u667a\u80fd\u4f53\u4e2d\u65ad\u957f\u65f6\u95f4\u8fd0\u884c\u7684\u547d\u4ee4\u3002<\/p>\n<p>\u4eba\u7c7b\u5e38\u57fa\u4e8e\u201c\u4e0d\u8010\u70e6\u542f\u53d1\u5f0f\u201d\u884c\u4e8b\uff0c\u8fd9\u53ef\u80fd\u4f1a\u5bfc\u81f4\u4ed6\u4eec\u4f7f\u7528 <em>Ctrl+C <\/em> \u53d6\u6d88\u6267\u884c\u3002\u4f46\u8fd9\u79cd\u884c\u4e3a\u5047\u5b9a\u5b58\u5728\u591a\u7ebf\u7a0b\u3001\u667a\u80fd\u4f53\u610f\u8bc6\u548c\u6f5c\u5728\u7684\u4e0d\u8010\u70e6\u6982\u5ff5\u3002\u4e0d\u8fc7\uff0c\u6709\u4e00\u79cd\u66f4\u76f4\u89c2\u4e14\u66f4\u8d34\u5408\u6b64\u4e0a\u4e0b\u6587\u7684\u66ff\u4ee3\u65b9\u6848\u3002<\/p>\n<p>\u901a\u8fc7\u8981\u6c42 LLM \u6307\u5b9a\u6700\u957f\u6267\u884c\u65f6\u95f4\uff0c\u6211\u4eec\u53ef\u4ee5<a href=\"https:\/\/github.com\/JetBrains\/koog\/blob\/develop\/agents\/agents-ext\/src\/jvmMain\/kotlin\/ai\/koog\/agents\/ext\/tool\/shell\/JvmShellCommandExecutor.kt\" target=\"_blank\" rel=\"noopener\">\u5b89\u5168\u5730\u4e2d\u65ad\u8d85\u8fc7\u6b64\u9650\u503c\u7684\u547d\u4ee4<\/a>\u3002\u6b64\u8d85\u65f6\u503c\u4f1a\u663e\u793a\u7ed9\u7528\u6237\uff0c\u5982\u679c\u8bf7\u6c42\u7684\u65f6\u957f\u770b\u4f3c\u4e0d\u5408\u7406\u6216\u8fc7\u957f\uff0c\u7528\u6237\u53ef\u4ee5\u62d2\u7edd\u6267\u884c\u3002<\/p>\n<p>\u6211\u4eec\u5e94\u5f53\u5c3d\u53ef\u80fd\u591a\u5730\u4fdd\u7559\u8f93\u51fa\uff0c\u800c\u4e0d\u662f\u7b80\u5355\u5730\u7ec8\u6b62\u8fdb\u7a0b\u5e76\u8fd4\u56de\u901a\u7528\u8d85\u65f6\u6d88\u606f\u3002\u5373\u4f7f\u662f\u4e0d\u5b8c\u6574\u7684\u7ed3\u679c\uff0c\u4e5f\u53ef\u4ee5\u5e2e\u52a9 LLM \u63d0\u53d6\u6709\u7528\u4fe1\u606f\uff0c\u6216\u8005\u81f3\u5c11\u53ef\u4ee5\u5e2e\u52a9 LLM \u7406\u89e3\u8d85\u65f6\u53d1\u751f\u7684\u4f4d\u7f6e\u3002\u901a\u8fc7\u8c28\u614e\u5b9e\u73b0\uff0c\u6211\u4eec\u53ef\u4ee5\u5b9e\u73b0\u8fd9\u4e00\u76ee\u6807\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"kotlin\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">val stdoutJob = launch {\n    process.inputStream.bufferedReader().useLines { lines -&gt;\n        try {\n            lines.forEach { stdoutBuilder.appendLine(it) }\n        } catch (_: IOException) {\n            \/\/ Ignore IO exception if the stream is closed and silently stop stream collection\n        }\n    }\n}\n\nval isCompleted = withTimeoutOrNull(timeoutSeconds * 1000L) {\n    process.onExit().await()\n} != null\n\nif (!isCompleted) {\n    process.destroyForcibly()\n}\n\nstdoutJob.join()<\/pre>\n<h2 class=\"wp-block-heading\"><strong>\u5728\u667a\u80fd\u4f53\u5c42\u9762\u6709\u54ea\u4e9b\u6539\u52a8\uff1f<\/strong><\/h2>\n<p>\u5728\u667a\u80fd\u4f53\u5c42\u9762\uff0c<a href=\"https:\/\/github.com\/JetBrains\/koog\/blob\/develop\/examples\/code-agent\/step-02-add-execution-tool\/src\/main\/kotlin\/Main.kt\" target=\"_blank\" rel=\"noopener\">\u6539\u52a8\u5fae\u4e4e\u5176\u5fae<\/a>\uff0c\u5927\u6982\u53ea\u6709\u5341\u51e0\u884c\u4ee3\u7801\u3002\u5982\u4ee3\u7801\u5dee\u5f02\u6240\u793a\uff0c\u8fd9\u4e9b\u66f4\u65b0\u4e3b\u8981\u6d89\u53ca\u5230\u7cfb\u7edf\u63d0\u793a\u7684\u6269\u5c55\u3002<\/p>\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" loading=\"lazy\" width=\"1913\" height=\"1001\" src=\"https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2025\/11\/Screenshot-2025-11-18-at-14.47.35.png\" alt=\"\" class=\"wp-image-660085\" \/><\/figure>\n<p>\u6211\u4eec\u672c\u53ef\u4ee5\u901a\u8fc7\u6dfb\u52a0\u5de5\u5177\u6765\u8fdb\u4e00\u6b65\u51cf\u5c11\u6539\u52a8\uff0c\u4f46\u6211\u4eec\u53cd\u800c\u5f15\u5165\u4e86\u4e24\u5904\u5bf9\u667a\u80fd\u4f53\u7684\u989d\u5916\u4fee\u6539\uff08\u8fd9\u4e24\u5904\u6539\u52a8\u4e5f\u975e\u5e38\u5c0f\uff09\u3002<\/p>\n<h3 class=\"wp-block-heading\"><strong>A) <code>BRAVE_MODE<\/code> \u5207\u6362\u5f00\u5173<\/strong><\/h3>\n<p>\u6b64\u5207\u6362\u5f00\u5173\u7684\u5b9e\u73b0\u76f8\u5bf9\u6765\u8bf4\u6bd4\u8f83\u7b80\u5355\uff1b\u4ec5\u4f1a\u68c0\u67e5 BRAVE_MODE \u73af\u5883\u53d8\u91cf\u3002\u6211\u4eec\u751a\u81f3\u4e3a <em>Brave<\/em> \u6a21\u5f0f ConfirmationHandler \u4f7f\u7528\u4e86 lambda \u51fd\u6570\uff0c\u4ee5\u8868\u660e\u81ea\u884c\u5b9e\u73b0\u53ef\u4ee5\u975e\u5e38\u7b80\u5355\uff0c\u4f46\u4e5f\u53ef\u4ee5\u4f7f\u7528\u524d\u9762\u63d0\u5230\u7684 <code>BraveModeConfirmationHandler<\/code>\u3002\u00a0<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"kotlin\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">fun createExecuteShellCommandToolFromEnv(): ExecuteShellCommandTool {\n    return if (System.getenv(\"BRAVE_MODE\")?.lowercase() == \"true\") {\n        ExecuteShellCommandTool(JvmShellCommandExecutor()) {\n            _ -&gt; ShellCommandConfirmation.Approved \n        }\n    } else {\n        ExecuteShellCommandTool(\n            JvmShellCommandExecutor(), \n            PrintShellCommandConfirmationHandler(),\n        )\n    }\n}<\/pre>\n<h3 class=\"wp-block-heading\"><strong>B) \u589e\u5f3a\u4e86\u63d0\u793a\u4e2d\u7684\u201c\u5b8c\u6210\u5b9a\u4e49\u201d<\/strong><\/h3>\n<p>\u4e3a\u4e86\u786e\u4fdd LLM \u6709\u6548\u5229\u7528\u8fd9\u79cd\u65b0\u80fd\u529b\u6267\u884c\u4ee3\u7801\uff0c\u6211\u4eec\u4f7f\u7528\u201c\u5b8c\u6210\u5b9a\u4e49\u201d\u6269\u5c55\u4e86\u63d0\u793a\uff0c\u6b64\u5b9a\u4e49\u4f1a\u5f3a\u70c8\u5efa\u8bae\u7f16\u5199\u548c\u8fd0\u884c\u6d4b\u8bd5\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"kotlin\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"\"\"\n... \/\/ Previous prompt from step 01\n\nProduction-ready means verified to work\u2014your changes must be proven correct and not introduce regressions.\n\nYou have shell access to execute commands and run tests. Use this to work with executable feedback instead of assumptions. Establish what correct behavior looks like through tests, then iterate your implementation until tests pass. Validate that existing functionality remains intact. Production-ready means proven through green tests\u2014that's your definition of done.\n\"\"\"<\/pre>\n<p>\u5927\u529f\u544a\u6210\u3002\u6211\u4eec\u5df2\u6784\u5efa\u5b8c\u6574\u7684 <code>ExecuteShellCommandTool<\/code> \u7ec4\u4ef6\uff0c\u5e76\u901a\u8fc7\u6700\u5c11\u91cf\u7684\u6539\u52a8\u5c06\u5176\u96c6\u6210\u5230\u6211\u4eec\u7684\u667a\u80fd\u4f53\u4e2d\u3002\u4f46\u5b9e\u9645\u95ee\u9898\u662f\uff1a\u5b83\u771f\u7684\u4f1a\u63d0\u9ad8\u6027\u80fd\u5417\uff1f<\/p>\n<h2 class=\"wp-block-heading\">\u57fa\u51c6\u6d4b\u8bd5\u7ed3\u679c<\/h2>\n<p>\u5bf9\u7167 SWE-bench Verified \u96c6\u5408\u8fd0\u884c\u4e24\u4e2a\u7248\u672c\u7684\u6d4b\u8bd5\u786e\u8ba4\u4e86\u6267\u884c\u80fd\u529b\u5177\u6709\u660e\u663e\u4f18\u52bf\uff1a\u667a\u80fd\u4f53\u8868\u73b0\u4ece 249\/500 (50%) \u63d0\u9ad8\u5230 279\/500 (56%) \u7684\u6210\u529f\u6837\u672c\u3002\u867d\u7136\u6392\u884c\u699c\u5206\u6570\u8fbe\u5230 70% \u5de6\u53f3\uff0c\u4f46\u6211\u4eec\u7684\u7ed3\u679c\u8868\u660e\uff0c\u8d4b\u4e88\u667a\u80fd\u4f53\u8fd0\u884c\u548c\u9a8c\u8bc1\u4ee3\u7801\u7684\u80fd\u529b\u662f\u6b63\u786e\u7684\u53d1\u5c55\u65b9\u5411\u3002\u4e0d\u8fc7\uff0c\u4e3a\u4e86\u7406\u89e3\u667a\u80fd\u4f53\u4ecd\u5b58\u5728\u7684\u95ee\u9898\u4ee5\u53ca\u540e\u7eed\u6539\u8fdb\u63aa\u65bd\uff0c\u6211\u4eec\u9700\u8981\u66f4\u6df1\u5165\u5730\u89c2\u5bdf\u5176\u884c\u4e3a\u3002\u8fd9\u5c31\u662f\u65e5\u5fd7\u8bb0\u5f55\u53d8\u5f97\u81f3\u5173\u91cd\u8981\u7684\u5730\u65b9\u3002<\/p>\n<h2 class=\"wp-block-heading\">\u7ed3\u8bba\uff1a\u5728 Koog \u4e2d\u6784\u5efa\u5de5\u5177<\/h2>\n<p>\u901a\u8fc7\u8fd9\u7bc7\u6587\u7ae0\uff0c\u6211\u4eec\u4e86\u89e3\u4e86 Koog \u5de5\u5177\u7ed3\u6784\u7684\u8fd0\u4f5c\u65b9\u5f0f\uff1a\u6bcf\u4e2a\u5de5\u5177\u90fd\u9700\u8981\u540d\u79f0\u3001\u63cf\u8ff0\u548c <code>execute()<\/code> \u65b9\u6cd5\u3002\u6211\u4eec\u901a\u8fc7 <code>ConfirmationHandler<\/code> \u548c <code>CommandExecutor<\/code> \u7ec4\u4ef6\u4f7f <code>ExecuteShellCommandTool<\/code> \u53d8\u4e3a\u53ef\u914d\u7f6e\u72b6\u6001\uff0c\u5c55\u793a\u4e86\u5982\u4f55\u5c06\u590d\u6742\u903b\u8f91\u59d4\u6258\u7ed9\u53ef\u66ff\u6362\u5b9e\u73b0\u3002<\/p>\n<p>\u8fd9\u4e9b\u76f8\u540c\u7684\u6a21\u5f0f\u9002\u7528\u4e8e\u4f60\u53ef\u80fd\u5e0c\u671b\u6784\u5efa\u7684\u4efb\u4f55\u5de5\u5177\uff1a\u6570\u636e\u5e93\u8fde\u63a5\u5668\u3001API \u5ba2\u6237\u7aef\u3001\u6587\u4ef6\u5904\u7406\u5668\u6216\u81ea\u5b9a\u4e49\u96c6\u6210\u3002\u6846\u67b6\u4e3a LLM \u901a\u4fe1\u63d0\u4f9b\u7ed3\u6784\uff1b\u4f60\u63d0\u4f9b\u5177\u4f53\u80fd\u529b\u3002\u00a0<\/p>\n<p>\u5728\u4e0b\u4e00\u7bc7\u6587\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u63a2\u8ba8\u5982\u4f55\u4e3a\u6211\u4eec\u7684\u667a\u80fd\u4f53\u6dfb\u52a0\u65e5\u5fd7\u8bb0\u5f55\u548c\u8ddf\u8e2a\u529f\u80fd\uff0c\u8ba9\u6211\u4eec\u80fd\u591f\u83b7\u53d6\u7406\u89e3\u5e76\u6539\u8fdb\u5176\u884c\u4e3a\u6240\u9700\u7684\u4fe1\u606f\u3002\u4e86\u89e3\u4f60\u7684\u667a\u80fd\u4f53\u5982\u4f55\u505a\u51fa\u51b3\u7b56\u5bf9\u4e8e\u8fed\u4ee3\u81f3\u5173\u91cd\u8981\uff0c\u800c\u56f4\u7ed5\u53ef\u89c2\u6d4b\u6027\u6784\u5efa\u9002\u5f53\u5de5\u5177\u4e0e\u4e3a\u667a\u80fd\u4f53\u672c\u8eab\u63d0\u4f9b\u5de5\u5177\u540c\u6837\u91cd\u8981\u3002<\/p>\n\n\n<p><\/p>\n\n\n\n<p>\u672c\u535a\u6587\u82f1\u6587\u539f\u4f5c\u8005\uff1a<\/p>\n\n\n    <div class=\"about-author \">\n        <div class=\"about-author__box\">\n            <div class=\"row\">\n                <div class=\"about-author__box-img\">\n                    <img decoding=\"async\" src=\"https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2025\/11\/picture_cropped-1.jpg\" width=\"200\" height=\"200\" alt=\"Bruno Lannoo\" loading=\"lazy\"  class=\"avatar avatar-200 wp-user-avatar wp-user-avatar-200 photo avatar-default\">\n                <\/div>\n                <div class=\"about-author__box-text\">\n                                            <h4>Bruno Lannoo<\/h4>\n                                                        <\/div>\n            <\/div>\n        <\/div>\n    <\/div>\n","protected":false},"author":1297,"featured_media":680267,"comment_status":"closed","ping_status":"closed","template":"","categories":[4113,2347],"tags":[6847,8724],"cross-post-tag":[6355],"acf":[],"_links":{"self":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/ai\/678819"}],"collection":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/ai"}],"about":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/types\/ai"}],"author":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/users\/1297"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/comments?post=678819"}],"version-history":[{"count":4,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/ai\/678819\/revisions"}],"predecessor-version":[{"id":680300,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/ai\/678819\/revisions\/680300"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/media\/680267"}],"wp:attachment":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/media?parent=678819"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/categories?post=678819"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/tags?post=678819"},{"taxonomy":"cross-post-tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/cross-post-tag?post=678819"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}