Skip to content

Manage Tools

⏱ 15 minutes intermediate
πŸ“œCoreOpal

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.

Opal offers three categories of tools:

TypeSourceManagement
System toolsBuilt and maintained by OptimizelyToggle on/off; cannot delete
Connector toolsSystem tools that integrate with third-party servicesToggle on/off; sync from registries
Custom toolsBuilt and maintained by your organizationFull create/edit/delete control

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_campaign tool
  • β€œWhat is the current date?” triggers the get_today tool
  • β€œFind images of product packaging” triggers the search_web tool

If no matching tool exists, Opal asks clarifying questions or indicates the request cannot be fulfilled.

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.

  1. Log into Optimizely at home.optimizely.com
  2. Select your organization
  3. Click Opal
  4. Click Tools

You see two sub-pages: Tools (individual tool management) and Registries (registry-level management).

When toggled on, a tool is available across the platform β€” usable in Opal Chat and by agents. When off, the tool is unavailable everywhere.

  1. Navigate to Tools > Tools
  2. Search by name or description in the search field
  3. (Optional) Filter using the Provider, Active Status, and Enabled in Chat dropdowns
  4. Toggle Active on or off for individual tools

You can also toggle an entire registry on or off, which affects all tools within it.

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.

  1. Navigate to Tools > Tools
  2. Search or filter to find the tool
  3. 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.

Registries group related tools together. Optimizely-managed registries contain system and connector tools. Your organization can have custom registries for tools you build.

Navigate to Tools > Registries to see:

  • Registry names and tool counts
  • Discovery URLs and ownership details
  • Last synchronization dates
  • Available tools within each registry

Optimizely periodically updates connector tools with new capabilities. To pull in new tools:

  1. Navigate to Tools > Registries
  2. Find the registry you want to update
  3. Click Actions (…) > Sync

New tools from the registry become available (but inactive by default) after syncing.

Only custom registries can be deleted. Optimizely-managed registries are protected.

  1. Navigate to Tools > Registries
  2. Click Actions (…) > Delete on the custom registry
  3. Confirm the deletion

Deleting a registry removes all its tools from your Opal instance.

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