__init__.py — langchain Source File

Source Code

"""**Tools** are classes that an Agent uses to interact with the world.

Each tool has a **description**. Agent uses the description to choose the right
tool for the job.
"""

import warnings
from typing import Any

from langchain_core._api import LangChainDeprecationWarning
from langchain_core.tools import (
    BaseTool as BaseTool,
)
from langchain_core.tools import (
    StructuredTool as StructuredTool,
)
from langchain_core.tools import (
    Tool as Tool,
)
from langchain_core.tools.convert import tool as tool

from langchain_classic._api.interactive_env import is_interactive_env

# Used for internal purposes
_DEPRECATED_TOOLS = {"PythonAstREPLTool", "PythonREPLTool"}


def _import_python_tool_python_ast_repl_tool() -> Any:
    msg = (
        "This tool has been moved to langchain_experimental. "
        "This tool has access to a python REPL. "
        "For best practices make sure to sandbox this tool. "
        "Read https://github.com/langchain-ai/langchain/blob/master/SECURITY.md "
        "To keep using this code as is, install langchain_experimental and "
        "update relevant imports replacing 'langchain' with 'langchain_experimental'"
    )
    raise ImportError(msg)


def _import_python_tool_python_repl_tool() -> Any:
    msg = (
        "This tool has been moved to langchain_experimental. "
        "This tool has access to a python REPL. "
        "For best practices make sure to sandbox this tool. "
        "Read https://github.com/langchain-ai/langchain/blob/master/SECURITY.md "
        "To keep using this code as is, install langchain_experimental and "
        "update relevant imports replacing 'langchain' with 'langchain_experimental'"
    )
    raise ImportError(msg)


def __getattr__(name: str) -> Any:
    if name == "PythonAstREPLTool":
        return _import_python_tool_python_ast_repl_tool()
    if name == "PythonREPLTool":
        return _import_python_tool_python_repl_tool()
    from langchain_community import tools

    # If not in interactive env, raise warning.
    if not is_interactive_env():
// ... (136 more lines)