Share Tools Between Agents
By default, each agent has its own set of tools. You can make tools available to all agents in a project by placing them in the shared tools directory.
Prerequisites
- At least two agents in the same project
- Familiarity with the agent tools directory structure
Steps
1. Understand the tool directory layout
Each project has two types of tool directories:
_shared/tools/-- tools in this directory are available to every agent in the project.agents/{agentName}/tools/-- tools in an agent's own directory are available only to that agent.
2. Create or move a tool to the shared directory
To share a tool that currently belongs to a single agent, move it from the agent's tools/ directory to _shared/tools/.
To create a new shared tool from scratch, add it directly to _shared/tools/.
Use the platform's file browser or Xircuits Studio to navigate the agent's directory and move files. You can open Xircuits Studio from the Dashboard or the Xircuits section in the sidebar (see Open Xircuits Studio).
3. Restart your agents
All agents pick up shared tools on their next restart. Navigate to the Agents list and restart each agent that should use the new tool.
Verify
- Open the profile of two different agents and confirm the shared tool appears in each agent's available tools.
- Ask each agent to use the shared tool and confirm it works.
Keep agent-specific tools in the agent's own tools/ directory and only share tools that genuinely need to be used across multiple agents. This keeps each agent's tool set focused and avoids confusion.
Changes to shared tools require an agent restart to take effect. The agents do not hot-reload tools from the shared directory.
The _shared/tools/ directory is specifically for sharing tools between agents. Procedures have a separate shared/ directory (see Add Procedures to an Agent). Both serve the same purpose -- making resources available to all agents in a project -- but they are located in different directories.