dhj#SrSSKJr SSKJrJr SSKJr SSKJ r J r SSK J r SSK Jr SSKJr SS KJr SS KJr SS KJrJrJrJrJr SS KJr "S S\ 5r"SS\ 5rg)zRequests toolkit.) annotations)AnyList)BaseLanguageModel)BaseToolTool) BaseToolkit)create_json_agent) JsonToolkit) DESCRIPTION)JsonSpec)RequestsDeleteToolRequestsGetToolRequestsPatchToolRequestsPostToolRequestsPutTool)TextRequestsWrapperc@\rSrSr%SrS\S'SrS\S'S SjrS rg ) RequestsToolkitauToolkit for making REST requests. *Security Note*: This toolkit contains tools to make GET, POST, PATCH, PUT, and DELETE requests to an API. Exercise care in who is allowed to use this toolkit. If exposing to end users, consider that users will be able to make arbitrary requests on behalf of the server hosting the code. For example, users could ask the server to make a request to a private API that is only accessible from the server. Control access to who can submit issue requests using this toolkit and what network access it has. See https://python.langchain.com/docs/security for more information. Setup: Install ``langchain-community``. .. code-block:: bash pip install -U langchain-community Key init args: requests_wrapper: langchain_community.utilities.requests.GenericRequestsWrapper wrapper for executing requests. allow_dangerous_requests: bool Defaults to False. Must "opt-in" to using dangerous requests by setting to True. Instantiate: .. code-block:: python from langchain_community.agent_toolkits.openapi.toolkit import RequestsToolkit from langchain_community.utilities.requests import TextRequestsWrapper toolkit = RequestsToolkit( requests_wrapper=TextRequestsWrapper(headers={}), allow_dangerous_requests=ALLOW_DANGEROUS_REQUEST, ) Tools: .. code-block:: python tools = toolkit.get_tools() tools .. code-block:: none [RequestsGetTool(requests_wrapper=TextRequestsWrapper(headers={}, aiosession=None, auth=None, response_content_type='text', verify=True), allow_dangerous_requests=True), RequestsPostTool(requests_wrapper=TextRequestsWrapper(headers={}, aiosession=None, auth=None, response_content_type='text', verify=True), allow_dangerous_requests=True), RequestsPatchTool(requests_wrapper=TextRequestsWrapper(headers={}, aiosession=None, auth=None, response_content_type='text', verify=True), allow_dangerous_requests=True), RequestsPutTool(requests_wrapper=TextRequestsWrapper(headers={}, aiosession=None, auth=None, response_content_type='text', verify=True), allow_dangerous_requests=True), RequestsDeleteTool(requests_wrapper=TextRequestsWrapper(headers={}, aiosession=None, auth=None, response_content_type='text', verify=True), allow_dangerous_requests=True)] Use within an agent: .. code-block:: python from langchain_openai import ChatOpenAI from langgraph.prebuilt import create_react_agent api_spec = """ openapi: 3.0.0 info: title: JSONPlaceholder API version: 1.0.0 servers: - url: https://jsonplaceholder.typicode.com paths: /posts: get: summary: Get posts parameters: &id001 - name: _limit in: query required: false schema: type: integer example: 2 description: Limit the number of results """ system_message = """ You have access to an API to help answer user queries. Here is documentation on the API: {api_spec} """.format(api_spec=api_spec) llm = ChatOpenAI(model="gpt-4o-mini") agent_executor = create_react_agent(llm, tools, state_modifier=system_message) example_query = "Fetch the top two posts. What are their titles?" events = agent_executor.stream( {"messages": [("user", example_query)]}, stream_mode="values", ) for event in events: event["messages"][-1].pretty_print() .. code-block:: none ================================[1m Human Message [0m================================= Fetch the top two posts. What are their titles? ==================================[1m Ai Message [0m================================== Tool Calls: requests_get (call_RV2SOyzCnV5h2sm4WPgG8fND) Call ID: call_RV2SOyzCnV5h2sm4WPgG8fND Args: url: https://jsonplaceholder.typicode.com/posts?_limit=2 =================================[1m Tool Message [0m================================= Name: requests_get [ { "userId": 1, "id": 1, "title": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit", "body": "quia et suscipit..." }, { "userId": 1, "id": 2, "title": "qui est esse", "body": "est rerum tempore vitae..." } ] ==================================[1m Ai Message [0m================================== The titles of the top two posts are: 1. "sunt aut facere repellat provident occaecati excepturi optio reprehenderit" 2. "qui est esse" rrequests_wrapperFboolallow_dangerous_requestsc ([URURS9[URURS9[ URURS9[ URURS9[ URURS9/$)zReturn a list of tools.rr)rrrrrrr)selfs j/var/www/html/shao/venv/lib/python3.13/site-packages/langchain_community/agent_toolkits/openapi/toolkit.py get_toolsRequestsToolkit.get_toolss !%!6!6)-)F)F  !%!6!6)-)F)F  !%!6!6)-)F)F  !%!6!6)-)F)F  !%!6!6)-)F)F #  NreturnzList[BaseTool]) __name__ __module__ __qualname____firstlineno____doc____annotations__rr__static_attributes__r!r rrrs'EN*)%*d*B r rc|\rSrSr%SrS\S'S\S'SrS\S 'SS jr\SSS jj5r S r g )OpenAPIToolkita;Toolkit for interacting with an OpenAPI API. *Security Note*: This toolkit contains tools that can read and modify the state of a service; e.g., by creating, deleting, or updating, reading underlying data. For example, this toolkit can be used to delete data exposed via an OpenAPI compliant API. r json_agentrrFrrc[SURR[S9n[ UR UR S9n/UR5QUP$)zGet the tools in the toolkit. json_explorer)namefunc descriptionr)rr.runr rrrr)rjson_agent_toolrequest_toolkits rrOpenAPIToolkit.get_toolssX $$#  *!22%)%B%B ?**,>o>>r c :[U[US940UD6nU"UUUS9$)z,Create json agent from llm, then initialize.)spec)r.rr)r r )clsllm json_specrrkwargsr.s rfrom_llmOpenAPIToolkit.from_llms0'sKY,GR6R !-%=  r r!Nr")F) r;rr<r rrrrr=rr#r,) r$r%r&r'r(r)rr classmethodr>r*r!r rr,r,sO))%*d*B ? */    .  #'       r r,N)r( __future__rtypingrrlangchain_core.language_modelsrlangchain_core.toolsrrlangchain_core.tools.baser ,langchain_community.agent_toolkits.json.baser /langchain_community.agent_toolkits.json.toolkitr 1langchain_community.agent_toolkits.openapi.promptr #langchain_community.tools.json.toolr 'langchain_community.tools.requests.toolrrrrr&langchain_community.utilities.requestsrrr,r!r rrLsN"</1JGI8Gd kd N. [. r