langchain_core.callbacks.manager
.CallbackManager¶
- class langchain_core.callbacks.manager.CallbackManager(handlers: List[BaseCallbackHandler], inheritable_handlers: Optional[List[BaseCallbackHandler]] = None, parent_run_id: Optional[UUID] = None, *, tags: Optional[List[str]] = None, inheritable_tags: Optional[List[str]] = None, metadata: Optional[Dict[str, Any]] = None, inheritable_metadata: Optional[Dict[str, Any]] = None)[source]¶
Callback manager that handles callbacks from LangChain.
Initialize callback manager.
Attributes
is_async
Whether the callback manager is async.
Methods
__init__
(handlers[, inheritable_handlers, ...])Initialize callback manager.
add_handler
(handler[, inherit])Add a handler to the callback manager.
add_metadata
(metadata[, inherit])add_tags
(tags[, inherit])configure
([inheritable_callbacks, ...])Configure the callback manager.
copy
()Copy the callback manager.
on_chain_start
(serialized, inputs[, run_id])Run when chain starts running.
on_chat_model_start
(serialized, messages, ...)Run when LLM starts running.
on_llm_start
(serialized, prompts, **kwargs)Run when LLM starts running.
on_retriever_start
(serialized, query[, ...])Run when retriever starts running.
on_tool_start
(serialized, input_str[, ...])Run when tool starts running.
remove_handler
(handler)Remove a handler from the callback manager.
remove_metadata
(keys)remove_tags
(tags)set_handler
(handler[, inherit])Set handler as the only handler on the callback manager.
set_handlers
(handlers[, inherit])Set handlers as the only handlers on the callback manager.
- __init__(handlers: List[BaseCallbackHandler], inheritable_handlers: Optional[List[BaseCallbackHandler]] = None, parent_run_id: Optional[UUID] = None, *, tags: Optional[List[str]] = None, inheritable_tags: Optional[List[str]] = None, metadata: Optional[Dict[str, Any]] = None, inheritable_metadata: Optional[Dict[str, Any]] = None) None ¶
Initialize callback manager.
- add_handler(handler: BaseCallbackHandler, inherit: bool = True) None ¶
Add a handler to the callback manager.
- add_metadata(metadata: Dict[str, Any], inherit: bool = True) None ¶
- add_tags(tags: List[str], inherit: bool = True) None ¶
- classmethod configure(inheritable_callbacks: Optional[Union[List[BaseCallbackHandler], BaseCallbackManager]] = None, local_callbacks: Optional[Union[List[BaseCallbackHandler], BaseCallbackManager]] = None, verbose: bool = False, inheritable_tags: Optional[List[str]] = None, local_tags: Optional[List[str]] = None, inheritable_metadata: Optional[Dict[str, Any]] = None, local_metadata: Optional[Dict[str, Any]] = None) CallbackManager [source]¶
Configure the callback manager.
- Parameters
inheritable_callbacks (Optional[Callbacks], optional) – The inheritable callbacks. Defaults to None.
local_callbacks (Optional[Callbacks], optional) – The local callbacks. Defaults to None.
verbose (bool, optional) – Whether to enable verbose mode. Defaults to False.
inheritable_tags (Optional[List[str]], optional) – The inheritable tags. Defaults to None.
local_tags (Optional[List[str]], optional) – The local tags. Defaults to None.
inheritable_metadata (Optional[Dict[str, Any]], optional) – The inheritable metadata. Defaults to None.
local_metadata (Optional[Dict[str, Any]], optional) – The local metadata. Defaults to None.
- Returns
The configured callback manager.
- Return type
- copy() T ¶
Copy the callback manager.
- on_chain_start(serialized: Dict[str, Any], inputs: Union[Dict[str, Any], Any], run_id: Optional[UUID] = None, **kwargs: Any) CallbackManagerForChainRun [source]¶
Run when chain starts running.
- Parameters
serialized (Dict[str, Any]) – The serialized chain.
inputs (Union[Dict[str, Any], Any]) – The inputs to the chain.
run_id (UUID, optional) – The ID of the run. Defaults to None.
- Returns
The callback manager for the chain run.
- Return type
- on_chat_model_start(serialized: Dict[str, Any], messages: List[List[BaseMessage]], **kwargs: Any) List[CallbackManagerForLLMRun] [source]¶
Run when LLM starts running.
- Parameters
serialized (Dict[str, Any]) – The serialized LLM.
messages (List[List[BaseMessage]]) – The list of messages.
run_id (UUID, optional) – The ID of the run. Defaults to None.
- Returns
- A callback manager for each
list of messages as an LLM run.
- Return type
List[CallbackManagerForLLMRun]
- on_llm_start(serialized: Dict[str, Any], prompts: List[str], **kwargs: Any) List[CallbackManagerForLLMRun] [source]¶
Run when LLM starts running.
- Parameters
serialized (Dict[str, Any]) – The serialized LLM.
prompts (List[str]) – The list of prompts.
run_id (UUID, optional) – The ID of the run. Defaults to None.
- Returns
- A callback manager for each
prompt as an LLM run.
- Return type
List[CallbackManagerForLLMRun]
- on_retriever_start(serialized: Dict[str, Any], query: str, run_id: Optional[UUID] = None, parent_run_id: Optional[UUID] = None, **kwargs: Any) CallbackManagerForRetrieverRun [source]¶
Run when retriever starts running.
- on_tool_start(serialized: Dict[str, Any], input_str: str, run_id: Optional[UUID] = None, parent_run_id: Optional[UUID] = None, inputs: Optional[Dict[str, Any]] = None, **kwargs: Any) CallbackManagerForToolRun [source]¶
Run when tool starts running.
- Parameters
serialized – Serialized representation of the tool.
input_str – The input to the tool as a string. Non-string inputs are cast to strings.
run_id – ID for the run. Defaults to None.
parent_run_id – The ID of the parent run. Defaults to None.
inputs – The original input to the tool if provided. Recommended for usage instead of input_str when the original input is needed. If provided, the inputs are expected to be formatted as a dict. The keys will correspond to the named-arguments in the tool.
- Returns
The callback manager for the tool run.
- Return type
- remove_handler(handler: BaseCallbackHandler) None ¶
Remove a handler from the callback manager.
- remove_metadata(keys: List[str]) None ¶
- remove_tags(tags: List[str]) None ¶
- set_handler(handler: BaseCallbackHandler, inherit: bool = True) None ¶
Set handler as the only handler on the callback manager.
- set_handlers(handlers: List[BaseCallbackHandler], inherit: bool = True) None ¶
Set handlers as the only handlers on the callback manager.