Mark chat for Optimizely CMS 12
12 min
Prerequisites
- You must have Optimizely Content Management System (CMS 12) hosted in Optimizely Digital Experience Platform (DXP).
- Your CMS 12 instance must be enabled for Opti ID.
- You must have Optimizely Agent Platform provisioned at the organizational level. Contact your customer success manager (CSM).
- You must allow third-party cookies.
- Install Mark chat from NuGet. See Install CMS appsInstall CMS apps and Install Optimizely OpalInstall Optimizely Opal.
Mark chat user interface
Note
See AI in Optimizely Experimentation: Meet your infinite workforce for a step-by-step walkthrough of Mark chat with example prompts.
How Opal Chat displays varies by entry point and conversation state. The following screenshots provide a general reference for typical layouts.
Through the Opal website
When accessing through the Opal website, opal.optimizely.com, Opal displays similar to the following:
- Search Opal Chat history – Search one or more Optimizely Opal chats.
- New Chat – Start a new chat. Start a new chat when switching topics to keep Optimizely Opal's responses and chat thread history focused.
- More options – Click Bulk Select to choose multiple chat threads, then click Delete.
- Show or hide Chat history – Toggle the Chat history panel to show or hide.
- Set Product Instance – Select the Optimizely instance that Opal should refer to.
- Chat history – Go to previous chat threads with Optimizely Opal.
- Chat thread options – Additional options to update your chat threads, including the option to copy the chat, copy the chat ID, pin the chat to top of the sidebar, rename the thread, and delete the chat thread. You cannot retrieve deleted chats.
- Regenerate – Have Optimizely Opal respond differently to the same query.
- Create skills – Create an organization or personal skill based on your conversation with Opal.
- Copy – Copy Opal's response to your clipboard.
- Give feedback on a response – Click Thumbs up if Opal's response helped. Click Thumbs down if it did not help.
- Chat with Opal
- Ideate and prompt – Ask Optimizely Opal to research, brainstorm, create things, provide a summary, and so on. Opal can explain terms, walk you through configuration steps, or point you to relevant documentation. It can evolve a rough idea into something more complete, such as expanding a hypothesis or completing a concept.
- Translate content or tone – Translate text into other languages or rewrite content to fit a specific tone or audience.
- Research online – Ask Opal to search the web, summarize content, or extract key information from provided URLs.
- Sample queries
- Summarize this document into key takeaways.
- Extract the details from this timeline and present them to me as a list.
- Give me the audio text and timestamps from this file so I can copy and paste into a subtitle .mov file. Remove any "ums" and "ahs" from the text.
- Develop a test plan for a web experiment comparing two different call-to-action button designs to determine which drives more user engagement.
- Using Optimizely Feature Experimentation, set up a feature flag for the new checkout process and outline a strategy for its gradual rollout and A/B testing.
- How should we personalize content for anonymous users versus logged-in users?
- Extract the key points from this video and create a blog post to promote them.
- Undo – Press Ctrl+Z (Windows) or Cmd+Z (Mac) to undo text typed or pasted in the chat input.
- Add – Upload files and ask questions about their content, or add connectors. See Supported file types in Optimizely Opal and Connector tools overview.
- Mention Agent – Select an agent to run.
- Use skill – Select skills to use. Enter / and select the skill.
- Response speed – Select the speed Opal takes for its response. See Chat modes in Opal chat.
- Submit – Submit a request to Optimizely Opal. Click Stop at any time to end Opal's execution. See Stop a response.
Messages sent while Opal is responding display as queued cards and send automatically when the current response completes. See Queue messages while Opal works.
In an Optimizely product
When accessing Opal through an Optimizely product by clicking a button, such as Ask Opal, Opal displays similar to the following:
- Search Opal Chat history – Search one or more Optimizely Opal chats.
- New Chat – Start a new chat thread. You should start a new chat when switching topics to keep Optimizely Opal's responses focused and your chat thread history focused on the topic.
- More options – Click Bulk Select to choose multiple chat threads, then click Delete.
- Toggle sidebar – Show or hide the chat history sidebar.
- Fullscreen – Expand the Opal Chat window to take up your entire browser window.
- Dock to the side – Dock the Opal Chat as a panel to the side of your browser window. The icon updates to Pop it out
when docked.
- Close – Close the Opal chat window.
- Chat history – Go to previous chat threads with Optimizely Opal.
- Chat thread options – Additional options to update your chat threads, including the option to copy the chat, copy the chat ID, pin the chat to top of the sidebar, rename the thread, and delete the chat thread. You cannot retrieve deleted chats.
- Add – Upload files and ask questions about their content, or add connectors. See Supported file types in Optimizely Opal and Connector tools overview.
- Mention Agent – Select an agent to run.
- Use skill – Select skills to use. Enter / and select the skill.
- Response speed – Select the speed Opal takes for its response. See Chat modes in Opal chat.
- Submit – Submit a request to Optimizely Opal. Click Stop at any time to end Opal's execution. See Stop a response.
Messages sent while Opal is responding display as queued cards and send automatically when the current response completes. See Queue messages while Opal works.
Mark chat capabilities
- Hyper-relevant assistance – Ask questions about the page you are on.
- Actionable insights – Mark analyzes your content in real time and provides specific, contextual feedback. You save time because you do not need to explain your current task or provide background information.
Prompt engineering for Optimizely Opal Chat
Make the most of Optimizely Opal by communicating your requests clearly and effectively. Prompt engineering involves crafting precise prompts to get the best results. You can boost Optimizely Opal's ability to support your marketing and product development work with a few simple principles.
Key principles of effective prompting
- Clarity and specificity – Just like giving instructions to a human assistant, clarity and specificity are crucial for Opal Chat. Avoid vague or ambiguous language. The more precise you are with your request, the more accurate and relevant Optimizely Opal's response is.
- Instead of – Tell me about marketing.
- Try – Generate a list of content marketing strategies for ecommerce businesses targeting Gen Z.
- Context and background – Provide relevant context and background information to help Optimizely Opal understand your request better. This can include details about your target audience, campaign objectives, brand guidelines, or specific Optimizely functionalities you want to utilize.
- Instead of – Create a campaign brief.
- Try – Create a campaign brief for a new product launch targeting millennials, with a budget of $10,000, focusing on social media channels, and aligning with our brand's sustainability values.
- Desired output format – Specify the desired format for Optimizely Opal's response, such as a list, a paragraph, a table, or code. This information helps Optimizely Opal structure its output in a manner that is useful to you.
- Instead of – Analyze our A/B test results.
- Try – Analyze the A/B test results for the homepage banner, comparing variations A and B, and provide a table summarizing the click-through rate, conversion rate, and statistical significance for each variation.
- Iterative refinement – Do not expect the perfect response on the first try. Prompt engineering is an iterative process. Start with a general prompt, then refine it based on Optimizely Opal's initial response. Experiment with different phrasings, keywords, and levels of detail to fine-tune the output.
- Examples and demonstrations – Provide examples or demonstrations of the desired output to improve Optimizely Opal's understanding. You can refer to past campaigns, content pieces, or reports as templates for Optimizely Opal.
- Instead of – Write a blog post about A/B testing.
- Try – Write a blog post about A/B testing, similar in style and tone to the example provided in this link: [link to example blog post]. Focus on the benefits of A/B testing for Optimizely Experimentation users.
Tips for effective prompting
- Be clear and specific in your requests.
- Provide context and background information.
- Use examples to illustrate the desired output.
- Break down complex tasks into smaller, more manageable steps.
Example prompts for CMS 12
- "Generate a draft blog post about the benefits of headless CMS for e-commerce, targeting a technical audience."
- "Analyze the SEO performance of the 'About Us' page (provide URL) and suggest improvements for meta title, description, and keywords."
- "Create a new content type for 'Event Listings' in CMS 12. Include fields for event name, date, time, location, description, and a link to register."
- "Suggest 3 variations for a call-to-action button on a product detail page, aiming to increase click-through rates. The current text is 'Add to Cart'."
- "I need to update the 'Terms and Conditions' page. Can you help me rephrase this paragraph to be more concise and user-friendly? (provide paragraph text)."
- "What are the best practices for structuring content types in CMS 12 for multi-language support?"
- "Generate a short social media post (for LinkedIn) announcing a new feature release, based on this press release draft (provide text)."
- "I'm planning a new campaign. Can you suggest some tasks for content creation and approval within CMP, linked to this campaign brief? (provide brief)."
- "Help me write a compelling meta description for this article about sustainable fashion. The target keyword is 'eco-friendly clothing'."
- "Can you give me a summary of the latest updates and new features in Optimizely CMS 12?"
- "I want to create a new property group called 'Marketing Settings' for my content types. What key should I use?"
- "Analyze the content on this landing page (provide URL) and suggest improvements for visual hierarchy and user experience to drive more sign-ups."
Image features in Opal Chat
Use Opal Chat to create original images or make changes to existing ones by sending a request with a prompt and optional settings.
Create images
To generate an image, send Opal a prompt describing what you want to create. Also include the following optional parameters to customize the result:
- Prompt – Description of the image you want to generate. More detail leads to better results.
- Aspect ratio – Shape of the generated image. If not specified, Opal uses 1:1. Example aspect ratios:
- 1:1 (Square) – Good for profile pictures or Instagram posts.
- 4:3 (Standard landscape) – Common for older TVs or digital cameras.
- 16:9 (Widescreen landscape) – Standard for modern TVs, YouTube videos, and presentations.
- 9:16 (Vertical portrait) – Ideal for Instagram Stories, TikTok, and mobile content.
- Number of images – Total number of image variations to generate, up to four. If you do not specify, Opal generates one.
Note
Be as specific as possible in your prompt to get the best results. Include details such as style, lighting, background, or mood.
Example prompt – Using the brand knowledge you have for Optimizely, create three images for a header image for a blog on Optimizely.com about Optimizely Opal?
Click Edit for an image to open Opal's Image editor. Use the image editor to refine the generated image without recreating it. Select an element, draw over an area, or outline a region with a shape to edit the image.
Note
If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See Turn generative AI off across Optimizely applicationsTurn generative AI off across Optimizely applications.