RAG for artifacts

  • Updated

Retrieval-Augmented Generation (RAG) for artifacts gives Optimizely Opal access to the content in your canvases. A canvas is an interactive document you view and edit within Opal. See Canvas overview for details. 

When you ask questions in Opal chat, Opal searches your artifacts and uses relevant content as context. Use RAG for artifacts to ground responses in your previous work, uploaded files, or agent outputs. Opal draws from your canvas content rather than general knowledge.

Opal respects artifact permissions during retrieval. Opal includes artifacts shared with you alongside your own.

For an overview of how RAG works across Opal, see Retrieval-Augmented Generation (RAG) overview.

How RAG for artifacts helps you

RAG for artifacts lets you and your team do the following:

  • Find information across past work – Search agent outputs, uploaded files, and stored content without leaving chat.
  • Build on previous results – Reference outputs from earlier workflow runs when starting a follow-up task.
  • Ground responses in your content – Opal draws from your actual artifacts rather than general knowledge alone.

Verify RAG for artifacts is active

Optimizely automatically provisions RAG for artifacts for eligible Opal instances. Administrators do not need to take action.

Confirm RAG for artifacts is active for your instance:

  1. Go to Settings > RAG Configuration.

  2. Verify that your Opal Artifacts instance displays Active on the Configurations tab.

    Screenshot of the RAG Configuration page where the Opal Artifacts instance shows Active status on the Configurations tab

The Backpop Jobs tab displays the status of indexing jobs that make your existing artifacts available for retrieval.

Use RAG for artifacts

Opal searches your canvases automatically when you ask a question in chat. Ask questions without any special syntax.

In Opal chat

Ask your question in Opal chat. Opal searches your canvases and includes relevant artifacts as context. When Opal references an artifact, the response includes the artifact name and the space it came from. This lets you locate the source directly on the Artifacts page.

In a specialized agent

Use the {retrieval:} and {retrieval+:} directives in your prompt template to retrieve artifact content during a specialized agent run. See Prompt details for specialized agents.

RAG limitations

The following limitations apply to RAG for artifacts:

  • Optimizely supports one RAG for artifacts instance per Opal instance.
  • Opal retrieves artifact titles, summaries, and similarity scores. To read the full content of a retrieved artifact, open it from the Artifacts page.
  • Retrieved artifacts reflect the state of your canvases at the time of the last index. Content added after the most recent index is not available for retrieval until the next index runs.
  • Optimizely does not guarantee retrieved artifact content is current or accurate. Treat it as background context and verify against the source artifact before acting on it.

Supported artifact types

RAG for artifacts indexes the following content from your canvases:

  • Opal chat outputs saved to a canvas.
  • Files you uploaded to canvas.
  • Output from workflow and specialized agent executions.
  • Stored memory artifacts.
  • Artifacts that other users shared with you.