Skip to content
Help Center
Browse documentation

Edit the knowledge base and improve it with AI

Fix what the agent got wrong or add what it missed. Edit pages, flows and entities by hand, or describe the change and let AI refine one item for you.

Updated 3 min read
In this article

The agent can misread a page or miss a journey. You can correct the knowledge base directly. Your changes are used the next time you generate test cases.

Before you start

  • Owner, Admin, QA Lead and QA Engineer can add, edit and delete items by hand.
  • Improve with AI is limited to Owner, Admin and QA Lead. A QA Engineer who tries it gets an error.
  • Developer and Viewer roles can only read.
  • Improve with AI is available only once exploration has finished. While the project is Pending or Exploring the sparkle icons and the button are not shown.

Add an item

  1. Open Knowledge and pick a tab: Pages, Flows or Entities.

  2. Click Add page, Add flow or Add entity.

  3. Fill in the form. For a page: Path, Name, Description, Actions and Inputs. Type an action or input and click the + button to add it to the list. For a flow: Name, Description, Expected Outcome and Steps. For an entity: Name, Type and Attributes.

    The page dialog filled in with a path, name, description, one action and one input
    The page dialog filled in

  4. Click Save. A Knowledge updated message appears and the item shows in the list.

Edit or delete an item

  1. Click the pencil icon on the item. Change what you need and click Save.
  2. To remove an item, click the red trash icon and confirm with Delete in the Delete Item dialog. You can't undo it.

Improve an item with AI

Use this when the item is roughly right but needs a better description, more actions, or a missing step, and you would rather explain it than rewrite it.

  1. Click the sparkle icon on the item. The edit dialog opens.

  2. Click Improve with AI.

  3. In Your Feedback, describe the change. For example: "Add a Delete forever action and a note that items are removed after 90 days."

    The Improve with AI box with a feedback message and the current page shown below
    Be specific about what to add or fix

  4. Click Improve with AI again. The dialog closes and a Knowledge refinement started message appears.

  5. Wait about a minute, then reload the page. The item shows the refined details.

The Archive page after AI refinement with the new action and description
The refined item

Note

There is no progress bar. Refinement runs as a background job and it counts as the project's one active job, so you can't start a test run, test generation or an exploration until it ends. If you try, you get "... is already in progress for this project".

Tip

AI may also add or update related items. In our example the number of flows went up by one after refining a page. Check the Flows tab afterwards.

Warning

If you clear the knowledge base or explore again, your edits are not carried over. Exploration replaces the contents. See Re-explore your app after it changes.

Keep reading