From 3c70c00a3bbc8aa26ef13a2ef19e5f58fd72b436 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=90=B4=E5=98=89=E8=B1=AA?= Date: Mon, 21 Sep 2026 21:26:02 +0800 Subject: [PATCH 1/3] fix(doc): method getSuggestedRules no issue in ToolBase --- docs/v2/en/docs/building-blocks/permission-system.md | 2 +- docs/v2/zh/docs/building-blocks/permission-system.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/v2/en/docs/building-blocks/permission-system.md b/docs/v2/en/docs/building-blocks/permission-system.md index e4fb1d0db6..b3dadac7a7 100644 --- a/docs/v2/en/docs/building-blocks/permission-system.md +++ b/docs/v2/en/docs/building-blocks/permission-system.md @@ -209,7 +209,7 @@ ConfirmResult result = new ConfirmResult( /* confirmed = */ true, /* toolCall = */ toolCall, - /* rules = */ toolCall.getSuggestedRules()); + /* rules = */ toolCall.generateSuggestions(toolInput)); ``` Runnable examples: `agentscope-examples/documentation/.../tool/PermissionContextExample.java`, `hitl/PermissionHITLExample.java`. diff --git a/docs/v2/zh/docs/building-blocks/permission-system.md b/docs/v2/zh/docs/building-blocks/permission-system.md index c820d11c5f..03c9aa411b 100644 --- a/docs/v2/zh/docs/building-blocks/permission-system.md +++ b/docs/v2/zh/docs/building-blocks/permission-system.md @@ -209,7 +209,7 @@ ConfirmResult result = new ConfirmResult( /* confirmed = */ true, /* toolCall = */ toolCall, - /* rules = */ toolCall.getSuggestedRules()); + /* rules = */ toolCall.generateSuggestions(toolInput)); ``` 完整可运行示例：`agentscope-examples/documentation/.../tool/PermissionContextExample.java`、`hitl/PermissionHITLExample.java`。 From bdca33f778cde282be4e5e3903924778e5f44ab8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=90=B4=E5=98=89=E8=B1=AA?= Date: Mon, 21 Sep 2026 21:33:55 +0800 Subject: [PATCH 2/3] fix(doc): method getSuggestedRules no issue in ToolBase --- docs/v2/en/docs/building-blocks/permission-system.md | 2 +- docs/v2/zh/docs/building-blocks/permission-system.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/v2/en/docs/building-blocks/permission-system.md b/docs/v2/en/docs/building-blocks/permission-system.md index b3dadac7a7..751d06075b 100644 --- a/docs/v2/en/docs/building-blocks/permission-system.md +++ b/docs/v2/en/docs/building-blocks/permission-system.md @@ -209,7 +209,7 @@ ConfirmResult result = new ConfirmResult( /* confirmed = */ true, /* toolCall = */ toolCall, - /* rules = */ toolCall.generateSuggestions(toolInput)); + /* rules = */ tool.generateSuggestions(toolCall.getInput())); ``` Runnable examples: `agentscope-examples/documentation/.../tool/PermissionContextExample.java`, `hitl/PermissionHITLExample.java`. diff --git a/docs/v2/zh/docs/building-blocks/permission-system.md b/docs/v2/zh/docs/building-blocks/permission-system.md index 03c9aa411b..b55e793d6f 100644 --- a/docs/v2/zh/docs/building-blocks/permission-system.md +++ b/docs/v2/zh/docs/building-blocks/permission-system.md @@ -209,7 +209,7 @@ ConfirmResult result = new ConfirmResult( /* confirmed = */ true, /* toolCall = */ toolCall, - /* rules = */ toolCall.generateSuggestions(toolInput)); + /* rules = */ tool.generateSuggestions(toolCall.getInput())); ``` 完整可运行示例：`agentscope-examples/documentation/.../tool/PermissionContextExample.java`、`hitl/PermissionHITLExample.java`。 From b43cdab9731271ca13bf93729dd7abdae464a1e7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=90=B4=E5=98=89=E8=B1=AA?= Date: Mon, 21 Sep 2026 22:31:04 +0800 Subject: [PATCH 3/3] fix(doc): method getSuggestedRules no issue in ToolBase --- docs/v2/en/docs/building-blocks/permission-system.md | 3 ++- docs/v2/zh/docs/building-blocks/permission-system.md | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/v2/en/docs/building-blocks/permission-system.md b/docs/v2/en/docs/building-blocks/permission-system.md index 751d06075b..711b07a61d 100644 --- a/docs/v2/en/docs/building-blocks/permission-system.md +++ b/docs/v2/en/docs/building-blocks/permission-system.md @@ -204,7 +204,8 @@ PermissionContextState permCtx = import io.agentscope.core.event.ConfirmResult; // ASK decisions carry suggestedRules on the ToolUseBlock. -// Accept them by attaching to the result: +// Accept them by attaching to the result. +// `tool` is the ToolBase instance that received the ASK (the tool named in the pending call): ConfirmResult result = new ConfirmResult( /* confirmed = */ true, diff --git a/docs/v2/zh/docs/building-blocks/permission-system.md b/docs/v2/zh/docs/building-blocks/permission-system.md index b55e793d6f..2b3ee9d066 100644 --- a/docs/v2/zh/docs/building-blocks/permission-system.md +++ b/docs/v2/zh/docs/building-blocks/permission-system.md @@ -204,7 +204,8 @@ PermissionContextState permCtx = import io.agentscope.core.event.ConfirmResult; // ASK 决策中包含基于本次调用生成的 suggestedRules（位于 ToolUseBlock 上）。 -// 接受建议时，把它放入结果即可： +// 接受建议时，把它放入结果即可。 +// `tool` 是接收到 ASK 的 ToolBase 实例（即待确认调用中命名的 tool）： ConfirmResult result = new ConfirmResult( /* confirmed = */ true,