Logger

log_model_action_error

log_model_action_error(
    target_logger: Logger,
    message: str,
    exc: BaseException,
    *,
    stacklevel: int = 3,
    diagnostic_extra: _DiagnosticExtra | None = None,
) -> None

Log a model-data failure according to the model logging policy.

Source code in src/agents/logger.py

def log_model_action_error(
    target_logger: logging.Logger,
    message: str,
    exc: BaseException,
    *,
    stacklevel: int = 3,
    diagnostic_extra: _DiagnosticExtra | None = None,
) -> None:
    """Log a model-data failure according to the model logging policy."""
    _log_action_error(
        target_logger,
        message,
        exc,
        redact=_debug.DONT_LOG_MODEL_DATA,
        stacklevel=stacklevel,
        diagnostic_extra=diagnostic_extra,
    )

log_model_action_debug

log_model_action_debug(
    target_logger: Logger,
    message: str,
    exc: BaseException,
    *,
    stacklevel: int = 3,
    diagnostic_extra: _DiagnosticExtra | None = None,
) -> None

Debug-log a model-data failure according to the model logging policy.

Source code in src/agents/logger.py

def log_model_action_debug(
    target_logger: logging.Logger,
    message: str,
    exc: BaseException,
    *,
    stacklevel: int = 3,
    diagnostic_extra: _DiagnosticExtra | None = None,
) -> None:
    """Debug-log a model-data failure according to the model logging policy."""
    _log_action_at_level(
        target_logger.debug,
        message,
        exc,
        redact=_debug.DONT_LOG_MODEL_DATA,
        stacklevel=stacklevel,
        diagnostic_extra=diagnostic_extra,
    )

log_model_action_warning

log_model_action_warning(
    target_logger: Logger,
    message: str,
    exc: BaseException,
    *,
    stacklevel: int = 3,
    diagnostic_extra: _DiagnosticExtra | None = None,
) -> None

Warning-log a model-data failure according to the model logging policy.

Source code in src/agents/logger.py

def log_model_action_warning(
    target_logger: logging.Logger,
    message: str,
    exc: BaseException,
    *,
    stacklevel: int = 3,
    diagnostic_extra: _DiagnosticExtra | None = None,
) -> None:
    """Warning-log a model-data failure according to the model logging policy."""
    _log_action_at_level(
        target_logger.warning,
        message,
        exc,
        redact=_debug.DONT_LOG_MODEL_DATA,
        stacklevel=stacklevel,
        diagnostic_extra=diagnostic_extra,
    )

log_tool_action_error

log_tool_action_error(
    target_logger: Logger,
    message: str,
    exc: BaseException,
    *,
    stacklevel: int = 3,
    diagnostic_extra: _DiagnosticExtra | None = None,
) -> None

Log a tool-data failure according to the tool logging policy.

Source code in src/agents/logger.py

def log_tool_action_error(
    target_logger: logging.Logger,
    message: str,
    exc: BaseException,
    *,
    stacklevel: int = 3,
    diagnostic_extra: _DiagnosticExtra | None = None,
) -> None:
    """Log a tool-data failure according to the tool logging policy."""
    _log_action_error(
        target_logger,
        message,
        exc,
        redact=_debug.DONT_LOG_TOOL_DATA,
        stacklevel=stacklevel,
        diagnostic_extra=diagnostic_extra,
    )

log_tool_action_debug

log_tool_action_debug(
    target_logger: Logger,
    message: str,
    exc: BaseException,
    *,
    stacklevel: int = 3,
    diagnostic_extra: _DiagnosticExtra | None = None,
) -> None

Debug-log a tool-data failure according to the tool logging policy.

Source code in src/agents/logger.py

def log_tool_action_debug(
    target_logger: logging.Logger,
    message: str,
    exc: BaseException,
    *,
    stacklevel: int = 3,
    diagnostic_extra: _DiagnosticExtra | None = None,
) -> None:
    """Debug-log a tool-data failure according to the tool logging policy."""
    _log_action_at_level(
        target_logger.debug,
        message,
        exc,
        redact=_debug.DONT_LOG_TOOL_DATA,
        stacklevel=stacklevel,
        diagnostic_extra=diagnostic_extra,
    )

log_tool_action_warning

log_tool_action_warning(
    target_logger: Logger,
    message: str,
    exc: BaseException,
    *,
    stacklevel: int = 3,
    diagnostic_extra: _DiagnosticExtra | None = None,
) -> None

Warning-log a tool-data failure according to the tool logging policy.

