AutoTweaker API/io.github.autotweaker.api.types.agent/AgentMessage/Tool/Call

Call

@Serializable

data class Call(val id: UUID, val timestamp: Instant, val callId: String, val callName: String, val arguments: String, val reason: String?, val validatedToolName: String?, val validatedArgs: JsonElement?, val resolvedRequest: JsonElement?, val presentation: ToolPresentation?) : AgentMessage.Tool(source)

工具调用请求，来自 LLM。

Constructors

constructor(id: UUID, timestamp: Instant, callId: String, callName: String, arguments: String, reason: String?, validatedToolName: String?, validatedArgs: JsonElement?, resolvedRequest: JsonElement?, presentation: ToolPresentation?)

Properties

val arguments: String

工具调用的请求参数，为来自 api 响应的原始参数，可能不是一个有效的 Json 对象。

open override val callId: String

工具调用的 id，来自大模型 api，用于帮助模型匹配 Call 和 Result。

val callName: String

工具调用的请求名称，可能同时包含工具名称和 function 名称。

@Serializable(with = UuidSerializer::class)

open override val id: UUID

消息 id，每种消息都有。

val presentation: ToolPresentation?

用于展示给用户并请求审批的消息，当工具无需被审批或解析失败时此字段为 null。

val reason: String?

工具调用的原因，只有解析成功的工具调用会包含此字段。

resolvedRequest

val resolvedRequest: JsonElement?

工具调用预处理的响应序列化到 JsonElement，此字段非空时工具参数必然已校验成功。

open override val timestamp: Instant

消息时间戳，每种消息都有。

val validatedArgs: JsonElement?

成功反序列化为工具的 io.github.autotweaker.api.tool.ToolArgs 后序列化到 JsonElement。

validatedToolName

val validatedToolName: String?

业务层的工具名称，而非 callName 那样包含 function 名。