Classify Finish Reason • AI Agent SDK

classify_finish_reason: Map a provider “finish_reason“/refusal signal to a terminal reason.

classify_finish_reason

Function

</div>

This function is defined in the run_outcome module.

Map a provider `finish_reason`/refusal signal to a terminal reason.

Returns one of `content_filtered | refused | length_truncated when the provider blocked/refused/truncated the turn, or None for a normal stop (None/"stop"`) or any unrecognised value — so unknown finish reasons behave exactly as today. Additive and zero-cost on the success path.

Signature

python
def classify_finish_reason(finish_reason: Any, refusal: Any) -> Any

Parameters

ParamField Any

No description available.

ParamField Any

No description available.

Returns

ResponseField Any

The result of the operation.

Source

View on GitHub

praisonaiagents/agent/run_outcome.py at line 116