agents-core/ai.koog.agents.core.feature.model/ToolCallFailureEvent

ToolCallFailureEvent

@Serializable
data class ToolCallFailureEvent(val runId: String, val toolCallId: String?, val toolName: String, val toolArgs: ToolArgs, val error: AIAgentError, val eventId: String = ToolCallFailureEvent::class.simpleName!!) : DefinedFeatureEvent(source)

Captures an event where a tool call has failed during its execution.

This event is typically used to log or handle situations where a tool could not execute successfully due to an error. It includes relevant details about the failed tool call, such as the tool's name, the arguments provided, and the specific error encountered.

Constructors

Link copied to clipboard
constructor(runId: String, toolCallId: String?, toolName: String, toolArgs: ToolArgs, error: AIAgentError, eventId: String = ToolCallFailureEvent::class.simpleName!!)

Properties

Link copied to clipboard
val error: AIAgentError

The error encountered during the tool's execution.

Link copied to clipboard
open override val eventId: String

A unique identifier for the event, defaulting to the class name.

Link copied to clipboard
open override val messageType: FeatureMessage.Type

Specifies the type of the feature message for this event.

Link copied to clipboard
val runId: String
Link copied to clipboard
open override val timestamp: Long

The timestamp, represented as the number of milliseconds since the Unix epoch, indicating when the feature event was created.

Link copied to clipboard
val toolArgs: ToolArgs

The arguments passed to the tool during the failed execution.

Link copied to clipboard
Link copied to clipboard
val toolName: String

The name of the tool that failed.