包package io.agentscope.core.tool

io.agentscope.core.tool

package io.agentscope.core.tool

io.agentscope.core.tool 属于工具与技能，工具注册、schema 与执行。该包共收录 35 个公开类型。

io.agentscope.core.tool belongs to the Tools & skills layer and contains 35 public types.

所属构件Artifacts agentscope-core

接口Interfaces

类型Type	种类Kind	说明Description
`AgentTool`	接口interface	定义智能体工具契约的接口。 Interface for agent tools that can be called by models.
`ContextStore`	接口interface	定义上下文存储契约的接口。 Storage layer abstraction for tool execution context.
`ExtendedModel`	接口interface	定义 Extended 模型契约的接口。 Interface for extended model that adds properties to tool parameters.
`ToolEmitter`	接口interface	定义工具 Emitter契约的接口。 Interface for emitting streaming responses during tool execution.
`ToolExecutionContextProvider`	接口interface	定义工具执行上下文提供者契约的接口。 @deprecated Part of the {@link ToolExecutionContext} layer which is superseded by {@link io.agentscope.core.agent.RuntimeContext}.
`ToolResultConverter`	接口interface	定义工具结果转换器契约的接口。 Converts tool method return values to ToolResultBlock.

类Classes

类型Type	种类Kind	说明Description
`DefaultToolResultConverter`	类class	默认工具结果转换器，让智能体以受控方式调用外部能力。 Default implementation of ToolResultConverter.
`NoOpToolEmitter`	类class	无 Op 工具 Emitter，让智能体以受控方式调用外部能力。 A no-op implementation of ToolEmitter that silently discards all emitted chunks.
`SchemaOnlyTool`	类class	模式 Only 工具，封装可被智能体调用的能力。 An external tool implementation that only contains schema definition without execution logic.
`SimpleExtendedModel`	类class	简单 Extended 模型，让智能体以受控方式调用外部能力。 Simple implementation of ExtendedModel using maps.
`SkillToolGroup`	类class	技能工具组，让智能体以受控方式调用外部能力。 A `ToolGroup` that is bound to a specific skill.
`ToolBase`	类class	工具基类，让智能体以受控方式调用外部能力。 Abstract base class for tools that participate in permission evaluation and ReAct execution.
`ToolCallParam`	类class	工具调用参数，让智能体以受控方式调用外部能力。 Parameters for tool invocation.
`ToolDangerousPathConstants`	类class	工具 Dangerous 路径 Constants，让智能体以受控方式调用外部能力。 Defaults for the dangerous-path and dangerous-command lists consulted by tool self-checks.
`ToolExecutionContext`	类class	工具执行上下文，让智能体以受控方式调用外部能力。 Facade for passing custom POJOs to tool methods via priority-based resolution.
`ToolGroup`	类class	工具组，让智能体以受控方式调用外部能力。 Represents a named group of tools with activation state.
`Toolkit`	类class	工具注册表 Toolkit manages the registration, retrieval, and execution of agent tools.
`ToolkitConfig`	类class	用于工具包执行行为的配置。 Configuration for Toolkit execution behavior.
`ToolResultMessageBuilder`	类class	工具结果消息构建器，用于构建并配置目标实例。 Utility class for building tool result messages from ToolResultBlock objects.
`ToolSchemaModule`	类class	工具模式 Module，让智能体以受控方式调用外部能力。 A victools JSON Schema `Module` that reads `ToolParam` annotations to populate `"description"` and `"required"` in the generated schema.
`ToolSuspendException`	类class	工具 Suspend 异常，表示执行过程中的错误。 Exception thrown to signal that a tool execution should be suspended and handled externally.
`ToolValidator`	类class	工具校验器，让智能体以受控方式调用外部能力。 Unified validator for tool-related operations.

枚举Enums

类型Type	种类Kind	说明Description
`ToolGroupScope`	枚举enum	定义工具组范围相关取值的枚举。 Defines who manages a `ToolGroup`'s activation lifecycle.
`ToolMergeMode`	枚举enum	定义工具 Merge 模式相关取值的枚举。 Enum defining how externally injected tools (e.g.

记录Records

类型Type	种类Kind	说明Description
`ToolRequestConfig`	记录record	承载工具请求配置数据的记录类型。 Immutable per-call tool request config.

注解接口Annotation Interfaces

类型Type	种类Kind	说明Description
`Tool`	注解annotation	用于标记工具相关元数据的注解。 Annotation to mark a method as a tool that can be invoked by AI agents.
`ToolParam`	注解annotation	用于标记工具参数相关元数据的注解。 Annotation to describe parameters of a tool method.