nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

Filtering in Rovo agents

Serhii Horobets

Hello!

I need to restrict my Rovo agent to deal with only a subset of pages in my Confluence Cloud site—specifically, pages that have specific labels or labels with a certain prefix.

I haven't been able to achieve the desired results by playing with the agent's instructions. The agent always simulated filtering but didn't do so as I expected (I expected direct calls to the Confluence API). So, it showed me pages that didn't fulfill the criteria.

So, as a first step to solve my task, I'd like to just filter pages that are returned in the agent's response by simple criteria (preferably using CQL), such as "label='information-system'".

I know that Rovo agents use plugins to fetch data. According to the article "https://support.atlassian.com/rovo/docs/knowledge-sources-for-agents", the "Page search" and "Search QA" plugins are used for searching in Confluence sites.

This article "https://www.atlassian.com/blog/atlassian-engineering/hybrid-llm" reveals that the "Page search" plugin can query using CQL (in the article, it's called "Page-Search-Plugin").

So, is it possible to instruct a Rovo agent to filter Confluence pages by some CQL criteria using the "Page search" plugin? Or maybe there are other ideas on how to reliably filter Confluence pages while communicating with Rovo agents?

Accepted answers

Tomislav Tobijas

Interesting question @Serhii Horobets 👀

I haven't used Rovo 'that deep' so can't say for sure but it might be possible. I'll just move this to Rovo product/app group for the product team and experts from that area can chime in.

Cheers,
Tobi

All comments

Tomislav Tobijas

Interesting question @Serhii Horobets 👀

I haven't used Rovo 'that deep' so can't say for sure but it might be possible. I'll just move this to Rovo product/app group for the product team and experts from that area can chime in.

Cheers,
Tobi

Serhii Horobets

@Tomislav Tobijas , thank you! Will wait for any advice

Dr Valeri Colon (Connect Centric)

Thanks for jumping in on this @Tomislav Tobijas glad to have you here. @Serhii Horobets Rovo agents don’t currently support direct CQL filtering via the "Page search" plugin in custom instructions. While the plugin uses CQL internally, agent prompts can’t enforce CQL queries. For now, you can guide agents using clear instruction patterns (e.g., “Only use pages labeled ‘X’”), but filtering may not be strict. Fine-grained filtering is a requested feature and not fully supported yet, but consider giving it an upvote.

Serhii Horobets

>> For now, you can guide agents using clear instruction patterns (e.g., “Only use pages labeled ‘X’”),

As I can assume, agents have access to both pages content and metadata, but don't distinguish them. What is the best way to tell the agent, that when I say "label" or "labeleing", it should be looking for labels in the page's metadata? Maybe there are specific words or phrases? Everything I came up with didn't work in an acceptable way.

Welcome!

It looks like you're new here. Sign in or register to get started.

Quick Links

Find more posts tagged with

confluence

cloud

confluence-cloud

agent

rovo-atlassian-intelligence

rovo