{ "cells": [ { "cell_type": "markdown", "id": "5fa317ef-b9a7-4432-ba85-ce71b8dfbdc6", "metadata": {}, "source": [ "# How to handle large numbers of tools\n", "\n", "
\n", "

Prerequisites

\n", "

\n", " This guide assumes familiarity with the following:\n", "

\n", "

\n", "
\n", "\n", "\n", "The subset of available tools to call is generally at the discretion of the model (although many providers also enable the user to [specify or constrain the choice of tool](https://python.langchain.com/docs/how_to/tool_choice/)). As the number of available tools grows, you may want to limit the scope of the LLM's selection, to decrease token consumption and to help manage sources of error in LLM reasoning.\n", "\n", "Here we will demonstrate how to dynamically adjust the tools available to a model. Bottom line up front: like [RAG](https://python.langchain.com/docs/concepts/#retrieval) and similar methods, we prefix the model invocation by retrieving over available tools. Although we demonstrate one implementation that searches over tool descriptions, the details of the tool selection can be customized as needed.\n", "\n", "## Setup\n", "\n", "First, let's install the required packages and set our API keys" ] }, { "cell_type": "code", "execution_count": 1, "id": "9b6c62bd", "metadata": {}, "outputs": [], "source": [ "%%capture --no-stderr\n", "%pip install --quiet -U langgraph langchain_openai numpy" ] }, { "cell_type": "code", "execution_count": 2, "id": "360d7ff6", "metadata": {}, "outputs": [], "source": [ "import getpass\n", "import os\n", "\n", "\n", "def _set_env(var: str):\n", " if not os.environ.get(var):\n", " os.environ[var] = getpass.getpass(f\"{var}: \")\n", "\n", "\n", "_set_env(\"OPENAI_API_KEY\")" ] }, { "cell_type": "markdown", "id": "25f9f6a0", "metadata": {}, "source": [ "
\n", "

Set up LangSmith for LangGraph development

\n", "

\n", " Sign up for LangSmith to quickly spot issues and improve the performance of your LangGraph projects. LangSmith lets you use trace data to debug, test, and monitor your LLM apps built with LangGraph — read more about how to get started here. \n", "

\n", "
" ] }, { "cell_type": "markdown", "id": "1a417013-ddc4-463b-8ea0-0904bd232827", "metadata": {}, "source": [ "## Define the tools" ] }, { "cell_type": "markdown", "id": "24708f3b-18b1-4b42-9f6a-0d4827222918", "metadata": {}, "source": [ "Let's consider a toy example in which we have one tool for each publicly traded company in the [S&P 500 index](https://en.wikipedia.org/wiki/S%26P_500). Each tool fetches company-specific information based on the year provided as a parameter.\n", "\n", "We first construct a registry that associates a unique identifier with a schema for each tool. We will represent the tools using JSON schema, which can be bound directly to chat models supporting tool calling." ] }, { "cell_type": "code", "execution_count": 10, "id": "da30c3f1-127f-4828-8609-94e16719f0be", "metadata": {}, "outputs": [], "source": [ "import re\n", "import uuid\n", "\n", "from langchain_core.tools import StructuredTool\n", "\n", "\n", "def create_tool(company: str) -> dict:\n", " \"\"\"Create schema for a placeholder tool.\"\"\"\n", " # Remove non-alphanumeric characters and replace spaces with underscores for the tool name\n", " formatted_company = re.sub(r\"[^\\w\\s]\", \"\", company).replace(\" \", \"_\")\n", "\n", " def company_tool(year: int) -> str:\n", " # Placeholder function returning static revenue information for the company and year\n", " return f\"{company} had revenues of $100 in {year}.\"\n", "\n", " return StructuredTool.from_function(\n", " company_tool,\n", " name=formatted_company,\n", " description=f\"Information about {company}\",\n", " )\n", "\n", "\n", "# Abbreviated list of S&P 500 companies for demonstration\n", "s_and_p_500_companies = [\n", " \"3M\",\n", " \"A.O. Smith\",\n", " \"Abbott\",\n", " \"Accenture\",\n", " \"Advanced Micro Devices\",\n", " \"Yum! Brands\",\n", " \"Zebra Technologies\",\n", " \"Zimmer Biomet\",\n", " \"Zoetis\",\n", "]\n", "\n", "# Create a tool for each company and store it in a registry with a unique UUID as the key\n", "tool_registry = {\n", " str(uuid.uuid4()): create_tool(company) for company in s_and_p_500_companies\n", "}" ] }, { "cell_type": "markdown", "id": "ba17b047-73ed-4385-adc2-f02012db2206", "metadata": {}, "source": [ "## Define the graph" ] }, { "cell_type": "markdown", "id": "2055548d-3d14-4aaf-9588-abf70f28b5d6", "metadata": {}, "source": [ "### Tool selection" ] }, { "cell_type": "markdown", "id": "8798a0d2-ea93-45bc-ab55-071ab975f2c2", "metadata": {}, "source": [ "We will construct a node that retrieves a subset of available tools given the information in the state-- such as a recent user message. In general, the full scope of [retrieval solutions](https://python.langchain.com/docs/concepts/#retrieval) are available for this step. As a simple solution, we index embeddings of tool descriptions in a vector store, and associate user queries to tools via semantic search." ] }, { "cell_type": "code", "execution_count": 11, "id": "435b0201-7296-4617-abf8-2c757a71f6b5", "metadata": {}, "outputs": [], "source": [ "from langchain_core.documents import Document\n", "from langchain_core.vectorstores import InMemoryVectorStore\n", "from langchain_openai import OpenAIEmbeddings\n", "\n", "tool_documents = [\n", " Document(\n", " page_content=tool.description,\n", " id=id,\n", " metadata={\"tool_name\": tool.name},\n", " )\n", " for id, tool in tool_registry.items()\n", "]\n", "\n", "vector_store = InMemoryVectorStore(embedding=OpenAIEmbeddings())\n", "document_ids = vector_store.add_documents(tool_documents)" ] }, { "cell_type": "markdown", "id": "e9ce366b-b5e7-41e9-b4a9-d775b9be0d09", "metadata": {}, "source": [ "### Incorporating with an agent\n", "\n", "We will use a typical React agent graph (e.g., as used in the [quickstart](https://langchain-ai.github.io/langgraph/tutorials/introduction/#part-2-enhancing-the-chatbot-with-tools)), with some modifications:\n", "\n", "- We add a `selected_tools` key to the state, which stores our selected subset of tools;\n", "- We set the entry point of the graph to be a `select_tools` node, which populates this element of the state;\n", "- We bind the selected subset of tools to the chat model within the `agent` node." ] }, { "cell_type": "code", "execution_count": 12, "id": "d319fea9-e8ae-4763-a785-b2bf72239ae4", "metadata": {}, "outputs": [], "source": [ "from typing import Annotated\n", "\n", "from langchain_openai import ChatOpenAI\n", "from typing_extensions import TypedDict\n", "\n", "from langgraph.graph import StateGraph, START\n", "from langgraph.graph.message import add_messages\n", "from langgraph.prebuilt import ToolNode, tools_condition\n", "\n", "\n", "# Define the state structure using TypedDict.\n", "# It includes a list of messages (processed by add_messages)\n", "# and a list of selected tool IDs.\n", "class State(TypedDict):\n", " messages: Annotated[list, add_messages]\n", " selected_tools: list[str]\n", "\n", "\n", "builder = StateGraph(State)\n", "\n", "# Retrieve all available tools from the tool registry.\n", "tools = list(tool_registry.values())\n", "llm = ChatOpenAI()\n", "\n", "\n", "# The agent function processes the current state\n", "# by binding selected tools to the LLM.\n", "def agent(state: State):\n", " # Map tool IDs to actual tools\n", " # based on the state's selected_tools list.\n", " selected_tools = [tool_registry[id] for id in state[\"selected_tools\"]]\n", " # Bind the selected tools to the LLM for the current interaction.\n", " llm_with_tools = llm.bind_tools(selected_tools)\n", " # Invoke the LLM with the current messages and return the updated message list.\n", " return {\"messages\": [llm_with_tools.invoke(state[\"messages\"])]}\n", "\n", "\n", "# The select_tools function selects tools based on the user's last message content.\n", "def select_tools(state: State):\n", " last_user_message = state[\"messages\"][-1]\n", " query = last_user_message.content\n", " tool_documents = vector_store.similarity_search(query)\n", " return {\"selected_tools\": [document.id for document in tool_documents]}\n", "\n", "\n", "builder.add_node(\"agent\", agent)\n", "builder.add_node(\"select_tools\", select_tools)\n", "\n", "tool_node = ToolNode(tools=tools)\n", "builder.add_node(\"tools\", tool_node)\n", "\n", "builder.add_conditional_edges(\n", " \"agent\",\n", " tools_condition,\n", ")\n", "builder.add_edge(\"tools\", \"agent\")\n", "builder.add_edge(\"select_tools\", \"agent\")\n", "builder.add_edge(START, \"select_tools\")\n", "graph = builder.compile()" ] }, { "cell_type": "code", "execution_count": 13, "id": "35cab3b2-4d03-4cb5-ba10-f7d3a5ad5244", "metadata": {}, "outputs": [ { "data": { "image/jpeg": "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", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "from IPython.display import Image, display\n", "\n", "try:\n", " display(Image(graph.get_graph().draw_mermaid_png()))\n", "except Exception:\n", " # This requires some extra dependencies and is optional\n", " pass" ] }, { "cell_type": "code", "execution_count": 14, "id": "66f62a69-989b-46ce-80b3-97a867e36782", "metadata": {}, "outputs": [], "source": [ "user_input = \"Can you give me some information about AMD in 2022?\"\n", "\n", "result = graph.invoke({\"messages\": [(\"user\", user_input)]})" ] }, { "cell_type": "code", "execution_count": 15, "id": "479a459d-6896-4960-aae9-9f1259fb47d1", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "['ab9c0d59-3d16-448d-910c-73cf10a26020', 'f5eff8f6-7fb9-47b6-b54f-19872a52db84', '2962e168-9ef4-48dc-8b7c-9227e7956d39', '24a9fb82-19fe-4a88-944e-47bc4032e94a']\n" ] } ], "source": [ "print(result[\"selected_tools\"])" ] }, { "cell_type": "code", "execution_count": 16, "id": "376f28fd-3f7f-4ae5-a34c-baef1778e82b", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "================================\u001b[1m Human Message \u001b[0m=================================\n", "\n", "Can you give me some information about AMD in 2022?\n", "==================================\u001b[1m Ai Message \u001b[0m==================================\n", "Tool Calls:\n", " Advanced_Micro_Devices (call_CRxQ0oT7NY7lqf35DaRNTJ35)\n", " Call ID: call_CRxQ0oT7NY7lqf35DaRNTJ35\n", " Args:\n", " year: 2022\n", "=================================\u001b[1m Tool Message \u001b[0m=================================\n", "Name: Advanced_Micro_Devices\n", "\n", "Advanced Micro Devices had revenues of $100 in 2022.\n", "==================================\u001b[1m Ai Message \u001b[0m==================================\n", "\n", "In 2022, Advanced Micro Devices (AMD) had revenues of $100.\n" ] } ], "source": [ "for message in result[\"messages\"]:\n", " message.pretty_print()" ] }, { "cell_type": "markdown", "id": "3bd847ef-4627-4fc2-99f9-c2b17cf83f95", "metadata": {}, "source": [ "## Repeating tool selection\n", "\n", "To manage errors from incorrect tool selection, we could revisit the `select_tools` node. One option for implementing this is to modify `select_tools` to generate the vector store query using all messages in the state (e.g., with a chat model) and add an edge routing from `tools` to `select_tools`.\n", "\n", "We implement this change below. For demonstration purposes, we simulate an error in the initial tool selection by adding a `hack_remove_tool_condition` to the `select_tools` node, which removes the correct tool on the first iteration of the node. Note that on the second iteration, the agent finishes the run as it has access to the correct tool." ] }, { "cell_type": "markdown", "id": "985a5388", "metadata": {}, "source": [ "
\n", "

Using Pydantic with LangChain

\n", "

\n", " This notebook uses Pydantic v2 BaseModel, which requires langchain-core >= 0.3. Using langchain-core < 0.3 will result in errors due to mixing of Pydantic v1 and v2 BaseModels.\n", "

\n", "
" ] }, { "cell_type": "code", "execution_count": 46, "id": "1954a5f1-91e4-4b32-9be9-c8bc1cc43cb5", "metadata": {}, "outputs": [], "source": [ "from langchain_core.messages import HumanMessage, SystemMessage, ToolMessage\n", "from langgraph.pregel.retry import RetryPolicy\n", "\n", "from pydantic import BaseModel, Field\n", "\n", "\n", "class QueryForTools(BaseModel):\n", " \"\"\"Generate a query for additional tools.\"\"\"\n", "\n", " query: str = Field(..., description=\"Query for additional tools.\")\n", "\n", "\n", "def select_tools(state: State):\n", " \"\"\"Selects tools based on the last message in the conversation state.\n", "\n", " If the last message is from a human, directly uses the content of the message\n", " as the query. Otherwise, constructs a query using a system message and invokes\n", " the LLM to generate tool suggestions.\n", " \"\"\"\n", " last_message = state[\"messages\"][-1]\n", " hack_remove_tool_condition = False # Simulate an error in the first tool selection\n", "\n", " if isinstance(last_message, HumanMessage):\n", " query = last_message.content\n", " hack_remove_tool_condition = True # Simulate wrong tool selection\n", " else:\n", " assert isinstance(last_message, ToolMessage)\n", " system = SystemMessage(\n", " \"Given this conversation, generate a query for additional tools. \"\n", " \"The query should be a short string containing what type of information \"\n", " \"is needed. If no further information is needed, \"\n", " \"set more_information_needed False and populate a blank string for the query.\"\n", " )\n", " input_messages = [system] + state[\"messages\"]\n", " response = llm.bind_tools([QueryForTools], tool_choice=True).invoke(\n", " input_messages\n", " )\n", " query = response.tool_calls[0][\"args\"][\"query\"]\n", "\n", " # Search the tool vector store using the generated query\n", " tool_documents = vector_store.similarity_search(query)\n", " if hack_remove_tool_condition:\n", " # Simulate error by removing the correct tool from the selection\n", " selected_tools = [\n", " document.id\n", " for document in tool_documents\n", " if document.metadata[\"tool_name\"] != \"Advanced_Micro_Devices\"\n", " ]\n", " else:\n", " selected_tools = [document.id for document in tool_documents]\n", " return {\"selected_tools\": selected_tools}\n", "\n", "\n", "graph_builder = StateGraph(State)\n", "graph_builder.add_node(\"agent\", agent)\n", "graph_builder.add_node(\"select_tools\", select_tools, retry=RetryPolicy(max_attempts=3))\n", "\n", "tool_node = ToolNode(tools=tools)\n", "graph_builder.add_node(\"tools\", tool_node)\n", "\n", "graph_builder.add_conditional_edges(\n", " \"agent\",\n", " tools_condition,\n", ")\n", "graph_builder.add_edge(\"tools\", \"select_tools\")\n", "graph_builder.add_edge(\"select_tools\", \"agent\")\n", "graph_builder.add_edge(START, \"select_tools\")\n", "graph = graph_builder.compile()" ] }, { "cell_type": "code", "execution_count": 47, "id": "9110789a-843a-4c21-aeff-8841b24f7674", "metadata": {}, "outputs": [ { "data": { "image/jpeg": "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", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "from IPython.display import Image, display\n", "\n", "try:\n", " display(Image(graph.get_graph().draw_mermaid_png()))\n", "except Exception:\n", " # This requires some extra dependencies and is optional\n", " pass" ] }, { "cell_type": "code", "execution_count": 48, "id": "bee04c3d-0e36-4443-b0c8-10986a5f6e39", "metadata": {}, "outputs": [], "source": [ "user_input = \"Can you give me some information about AMD in 2022?\"\n", "\n", "result = graph.invoke({\"messages\": [(\"user\", user_input)]})" ] }, { "cell_type": "code", "execution_count": 49, "id": "6906fb50-435c-4473-bbb6-5353433b9199", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "================================\u001b[1m Human Message \u001b[0m=================================\n", "\n", "Can you give me some information about AMD in 2022?\n", "==================================\u001b[1m Ai Message \u001b[0m==================================\n", "Tool Calls:\n", " Accenture (call_qGmwFnENwwzHOYJXiCAaY5Mx)\n", " Call ID: call_qGmwFnENwwzHOYJXiCAaY5Mx\n", " Args:\n", " year: 2022\n", "=================================\u001b[1m Tool Message \u001b[0m=================================\n", "Name: Accenture\n", "\n", "Accenture had revenues of $100 in 2022.\n", "==================================\u001b[1m Ai Message \u001b[0m==================================\n", "Tool Calls:\n", " Advanced_Micro_Devices (call_u9e5UIJtiieXVYi7Y9GgyDpn)\n", " Call ID: call_u9e5UIJtiieXVYi7Y9GgyDpn\n", " Args:\n", " year: 2022\n", "=================================\u001b[1m Tool Message \u001b[0m=================================\n", "Name: Advanced_Micro_Devices\n", "\n", "Advanced Micro Devices had revenues of $100 in 2022.\n", "==================================\u001b[1m Ai Message \u001b[0m==================================\n", "\n", "In 2022, AMD had revenues of $100.\n" ] } ], "source": [ "for message in result[\"messages\"]:\n", " message.pretty_print()" ] }, { "cell_type": "markdown", "id": "177aedfa-cec5-45d0-82ad-efc0233aa6b4", "metadata": {}, "source": [ "## Next steps\n", "\n", "This guide provides a minimal implementation for dynamically selecting tools. There is a host of possible improvements and optimizations:\n", "\n", "- **Repeating tool selection**: Here, we repeated tool selection by modifying the `select_tools` node. Another option is to equip the agent with a `reselect_tools` tool, allowing it to re-select tools at its discretion.\n", "- **Optimizing tool selection**: In general, the full scope of [retrieval solutions](https://python.langchain.com/docs/concepts/#retrieval) are available for tool selection. Additional options include:\n", " - Group tools and retrieve over groups;\n", " - Use a chat model to select tools or groups of tool." ] } ], "metadata": { "kernelspec": { "display_name": "Python 3 (ipykernel)", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.11.4" } }, "nbformat": 4, "nbformat_minor": 5 }