This topic explains how to manage and use tools in AgentControl. Tools are reusable, versioned definitions that let configs trigger actions you define in code. Tools allow large language models (LLMs) to retrieve data or take actions on a user’s behalf. You can customize tools with parameters that define more information for the tool to use. For example, if a tool represents an MCP server, you could include connection information in a custom parameter.
You can attach tools to variations in both completion mode and agent mode. Tools can retrieve data, call external APIs, or support multi-step workflows.
Giving your agents access to tools gives them the ability to call them as instructed or needed. Tool invocation depends on your application and SDK implementation, not on the config mode. All configs share the same tool library, so you can define a tool once and reuse it across multiple configurations.
Tools are in the library’s Tools tab, which provides a central location to maintain consistency across projects.
Using tools in AgentControl offers organizational and technical advantages that support consistent, auditable workflows.
With tools, you can:
After you create a tool, you attach the tool to a config variation, including an agent mode config variation. Like judges, tools do not work independently of configs. You must attach a tool to a variation for it to function.
After you deploy the variation, attached tools are available for the LLM to invoke. You can use tools as a registry to map a given tool to where it’s invoked in your application, or, depending on which provider you use, provide schemas and pass them directly to the invocation.
You cannot attach a tool to a custom judge. To learn more, read Judges.
Tools are in their own tab in the Library.
From the Tools tab, you can browse existing tools or create a new one.
To create a new tool:
In the left navigation, click Agents. The AgentControl menu appears.
Click Library.
Select the Tools tab.
Click Create tool. The Tool page appears.
Enter a Key for the tool. Keys must be alphanumeric and can include underscores and hyphens.
Enter a Description for the tool.
Define the tool Schema, or leave it at its default value.
Specify any custom parameters.
Click Save.
When editing a config variation, you can attach or detach tools, change tool versions, create new tools inline, and explore the tools library.
To manage tools in a variation:
If your variation defines a tools field inside a model or custom parameter, LaunchDarkly treats it as a legacy tools configuration and displays the following banner:
This means:
If you attach tools using the tools library:
tools field in parameterstools fieldThis message does not indicate an error. It helps you understand that switching to the tools library replaces the existing parameter-based configuration.