Question

You build a Foundry agent that calls a custom function tool named getShippingQuote. During a run, the external shipping API the function wraps is temporarily unavailable and the function raises an exception. Your current implementation lets the exception propagate, which terminates the entire run and returns a generic failure to the user. You want the agent to gracefully recover — informing the user and, when possible, continuing the conversation with an alternative — without crashing the run. What is the recommended way to handle this in your tool implementation?

Accepted Answer

Catch the exception inside the function, return a structured tool output containing an error field and a human-readable message, and submit it as the tool output so the model can reason about the failure.

Answer

Increase the agent's max_completion_tokens so the model has room to retry the failed tool call automatically.

Answer

Remove the getShippingQuote tool from the agent definition so runs never attempt to call an unreliable dependency.

Answer

Set the run's temperature to 0 so the model produces deterministic output when the tool fails.