Enum UnhandledToolCallBehaviour
Defines the policy to apply when a tool call is received but the agent has no handler for it.
public enum UnhandledToolCallBehaviour
Fields
LogAndIgnore = 0Logs that the tool call was unhandled. If the unhandled call prevents the conversation from progressing, the agent may attempt a fallback process to continue the dialogue flow.
ReturnRefusal = 2Instead of raising an exception, the client directly creates and returns a
ResponseMessagethat contains error information, in place of the real model response.SubmitToolOutput = 1The agent transitions to a
WaitingForToolOutputstate, and the user must manually callAgent.SubmitToolOutput()to provide the tool output before the run can continue.Throw = 3Immediately throws an exception. Use this in strict or debugging scenarios where every tool call must be handled explicitly.