h ddlZddlmZddlmZmZddlmZdedefdede e eefffdZ d edeefdedee e eefffd Z d ed edefd Z y)N) Awaitable)AnyCallable)toolfunc.returncTdtdttttfffd }|S)Nxrcd|dgSNcustom_tool_call_output)typeoutput)r rs `/var/www/html/eduruby.in/venv/lib/python3.12/site-packages/langchain_openai/tools/custom_tool.pywrappedz#_make_wrapped_func..wrapped s2d1gFGG)strlistdictr)rrs` r_make_wrapped_funcrs-H3H4S#X/H Nr coroutinec `dtdtdttttfffd }|S)Nargskwargsrc<K|i|d{}d|dgS7 wr r)rrresultrs rrz(_make_wrapped_coroutine..wrappeds, $1&112fEFF2s  )rrrr)rrs` r_make_wrapped_coroutiners5GSGCGDc3h4HG Nrrrcxdtdtfdtffd }|rt|dr s ||dS|S)ajDecorator to create an OpenAI custom tool. Custom tools allow for tools with (potentially long) freeform string inputs. See below for an example using LangGraph: .. code-block:: python @custom_tool def execute_code(code: str) -> str: """Execute python code.""" return "27" llm = ChatOpenAI(model="gpt-5", output_version="responses/v1") agent = create_react_agent(llm, [execute_code]) input_message = {"role": "user", "content": "Use the tool to calculate 3^3."} for step in agent.stream( {"messages": [input_message]}, stream_mode="values", ): step["messages"][-1].pretty_print() You can also specify a format for a corresponding context-free grammar using the ``format`` kwarg: .. code-block:: python from langchain_openai import ChatOpenAI, custom_tool from langgraph.prebuilt import create_react_agent grammar = """ start: expr expr: term (SP ADD SP term)* -> add | term term: factor (SP MUL SP factor)* -> mul | factor factor: INT SP: " " ADD: "+" MUL: "*" %import common.INT """ format = {"type": "grammar", "syntax": "lark", "definition": grammar} # highlight-next-line @custom_tool(format=format) def do_math(input_string: str) -> str: """Do a mathematical operation.""" return "27" llm = ChatOpenAI(model="gpt-5", output_version="responses/v1") agent = create_react_agent(llm, [do_math]) input_message = {"role": "user", "content": "Use the tool to calculate 3^3."} for step in agent.stream( {"messages": [input_message]}, stream_mode="values", ): step["messages"][-1].pretty_print() r.rcddi}dvrjd|d<tdddi|}||_|j|_t j |rt||_|St||_ |S)Nr custom_toolformat infer_schemaFr) poprmetadata__doc__ descriptioninspectiscoroutinefunctionrrrr)rr%tool_objrs r decoratorzcustom_tool..decorator]sM* v !'H!5HX 545U5f5d;$#||  & &t ,!8!>H /t4HMrr)rrcallable)rrr+s ` rr!r!sGH c* s  a!&a!! r)r(collections.abcrtypingrrlangchain_core.toolsrrrrrrr!rrrr0s% %Xc3h/HS$tCQTH~BV=V4WYs^+, c9T$sCx.1223TsTcTcTr