agents-core/ai.koog.agents.core.feature.handler.tool/ToolCallFailedContext

ToolCallFailedContext

data class ToolCallFailedContext(val eventId: String, val executionInfo: AgentExecutionInfo, val context: AIAgentContext, val runId: String, val toolCallId: String?, val toolName: String, val toolDescription: String?, val toolArgs: JSONObject, val message: String, val error: Throwable?) : ToolCallEventContext(source)

Represents the context provided to handle a failure during the execution of a tool.

Constructors

ToolCallFailedContext

constructor(eventId: String, executionInfo: AgentExecutionInfo, context: AIAgentContext, runId: String, toolCallId: String?, toolName: String, toolDescription: String?, toolArgs: JSONObject, message: String, error: Throwable?)

Properties

open override val context: AIAgentContext

context The agent context associated with the tool call.

val error: Throwable?

The exception describing the tool call failure, or null if no exception is available.

open override val eventId: String

The unique identifier for the event.

open override val eventType: AgentLifecycleEventType

Represents the specific type of event handled within the event handler context, categorizing the nature of agent-related or strategy-related events.

open override val executionInfo: AgentExecutionInfo

The execution information containing parentId and current execution path;

val message: String

A message describing the failure that occurred.

open override val runId: String

runId The unique identifier for this tool call session.

open override val toolArgs: JSONObject

toolArgs The arguments provided for the tool execution, adhering to the tool's expected input structure.

open override val toolCallId: String?

toolCallId The unique identifier for this tool call.

toolDescription

open override val toolDescription: String?

toolDescription A description of the tool being executed.

open override val toolName: String

toolName The tool name that is being executed.