Configure tools for agents

Configure tools connected to agents to extend their capabilities.

Edit a tool's actions

When you set any component to Tool Mode or Tool output, an agent can use the actions (functions) provided by that component. Available actions are listed in the tool component's Actions list.

You can change each action's labels, descriptions, and availability to help the agent understand how to use the tool and prevent it from using irrelevant or undesired actions.

tip

If an agent seems to be using a tool incorrectly, try editing the action metadata to clarify the tool's purpose and disable unnecessary actions.

You can also try using a Prompt Template component to pass additional instructions or examples to the agent.

To view and edit a tool's actions, click Edit Tool Actions on the tool component.

The following information is provided for each action:

• Enabled: A checkbox that determines whether the action is available to the agent. If checked, the action is enabled. If unchecked, the action is disabled.

• Name: A human-readable string name for the action, such as Fetch Content. This cannot be changed.

• Description: A human-readable description of the action's purpose, such as Fetch content from web pages recursively.

  To edit this value, double-click the action's row to open the edit pane. Changes are saved automatically when you click out of the field or close the dialog.

• Slug: An encoded name for the action, usually the same as the name but in snake case, such as fetch_content.

  To edit this value, double-click the action's row to open the edit pane. Changes are saved automatically when you click out of the field or close the dialog.

To edit the Description or Slug, double-click anywhere on the action's row to open the edit pane. Note that the Name field on the edit page maps to the Slug column. Changes are saved automatically when you click out of a field or close the dialog.

Optionally, you can provide fixed values for an action's inputs. Typically you want to leave these blank so the agent can provide its own values. You might use a fixed value if you're trying to debug an agent's behavior or your use case requires a fixed input for an action.

Use an agent as a tool

To create multi-agent flows, you can set another Agent component to Tool Mode, and then attach that agent as a tool for your primary Agent component.

To try this for yourself, add an additional agent to the Simple Agent template:

1. Create a flow based on the Simple Agent template.

2. Add a second Agent component to the flow.

3. Add your OpenAI API Key to both Agent components.

4. In the second Agent component, change the model to gpt-4.1, and then enable Tool Mode.

5. Click Edit Tool Actions to edit the tool's actions.

   For this example, change the action Slug to Agent-gpt-41 and set the description to Use the gpt-4.1 model for complex problem solving. This lets the primary agent know that this tool uses the gpt-4.1 model, which could be helpful for tasks requiring a larger context window, such as large scrape and search tasks.

   As another example, you could attach several specialized models to a primary agent, such as agents that are trained on certain tasks or domains, and then the primary agent would call each specialized agent as needed to respond to queries.

   You can also enable and disable tools if you want to limit the available toolset.

6. Connect the new agent's Toolset port to the existing agent's Tools port.

   

Add custom components as tools

An agent can use custom components as tools.

1. To add a custom component to an agent flow, click New Custom Component in the Components menu.

2. Enter Python code into the Code pane to create the custom component.

   If you don't already have code for a custom component, you can use the following code snippet as an example before creating your own.

   Text Analyzer custom component

   This code creates a text analyzer component.

   
   

   _50

   from langflow.custom import Component

   _50

   from langflow.io import MessageTextInput, Output

   _50

   from langflow.schema import Data

   _50

   import re

   _50

   _50

   class TextAnalyzerComponent(Component):

   _50

   display_name = "Text Analyzer"

   _50

   description = "Analyzes and transforms input text."

   _50

   documentation: str = "http://docs.langflow.org/components/custom"

   _50

   icon = "chart-bar"

   _50

   name = "TextAnalyzerComponent"

   _50

   _50

   inputs = [

   _50

   MessageTextInput(

   _50

   name="input_text",

   _50

   display_name="Input Text",

   _50

   info="Enter text to analyze",

   _50

   value="Hello, World!",

   _50

   tool_mode=True,

   _50

   ),

   _50

   ]

   _50

   _50

   outputs = [

   _50

   Output(display_name="Analysis Result", name="output", method="analyze_text"),

   _50

   ]

   _50

   _50

   def analyze_text(self) -> Data:

   _50

   text = self.input_text

   _50

   _50

   # Perform text analysis

   _50

   word_count = len(text.split())

   _50

   char_count = len(text)

   _50

   sentence_count = len(re.findall(r'\w+[.!?]', text))

   _50

   _50

   # Transform text

   _50

   reversed_text = text[::-1]

   _50

   uppercase_text = text.upper()

   _50

   _50

   analysis_result = {

   _50

   "original_text": text,

   _50

   "word_count": word_count,

   _50

   "character_count": char_count,

   _50

   "sentence_count": sentence_count,

   _50

   "reversed_text": reversed_text,

   _50

   "uppercase_text": uppercase_text

   _50

   }

   _50

   _50

   data = Data(value=analysis_result)

   _50

   self.status = data

   _50

   return data

   
   

3. Enable Tool Mode in the custom component.

4. Connect the custom component's tool output to the Agent component's Tools input.

5. Open the Playground and instruct the agent, Use the text analyzer on this text: "Agents really are thinking machines!"

   Based on your instruction, the agent should call the analyze_text action and return the result. For example:

   
   

   _10

   gpt-4o

   _10

   Finished

   _10

   0.6s

   _10

   Here is the analysis of the text "Agents really are thinking machines!":

   _10

   Original Text: Agents really are thinking machines!

   _10

   Word Count: 5

   _10

   Character Count: 36

   _10

   Sentence Count: 1

   _10

   Reversed Text: !senihcam gnikniht era yllaer stnegA

   _10

   Uppercase Text: AGENTS REALLY ARE THINKING MACHINES!

   
   

Make any component a tool

If the component you want to use as a tool doesn't have a Tool Mode button, add tool_mode=True to one of the component's inputs, and connect the new Toolset output to the agent's Tools input.

Langflow supports Tool Mode for the following data types:

• DataInput
• DataFrameInput
• PromptInput
• MessageTextInput
• MultilineInput
• DropdownInput

For example, the example code in Use custom components as tools included tool_mode=True to the MessageTextInput input so the custom component could be used as a tool:

_10

inputs = [

_10

MessageTextInput(

_10

name="input_text",

_10

display_name="Input Text",

_10

info="Enter text to analyze",

_10

value="Hello, World!",

_10

tool_mode=True,

_10

),

_10

]

Use flows as tools

An agent can use your other flows as tools with the Run Flow component.

1. Add a Run Flow component to your flow.
2. Select the flow you want the agent to use as a tool.
3. Enable Tool Mode. The selected flow becomes an action in the Run Flow component.
4. Connect the Run Flow component's Tool output to the Agent component's Tools input.
5. Open the Playground, and then ask the agent, What tools are you using to answer my questions? Your flow should be visible in the response as an available tool.
6. Ask the agent a question that specifically uses the connected flow as a tool. The connected flow returns an answer based on your question.

See also

• Agent and MCP Tools components
• Use Langflow agents
• Use Langflow as an MCP client
• Use Langflow as an MCP server