mirror of
https://github.com/hwchase17/langchain.git
synced 2025-06-20 22:03:52 +00:00
600b7bdd61
Co-authored-by: Bagatur <baskaryan@gmail.com> Co-authored-by: Bagatur <22008038+baskaryan@users.noreply.github.com>
84 lines
2.9 KiB
Python
84 lines
2.9 KiB
Python
from __future__ import annotations
|
|
|
|
from typing import Optional, Type
|
|
from urllib.parse import urlparse
|
|
|
|
from langchain_core.callbacks import (
|
|
AsyncCallbackManagerForToolRun,
|
|
CallbackManagerForToolRun,
|
|
)
|
|
from pydantic import BaseModel, Field, model_validator
|
|
|
|
from langchain_community.tools.playwright.base import BaseBrowserTool
|
|
from langchain_community.tools.playwright.utils import (
|
|
aget_current_page,
|
|
get_current_page,
|
|
)
|
|
|
|
|
|
class NavigateToolInput(BaseModel):
|
|
"""Input for NavigateToolInput."""
|
|
|
|
url: str = Field(..., description="url to navigate to")
|
|
|
|
@model_validator(mode="before")
|
|
@classmethod
|
|
def validate_url_scheme(cls, values: dict) -> dict:
|
|
"""Check that the URL scheme is valid."""
|
|
url = values.get("url")
|
|
parsed_url = urlparse(url)
|
|
if parsed_url.scheme not in ("http", "https"):
|
|
raise ValueError("URL scheme must be 'http' or 'https'")
|
|
return values
|
|
|
|
|
|
class NavigateTool(BaseBrowserTool): # type: ignore[override, override]
|
|
"""Tool for navigating a browser to a URL.
|
|
|
|
**Security Note**: This tool provides code to control web-browser navigation.
|
|
|
|
This tool can navigate to any URL, including internal network URLs, and
|
|
URLs exposed on the server itself.
|
|
|
|
However, if exposing this tool to end-users, consider limiting network
|
|
access to the server that hosts the agent.
|
|
|
|
By default, the URL scheme has been limited to 'http' and 'https' to
|
|
prevent navigation to local file system URLs (or other schemes).
|
|
|
|
If access to the local file system is required, consider creating a custom
|
|
tool or providing a custom args_schema that allows the desired URL schemes.
|
|
|
|
See https://python.langchain.com/docs/security for more information.
|
|
"""
|
|
|
|
name: str = "navigate_browser"
|
|
description: str = "Navigate a browser to the specified URL"
|
|
args_schema: Type[BaseModel] = NavigateToolInput
|
|
|
|
def _run(
|
|
self,
|
|
url: str,
|
|
run_manager: Optional[CallbackManagerForToolRun] = None,
|
|
) -> str:
|
|
"""Use the tool."""
|
|
if self.sync_browser is None:
|
|
raise ValueError(f"Synchronous browser not provided to {self.name}")
|
|
page = get_current_page(self.sync_browser)
|
|
response = page.goto(url)
|
|
status = response.status if response else "unknown"
|
|
return f"Navigating to {url} returned status code {status}"
|
|
|
|
async def _arun(
|
|
self,
|
|
url: str,
|
|
run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
|
|
) -> str:
|
|
"""Use the tool."""
|
|
if self.async_browser is None:
|
|
raise ValueError(f"Asynchronous browser not provided to {self.name}")
|
|
page = await aget_current_page(self.async_browser)
|
|
response = await page.goto(url)
|
|
status = response.status if response else "unknown"
|
|
return f"Navigating to {url} returned status code {status}"
|