구조화된 도구(Structured Tools) 소개

import requests
from langchain.tools.base import StructuredTool

API_KEY = "<MY-API-KEY>"

def get_huggingface_models(
    path: Optional[str] = None, query_params: Optional[dict] = None
) -> dict:
"""Tool that calls GET on <https://huggingface.co/models*> apis. Valid params include "search":"search", "author":"author", "filter":"filter" and "sort":"sort"."""
base_url = "<https://huggingface.co/api/models>"
headers = {"authorization": f"Bearer {API_KEY}"}
result = requests.get(base_url + (path or ""), params=query_params, headers=headers)
return result.json()

get_huggingface_models_tool = StructuredTool.from_function(get_huggingface_models)
models = get_huggingface_models_tool.run({"query_params": {"search": "gpt-j"}})
print(models)

from typing import Optional, Type

import aiohttp

import requests

from langchain.callbacks.manager import (

AsyncCallbackManagerForToolRun,

CallbackManagerForToolRun,

)

from langchain.tools import BaseTool

from pydantic import BaseModel, BaseSettings, Field

class GetHuggingFaceModelsToolSchema(BaseModel):

    path: str = Field(default="", description="the api path")
    query_params: Optional[dict] = Field(
        default=None, description="Optional search parameters"
    )

class GetHuggingFaceModelsTool(BaseTool, BaseSettings):

    """My custom tool."""
    name: str = "get_huggingface_models"
    description: str = "<https://huggingface.co/models*>에 GET을 호출하는 도구입니다. 유효한 매개변수에는 \"search\":\"search\", \"author\":\"author\", \"filter\":\"filter\", 그리고 \"sort\":\"sort\"가 포함됩니다."
    args_schema: Type[GetHuggingFaceModelsToolSchema] = GetHuggingFaceModelsToolSchema
    base_url: str = "<https://huggingface.co/api/models>"
    api_key: str = Field(..., env="HUGGINGFACE_API_KEY")

    @property
    def _headers(self) -> dict:
        return {"authorization": f"Bearer {self.api_key}"}

def _run(
    self,
    path: str = "",
    query_params: Optional[dict] = None,
    run_manager: Optional[CallbackManagerForToolRun] = None,
) -> dict:
    """도구 실행"""
    result = requests.get(
        self.base_url + path, params=query_params, headers=self._headers
    )
    return result.json()

async def _arun(
    self,
    path: str = "",
    query_params: Optional[dict] = None,
    run_manager: Optional[AsyncCallbackManagerForToolRun] = None,
) -> dict:
    """도구 비동기 실행."""
    async with aiohttp.ClientSession() as session:
        async with session.get(
            self.base_url + path, params=query_params, headers=self._headers
        ) as response:
            return await response.json()

get_models_tool = GetHuggingFaceModelsTool()

models = get_models_tool.run({"query_params": {"search": "gpt-j"}})\n\n## 구조화된 도구(Structured Tools)는 어떻게 사용하나요?\n\n저희는 이러한 구조화된 도구와 네이티브하게 작동하는 새로운 `StructuredChatAgent`를 추가했습니다. 자세한 내용은 이 페이지에서 확인하실 수 있습니다.\n\n기존 에이전트들의 기본 프롬프트 및 출력 파서에 제한 사항이 있어, 별도의 사용자 정의 없이는 구조화된 도구와 효과적으로 작동하지 않습니다.\n\n시작하려면 다음 코드 스니펫을 사용하여 구조화된 채팅 에이전트 실행기(executor)를 인스턴스화할 수 있습니다:\n\n`from langchain.agents import initialize_agent, AgentType`\n\n`from langchain.chat_models import ChatAnthropic`\n\ntools = [] # 여기에 도구를 추가하세요\n\nllm = ChatAnthropic(temperature=0) # 또는 다른 LLM을 사용하세요\n\nagent_chain = initialize_agent(tools, llm, agent=AgentType.STRUCTURED_CHAT_ZERO_SHOT_REACT_DESCRIPTION)\n\n이러한 도구들은 또한 `langchain.experimental`의 `AutoGPT` 에이전트와도 호환됩니다.\n\n## FAQ\n\n**질문: 기존 에이전트에 구조화된 도구를 사용할 수 있나요?**\n\n답변: 만약 구조화된 도구가 하나의 문자열 인자(string argument)를 받는다면: **예**, 여전히 기존 에이전트와 작동합니다. 하지만, 하나 이상의 인자를 받는 구조화된 도구는 다음 에이전트들과 추가적인 사용자 정의 없이는 직접적으로 호환되지 않습니다:\n\n`zero-shot-react-description`\n\n`react-docstore`\n\n`self-ask-with-search`\n\n`conversational-react-description`\n\n`chat-zero-shot-react-description`\n\n`chat-conversational-react-description`\n\n**질문: 여전히 문자열 도구(string Tools)를 만들 수 있나요?**\n\n답변: `Tool` 생성자와 `@tool` 데코레이터를 사용하여 간단한 문자열 도구를 정의할 수 있습니다. `BaseTool` 클래스를 상속받고 단일 문자열 인자를 받는 도구들은 여전히 문자열 도구로 처리됩니다.\n\n**질문: 이전에 정의된 문자열 BaseTool을 구조화된 도구를 위해 새로 구축된 에이전트에서 사용할 수 있나요?**\n\n답변: 네! 구조화된 도구는 새로운 에이전트 실행기를 필요로 하지 않으며, 이전 도구들은 미래 호환성(forwards compatible)을 가집니다. 원래의 `Tool` 클래스는 `StructuredTool`과 동일한 기본 클래스를 공유합니다.

, 즉 여러분의 도구들이 별도의 수정 없이 바로 작동해야 한다는 의미입니다.

JSON 직렬화된 문자열 입력을 예상하는 도구들은 최신 에이전트의 출력 파서와 상호 운용성을 위해 일부 수정이 필요할 수 있습니다. 또는 더 복잡한 인터페이스에 대한 향상된 지원을 제공할 새로운 형식으로 업데이트될 수도 있습니다.