Skip to main content

AgentError

Stable safe error envelope carried inside tool/run events. Branch on code, never message.

type AgentError {
code: String!
message: String!
retryable: Boolean!
remediation: String
field: String
requiredScope: String
}

Fields​

AgentError.code ● String! non-null scalar​

Stable additive error code.

AgentError.message ● String! non-null scalar​

Safe bounded human-readable detail.

AgentError.retryable ● Boolean! non-null scalar​

Whether policy permits a deliberate retry.

AgentError.remediation ● String scalar​

Optional safe human remediation, never a command to execute.

AgentError.field ● String scalar​

Optional invalid input field path.

AgentError.requiredScope ● String scalar​

Optional missing agent scope.

Member Of​

AgentRunEvent object ● AgentToolEvent object ● AgentToolResultEnvelope object