Toolset Management

1. Overview

Toolsets are collections of encapsulated system operation capabilities in FiraClaw. By configuring different toolsets, you can control the system-level tools that agents can use, such as reading and writing files, sending network requests, etc.

2. Toolset Types

FiraClaw provides the following preset toolsets:

• Basic Toolset: Contains the most basic system operation capabilities
• File Toolset: Contains capabilities such as file reading/writing and directory operations
• Network Toolset: Contains capabilities such as network requests and API calls
• System Toolset: Contains capabilities such as system command execution and process management
• Full-Featured Toolset: Contains all system operation capabilities

3. Managing Toolsets

3.1 Viewing Toolsets

1. Click Toolsets in the left menu.
2. In the toolset list, you can see all available toolsets and the tools they contain.

3.2 Creating Custom Toolsets

1. Click the New Toolset button in the upper right corner of the toolset page.
2. Fill in the basic toolset information:
   • Name: Name of the toolset for easy identification
   • Description: Functional description of the toolset
3. Select the tools to include in this toolset:
   • Check the tools to include in the tool list
   • Can filter by tool type
4. Click the Save button to create the toolset.

3.3 Editing Toolsets

1. In the toolset list, find the toolset that needs to be edited.
2. Click the Edit button to modify the toolset configuration.
3. Click the Save button to apply changes.

3.4 Deleting Toolsets

1. In the toolset list, find the toolset that needs to be deleted.
2. Click the Delete button to confirm the deletion.
3. Note: Preset toolsets cannot be deleted.

4. Assigning Toolsets to Agents

1. Go to the Agent configuration page.
2. Select the agent that needs configuration and click the Edit button.
3. In the Capabilities Extension tab, select the toolset to assign to that agent.
4. Click the Save button to complete configuration.

5. Toolset Permission Control

5.1 Permission Levels

• Unrestricted: Agent can use all tools in the toolset
• Read-only: Agent can only read data, cannot modify data
• Restricted: Agent can only use partial tool functions

5.2 Permission Settings

1. On the agent edit page, click the Toolset Permissions option.
2. Set the permission level for each toolset.
3. Click the Save button to apply permission settings.

6. Security Notes

• Least Privilege: When assigning toolsets to agents, the principle of least privilege should be followed, granting only necessary permissions
• Risk Assessment: Evaluate possible security risks before assigning system toolsets to agents
• Regular Review: Regularly review agent toolset configuration to ensure permission settings are reasonable

7. FAQ

Q1: If an agent does not specify a toolset, what toolset will it use by default?

A: If an agent does not specify a toolset, all tool permissions are open by default.

Q2: Can I assign multiple toolsets to one agent?

A: Yes, you can assign multiple toolsets to one agent. The agent will have the combined permissions of all assigned toolsets.

Q3: How to view the tool permissions an agent currently has?

A: On the agent details page, you can view the agent's toolset configuration and permission settings.

Q4: Will modifying toolset configuration affect tasks currently running?

A: No. Tasks that have been triggered and are currently executing will continue using the toolset configuration snapshot from when the task started. New configurations only apply to dialogues and tasks created after the configuration modification.