程序包 io.agentscope.core.hook

类 PreActingEvent

java.lang.Object

io.agentscope.core.hook.HookEvent

io.agentscope.core.hook.ActingEvent

io.agentscope.core.hook.PreActingEvent

public final class PreActingEvent
extends ActingEvent

Event fired before tool execution.

Modifiable: Yes - setToolUse(ToolUseBlock)

Context:

• HookEvent.getAgent() - The agent instance
• HookEvent.getMemory() - Agent's memory
• ActingEvent.getToolkit() - The toolkit instance
• ActingEvent.getToolUse() - The tool call to execute (modifiable)

Note: This is called once per tool. If the reasoning result contains multiple tool calls, this event fires multiple times.

Use Cases:

• Validate or modify tool parameters for each tool call
• Add authentication or context to individual tool calls
• Implement per-tool authorization checks
• Log or monitor individual tool invocations

字段概要

从类继承的字段 io.agentscope.core.hook.ActingEvent

toolUse

构造器概要

构造器

构造器	说明
PreActingEvent(Agent agent, Toolkit toolkit, ToolUseBlock toolUse)	Constructor for PreActingEvent.

方法概要

修饰符和类型	方法	说明
void	setToolUse(ToolUseBlock toolUse)	Modify the tool call (e.g., change parameters).

从类继承的方法 io.agentscope.core.hook.ActingEvent

getToolkit, getToolUse

从类继承的方法 io.agentscope.core.hook.HookEvent

getAgent, getMemory, getTimestamp, getType

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

PreActingEvent

public PreActingEvent(Agent agent,
 Toolkit toolkit,
 ToolUseBlock toolUse)

Constructor for PreActingEvent.

参数:

agent - The agent instance (must not be null)

toolkit - The toolkit instance (must not be null)

toolUse - The tool call to execute (must not be null)

抛出:

NullPointerException - if agent, toolkit, or toolUse is null

方法详细资料

setToolUse

public void setToolUse(ToolUseBlock toolUse)

Modify the tool call (e.g., change parameters).

参数:

toolUse - The new tool use block (must not be null)

抛出:

NullPointerException - if toolUse is null