Manage Tools
Why tool management matters
Section titled βWhy tool management mattersβTools are how Opal takes action. Each tool performs a specific task β creating a campaign, uploading a file, generating an image, or querying analytics data. When you send a natural language request, Opal analyzes your intent and selects the appropriate tool automatically. You do not call tools directly.
Managing tools ensures your team has access to the capabilities they need while keeping irrelevant or sensitive tools disabled. Each Opal instance supports up to 128 enabled tools, so curation matters.
Tool types
Section titled βTool typesβOpal offers three categories of tools:
| Type | Source | Management |
|---|---|---|
| System tools | Built and maintained by Optimizely | Toggle on/off; cannot delete |
| Connector tools | System tools that integrate with third-party services | Toggle on/off; sync from registries |
| Custom tools | Built and maintained by your organization | Full create/edit/delete control |
How tools work
Section titled βHow tools workβIn Opal Chat
Section titled βIn Opal ChatβUsers never call tools directly. Opal analyzes the natural language request to identify the appropriate tool:
- βCreate a campaign for Q4 marketingβ triggers the
create_campaigntool - βWhat is the current date?β triggers the
get_todaytool - βFind images of product packagingβ triggers the
search_webtool
If no matching tool exists, Opal asks clarifying questions or indicates the request cannot be fulfilled.
In agents
Section titled βIn agentsβSpecialized agents can call specific tools that you assign to them. The agentβs configuration determines which tools it can access, following the principle of least privilege.
Access the tools interface
Section titled βAccess the tools interfaceβ- Log into Optimizely at home.optimizely.com
- Select your organization
- Click Opal
- Click Tools
You see two sub-pages: Tools (individual tool management) and Registries (registry-level management).
Activate or deactivate a tool
Section titled βActivate or deactivate a toolβWhen toggled on, a tool is available across the platform β usable in Opal Chat and by agents. When off, the tool is unavailable everywhere.
- Navigate to Tools > Tools
- Search by name or description in the search field
- (Optional) Filter using the Provider, Active Status, and Enabled in Chat dropdowns
- Toggle Active on or off for individual tools
You can also toggle an entire registry on or off, which affects all tools within it.
Enable or disable tools in Opal Chat
Section titled βEnable or disable tools in Opal ChatβThe βEnabled in Chatβ setting controls whether Opal Chat can select a tool. When off, the tool remains available to agents but not to Chat.
- Navigate to Tools > Tools
- Search or filter to find the tool
- Toggle Enabled in Chat on or off
This is useful when you want agents to use a tool but do not want Chat users triggering it with general requests.
Manage registries
Section titled βManage registriesβRegistries group related tools together. Optimizely-managed registries contain system and connector tools. Your organization can have custom registries for tools you build.
View registry details
Section titled βView registry detailsβNavigate to Tools > Registries to see:
- Registry names and tool counts
- Discovery URLs and ownership details
- Last synchronization dates
- Available tools within each registry
Sync a registry
Section titled βSync a registryβOptimizely periodically updates connector tools with new capabilities. To pull in new tools:
- Navigate to Tools > Registries
- Find the registry you want to update
- Click Actions (β¦) > Sync
New tools from the registry become available (but inactive by default) after syncing.
Delete a registry
Section titled βDelete a registryβOnly custom registries can be deleted. Optimizely-managed registries are protected.
- Navigate to Tools > Registries
- Click Actions (β¦) > Delete on the custom registry
- Confirm the deletion
Deleting a registry removes all its tools from your Opal instance.
Tools page interface
Section titled βTools page interfaceβThe Tools page provides several features for efficient management:
- Search β Find tools by name or description
- Filter β Narrow results by provider, active status, or chat enablement
- Toggle controls β Individual and registry-level activation switches
- Preview indicators β Beta tools display a preview badge
- Authentication indicators β Tools requiring external authentication show a lock icon