langchain_core.callbacks.stdout — 🦜🔗 LangChain 0.2.0

"""回调处理程序，将内容打印到标准输出。"""

from __future__ import annotations

from typing import TYPE_CHECKING, Any, Dict, Optional

from langchain_core.callbacks.base import BaseCallbackHandler
from langchain_core.utils import print_text

if TYPE_CHECKING:
    from langchain_core.agents import AgentAction, AgentFinish


[docs]class StdOutCallbackHandler(BaseCallbackHandler):
    """回调处理程序，将内容打印到标准输出。"""

[docs]    def __init__(self, color: Optional[str] = None) -> None:
        """初始化回调处理程序。"""
        self.color = color

[docs]    def on_chain_start(
        self, serialized: Dict[str, Any], inputs: Dict[str, Any], **kwargs: Any
    ) -> None:
        """打印出我们正在进入一个链条。"""
        class_name = serialized.get("name", serialized.get("id", ["<unknown>"])[-1])
        print(f"\n\n\033[1m> Entering new {class_name} chain...\033[0m")  # noqa: T201

[docs]    def on_chain_end(self, outputs: Dict[str, Any], **kwargs: Any) -> None:
        """打印出我们完成了一个链条。"""
        print("\n\033[1m> Finished chain.\033[0m")  # noqa: T201

[docs]    def on_agent_action(
        self, action: AgentAction, color: Optional[str] = None, **kwargs: Any
    ) -> Any:
        """在代理程序上运行的动作。"""
        print_text(action.log, color=color or self.color)

[docs]    def on_tool_end(
        self,
        output: Any,
        color: Optional[str] = None,
        observation_prefix: Optional[str] = None,
        llm_prefix: Optional[str] = None,
        **kwargs: Any,
    ) -> None:
        """如果不是最终动作，则打印出观察结果。"""
        output = str(output)
        if observation_prefix is not None:
            print_text(f"\n{observation_prefix}")
        print_text(output, color=color or self.color)
        if llm_prefix is not None:
            print_text(f"\n{llm_prefix}")

[docs]    def on_text(
        self,
        text: str,
        color: Optional[str] = None,
        end: str = "",
        **kwargs: Any,
    ) -> None:
        """当代理程序结束时运行。"""
        print_text(text, color=color or self.color, end=end)

[docs]    def on_agent_finish(
        self, finish: AgentFinish, color: Optional[str] = None, **kwargs: Any
    ) -> None:
        """在代理端运行。"""
        print_text(finish.log, color=color or self.color, end="\n")
Source code for langchain_core.callbacks.stdout
