Tools for instruction agents

  • Updated

Tools are built-in capabilities that extend what Optimizely Opal can do. They help Opal complete specific steps within instruction agents, especially for complex or multi-step tasks. Think of tools as attachments on a Swiss Army knife. Each one performs a unique function, like analyzing a webpage or drafting campaign content. Used together in an instruction agent, these tools enable Opal to complete end-to-end workflows efficiently and accurately.

You can assign one or more tools to an instruction agent based on the steps it needs to perform. To see which tools a specific instruction agent uses, see the agent's Details section.

The following is the full list of tools available:

Content creation and management

  • createArticleInTask – Creates articles within specific tasks, requiring information like title, body, and metadata.
  • updateContentInTask – Modifies existing content in a task, including text, rich text, and library assets (images, videos).

Campaign and task management

  • createCampaign – Creates new campaigns with briefs, titles, and optional parent campaign linking.
  • createTasks – Generates task suggestions for a given campaign.
  • updateCampaignBrief – Updates existing campaign briefs.
  • updateTaskBrief – Updates existing task briefs.
  • createTaskForODPSegmentation – Generates customer segments for targeted campaigns.

Web interaction and research

  • browseWebUrls – Visits and extracts information from live web pages directly through chat. Helps you retrieve content, analyze data, or summarize key details from a specific URL. 
  • searchWeb – Searches any publicly accessible web page and returns information, images, and other resources at the time of the request.
  • takeWebpageScreenshot – Captures visual snapshots of online content to support tasks with clear visual insights. You can ask Optimizely Opal Chat to take a screenshot of any live, public webpage. The tool works best with stable, non-password-protected URLs.
  • answerQuestionsAboutImages – Analyzes images and answers questions about their content. Opal can analyze images with the following extensions: .png, .jpeg, .webp.

Optimizely specific tools

  • getInformationOnOptimizelyProductsBasedOnUserQuery – Retrieves information about Optimizely products and features.

Experimentation

  • suggestFlagVariables – Suggests relevant variables for feature flagging based on the hypothesis and project details.
  • suggestFlagVariableVariations – Suggests variations for feature flag experiments.

CMP data access

  • accessCMPData – Connects directly to a CMP instance to fetch details about assets, tasks, and campaigns, enabling you to understand your current context and offer more relevant, personalized help.

Other utilities

  • figureOutSearchKeywords – Refines search queries for better results.
  • reasoningStep – Documents internal thought processes for complex tasks.
Some tools, like reasoningStep, are used internally by Opal to improve logic and task completion. You do not need to configure or invoke these directly.