程序包 io.agentscope.core.model

接口 ToolChoice

所有已知实现类:

ToolChoice.Auto, ToolChoice.None, ToolChoice.Required, ToolChoice.Specific

public sealed interface ToolChoice
permits ToolChoice.Auto, ToolChoice.None, ToolChoice.Required, ToolChoice.Specific

Represents the tool choice behavior for LLM model calls.

This sealed interface defines how the model should handle tool calling:

• ToolChoice.Auto - Let the model decide whether and which tools to call (default)
• ToolChoice.None - Prevent the model from calling any tools
• ToolChoice.Required - Force the model to call at least one tool (model chooses which)
• ToolChoice.Specific - Force the model to call a specific tool by name

Usage Example:

 // Force model to call a specific tool
 GenerateOptions options = GenerateOptions.builder()
     .toolChoice(new ToolChoice.Specific("generate_response"))
     .build();

 // Let model decide (default)
 GenerateOptions options = GenerateOptions.builder()
     .toolChoice(new ToolChoice.Auto())
     .build();
 

另请参阅:

• GenerateOptions

嵌套类概要

嵌套类

修饰符和类型	接口	说明
static final record	ToolChoice.Auto	Auto mode: Let the model decide whether and which tools to call.
static final record	ToolChoice.None	None mode: Prevent the model from calling any tools.
static final record	ToolChoice.Required	Required mode: Force the model to call at least one tool.
static final record	ToolChoice.Specific	Specific mode: Force the model to call a specific tool by name.