Source code in src/agents/logger.py

def log_tool_action_warning(
    target_logger: logging.Logger,
    message: str,
    exc: BaseException,
    *,
    stacklevel: int = 3,
    diagnostic_extra: _DiagnosticExtra | None = None,
) -> None:
    """Warning-log a tool-data failure according to the tool logging policy."""
    _log_action_at_level(
        target_logger.warning,
        message,
        exc,
        redact=_debug.DONT_LOG_TOOL_DATA,
        stacklevel=stacklevel,
        diagnostic_extra=diagnostic_extra,
    )

log_model_and_tool_action_error

log_model_and_tool_action_error(
    target_logger: Logger,
    message: str,
    exc: BaseException,
    *,
    stacklevel: int = 3,
    diagnostic_extra: _DiagnosticExtra | None = None,
) -> None

Log a mixed model/tool-data failure only when both data policies allow it.

Source code in src/agents/logger.py

def log_model_and_tool_action_error(
    target_logger: logging.Logger,
    message: str,
    exc: BaseException,
    *,
    stacklevel: int = 3,
    diagnostic_extra: _DiagnosticExtra | None = None,
) -> None:
    """Log a mixed model/tool-data failure only when both data policies allow it."""
    _log_action_error(
        target_logger,
        message,
        exc,
        redact=_debug.DONT_LOG_MODEL_DATA or _debug.DONT_LOG_TOOL_DATA,
        stacklevel=stacklevel,
        diagnostic_extra=diagnostic_extra,
    )

log_model_and_tool_action_debug

log_model_and_tool_action_debug(
    target_logger: Logger,
    message: str,
    exc: BaseException,
    *,
    stacklevel: int = 3,
    diagnostic_extra: _DiagnosticExtra | None = None,
) -> None

Debug-log a mixed-data failure only when both data policies allow it.

Source code in src/agents/logger.py

def log_model_and_tool_action_debug(
    target_logger: logging.Logger,
    message: str,
    exc: BaseException,
    *,
    stacklevel: int = 3,
    diagnostic_extra: _DiagnosticExtra | None = None,
) -> None:
    """Debug-log a mixed-data failure only when both data policies allow it."""
    _log_action_at_level(
        target_logger.debug,
        message,
        exc,
        redact=_debug.DONT_LOG_MODEL_DATA or _debug.DONT_LOG_TOOL_DATA,
        stacklevel=stacklevel,
        diagnostic_extra=diagnostic_extra,
    )

log_model_and_tool_action_warning

log_model_and_tool_action_warning(
    target_logger: Logger,
    message: str,
    exc: BaseException,
    *,
    stacklevel: int = 3,
    diagnostic_extra: _DiagnosticExtra | None = None,
) -> None

Warning-log a mixed-data failure only when both data policies allow it.

Source code in src/agents/logger.py

def log_model_and_tool_action_warning(
    target_logger: logging.Logger,
    message: str,
    exc: BaseException,
    *,
    stacklevel: int = 3,
    diagnostic_extra: _DiagnosticExtra | None = None,
) -> None:
    """Warning-log a mixed-data failure only when both data policies allow it."""
    _log_action_at_level(
        target_logger.warning,
        message,
        exc,
        redact=_debug.DONT_LOG_MODEL_DATA or _debug.DONT_LOG_TOOL_DATA,
        stacklevel=stacklevel,
        diagnostic_extra=diagnostic_extra,
    )

log_model_and_tool_data_warning

log_model_and_tool_data_warning(
    target_logger: Logger,
    redacted_message: str,
    *,
    diagnostic_message: str,
    diagnostic_args: _DiagnosticArgs | None = None,
    stacklevel: int = 2,
) -> None

Log mixed model/tool data only when both data policies allow it.

Source code in src/agents/logger.py

def log_model_and_tool_data_warning(
    target_logger: logging.Logger,
    redacted_message: str,
    *,
    diagnostic_message: str,
    diagnostic_args: _DiagnosticArgs | None = None,
    stacklevel: int = 2,
) -> None:
    """Log mixed model/tool data only when both data policies allow it."""
    if _debug.DONT_LOG_MODEL_DATA or _debug.DONT_LOG_TOOL_DATA:
        target_logger.warning(redacted_message, stacklevel=stacklevel)
        return

    try:
        args = diagnostic_args() if diagnostic_args is not None else ()
    except Exception:
        target_logger.warning(redacted_message, stacklevel=stacklevel)
        return
    target_logger.warning(diagnostic_message, *args, stacklevel=stacklevel)