AsyncCallbackManagerForChainRun#

class langchain_core.callbacks.manager.AsyncCallbackManagerForChainRun(
*,
run_id: UUID,
handlers: list[BaseCallbackHandler],
inheritable_handlers: list[BaseCallbackHandler],
parent_run_id: UUID | None = None,
tags: list[str] | None = None,
inheritable_tags: list[str] | None = None,
metadata: dict[str, Any] | None = None,
inheritable_metadata: dict[str, Any] | None = None,
)[source]#

Async callback manager for chain run.

Initialize the run manager.

Parameters:

  • run_id (UUID) – The ID of the run.

  • handlers (list[BaseCallbackHandler]) – The list of handlers.

  • inheritable_handlers (list[BaseCallbackHandler]) – The list of inheritable handlers.

  • parent_run_id (UUID, optional) – The ID of the parent run. Defaults to None.

  • tags (Optional[list[str]]) – The list of tags. Defaults to None.

  • inheritable_tags (Optional[list[str]]) – The list of inheritable tags. Defaults to None.

  • metadata (Optional[dict[str, Any]]) – The metadata. Defaults to None.

  • inheritable_metadata (Optional[dict[str, Any]]) – The inheritable metadata. Defaults to None.

Methods

__init__(*, run_id, handlers, ...[, ...])

Initialize the run manager.

get_child([tag])

Get a child callback manager.

get_noop_manager()

Return a manager that doesn't perform any operations.

get_sync()

Get the equivalent sync RunManager.

on_agent_action(action, **kwargs)

Run when agent action is received.

on_agent_finish(finish, **kwargs)

Run when agent finish is received.

on_chain_end(outputs, **kwargs)

Run when a chain ends running.

on_chain_error(error, **kwargs)

Run when chain errors.

on_custom_event(name, data, *, run_id[, ...])

Override to define a handler for a custom event.

on_retry(retry_state, **kwargs)

Async run when a retry is received.

on_text(text, **kwargs)

Run when a text is received.
__init__(
*,
run_id: UUID,
handlers: list[BaseCallbackHandler],
inheritable_handlers: list[BaseCallbackHandler],
parent_run_id: UUID | None = None,
tags: list[str] | None = None,
inheritable_tags: list[str] | None = None,
metadata: dict[str, Any] | None = None,
inheritable_metadata: dict[str, Any] | None = None,
) → None#

Initialize the run manager.

Parameters:

  • run_id (UUID) – The ID of the run.

  • handlers (list[BaseCallbackHandler]) – The list of handlers.

  • inheritable_handlers (list[BaseCallbackHandler]) – The list of inheritable handlers.

  • parent_run_id (UUID, optional) – The ID of the parent run. Defaults to None.

  • tags (Optional[list[str]]) – The list of tags. Defaults to None.

  • inheritable_tags (Optional[list[str]]) – The list of inheritable tags. Defaults to None.

  • metadata (Optional[dict[str, Any]]) – The metadata. Defaults to None.

  • inheritable_metadata (Optional[dict[str, Any]]) – The inheritable metadata. Defaults to None.

Return type:

None

get_child(
tag: str | None = None,
) → AsyncCallbackManager#

Get a child callback manager.

Parameters:

tag (str, optional) – The tag for the child callback manager. Defaults to None.

Returns:

The child callback manager.

Return type:

AsyncCallbackManager

classmethod get_noop_manager() → Self#

Return a manager that doesn’t perform any operations.

Returns:

The noop manager.

Return type:

BaseRunManager

get_sync() → CallbackManagerForChainRun[source]#

Get the equivalent sync RunManager.

Returns:

The sync RunManager.

Return type:

CallbackManagerForChainRun

async on_agent_action(
action: AgentAction,
**kwargs: Any,
) → Any[source]#

Run when agent action is received.

Parameters:

  • action (AgentAction) – The agent action.

  • **kwargs (Any) – Additional keyword arguments.

Returns:

The result of the callback.

Return type:

Any

async on_agent_finish(
finish: AgentFinish,
**kwargs: Any,
) → Any[source]#

Run when agent finish is received.

Parameters:

  • finish (AgentFinish) – The agent finish.

  • **kwargs (Any) – Additional keyword arguments.

Returns:

The result of the callback.

Return type:

Any

async on_chain_end(
outputs: dict[str, Any] | Any,
**kwargs: Any,
) → None[source]#

Run when a chain ends running.

Parameters:

  • outputs (Union[dict[str, Any], Any]) – The outputs of the chain.

  • **kwargs (Any) – Additional keyword arguments.

Return type:

None

async on_chain_error(
error: BaseException,
**kwargs: Any,
) → None[source]#

Run when chain errors.

Parameters:

  • error (Exception or KeyboardInterrupt) – The error.

  • **kwargs (Any) – Additional keyword arguments.

Return type:

None

on_custom_event(
name: str,
data: Any,
*,
run_id: UUID,
tags: list[str] | None = None,
metadata: dict[str, Any] | None = None,
**kwargs: Any,
) → Any#

Override to define a handler for a custom event.

Parameters:

  • name (str) – The name of the custom event.

  • data (Any) – The data for the custom event. Format will match the format specified by the user.

  • run_id (UUID) – The ID of the run.

  • tags (Optional[list[str]]) – The tags associated with the custom event (includes inherited tags).

  • metadata (Optional[dict[str, Any]]) – The metadata associated with the custom event (includes inherited metadata).

  • kwargs (Any)

Return type:

Any

Added in version 0.2.15.

async on_retry(
retry_state: RetryCallState,
**kwargs: Any,
) → None#

Async run when a retry is received.

Parameters:

  • retry_state (RetryCallState) – The retry state.

  • **kwargs (Any) – Additional keyword arguments.

Return type:

None

async on_text(
text: str,
**kwargs: Any,
) → Any#

Run when a text is received.

Parameters:

  • text (str) – The received text.

  • **kwargs (Any) – Additional keyword arguments.

Returns:

The result of the callback.

Return type:

Any