mirror of
https://github.com/Mintplex-Labs/langchain-python.git
synced 2026-07-19 21:33:31 -04:00
Zander Chase
9b9b231e10
Haven't gotten to all of them, but this: - Updates some of the tools notebooks to actually instantiate a tool (many just show a 'utility' rather than a tool. More changes to come in separate PR) - Move the `Tool` and decorator definitions to `langchain/tools/base.py` (but still export from `langchain.agents`) - Add scene explain to the load_tools() function - Add unit tests for public apis for the langchain.tools and langchain.agents modules
69 lines
2.2 KiB
Python
69 lines
2.2 KiB
Python
"""Util that calls SceneXplain.
|
|
|
|
In order to set this up, you need API key for the SceneXplain API.
|
|
You can obtain a key by following the steps below.
|
|
- Sign up for a free account at https://scenex.jina.ai/.
|
|
- Navigate to the API Access page (https://scenex.jina.ai/api) and create a new API key.
|
|
"""
|
|
from typing import Dict
|
|
|
|
import requests
|
|
from pydantic import BaseModel, BaseSettings, Field, root_validator
|
|
|
|
from langchain.utils import get_from_dict_or_env
|
|
|
|
|
|
class SceneXplainAPIWrapper(BaseSettings, BaseModel):
|
|
"""Wrapper for SceneXplain API.
|
|
|
|
In order to set this up, you need API key for the SceneXplain API.
|
|
You can obtain a key by following the steps below.
|
|
- Sign up for a free account at https://scenex.jina.ai/.
|
|
- Navigate to the API Access page (https://scenex.jina.ai/api)
|
|
and create a new API key.
|
|
"""
|
|
|
|
scenex_api_key: str = Field(..., env="SCENEX_API_KEY")
|
|
scenex_api_url: str = (
|
|
"https://us-central1-causal-diffusion.cloudfunctions.net/describe"
|
|
)
|
|
|
|
def _describe_image(self, image: str) -> str:
|
|
headers = {
|
|
"x-api-key": f"token {self.scenex_api_key}",
|
|
"content-type": "application/json",
|
|
}
|
|
payload = {
|
|
"data": [
|
|
{
|
|
"image": image,
|
|
"algorithm": "Ember",
|
|
"languages": ["en"],
|
|
}
|
|
]
|
|
}
|
|
response = requests.post(self.scenex_api_url, headers=headers, json=payload)
|
|
response.raise_for_status()
|
|
result = response.json().get("result", [])
|
|
img = result[0] if result else {}
|
|
|
|
return img.get("text", "")
|
|
|
|
@root_validator(pre=True)
|
|
def validate_environment(cls, values: Dict) -> Dict:
|
|
"""Validate that api key exists in environment."""
|
|
scenex_api_key = get_from_dict_or_env(
|
|
values, "scenex_api_key", "SCENEX_API_KEY"
|
|
)
|
|
values["scenex_api_key"] = scenex_api_key
|
|
|
|
return values
|
|
|
|
def run(self, image: str) -> str:
|
|
"""Run SceneXplain image explainer."""
|
|
description = self._describe_image(image)
|
|
if not description:
|
|
return "No description found."
|
|
|
|
return description
|