Testing & Publishing

Test Your Relational Agent

Once saved, click Open in new Tab to try your agent in the standalone Web Client.

Click the arrow next to that button for Copy URL, which copies the full link, and Copy ref, which copies the agent reference on its own.

A QR code is shown alongside the agent. Scanning it opens the agent in the PromethistAI client.

You need the agent’s reference when constructing Web Client URLs manually. Use Copy ref, or read it from the Reference column of the agent list.

Revisions

What are Revisions for?

Every time you save your agent’s configuration, a new revision is created automatically. This gives you a full history of changes — so you can test a new version without touching the live one, roll back if something goes wrong, and always know exactly what your users are experiencing.

Each revision moves through a lifecycle:

  • Draft — work in progress. Only Drafts can be edited.

  • Preview — ready to test. Share the preview URL with your team before going live.

  • Published — the live version your users see. Only one can exist at a time.

  • Archived — retired versions, kept for history.

Revision lifecycle

Revision States

Draft

The initial state when you create an agent. Remains Draft until you move it to Preview.

Only Drafts can be edited. Once a revision moves to Preview, Published, or Archived, its configuration is permanently locked.

When you make changes to a locked revision and save, a new Draft is automatically created. You’re not editing the locked revision, you’re creating a new one based on it.

Preview

Used for testing. Anyone with the preview URL can test the agent, including non-logged users.

Multiple Preview revisions can exist at the same time.

Published

The live, user-facing version. The agent URL (without a specific revision number) always opens the Published revision.

Only one Published revision can exist at a time. When you publish a new revision, the previous Published revision is automatically archived.

Archived

A retired revision that is no longer available to the public.

Which URL opens which revision, and who can use it

A URL without a revision number always opens the agent’s Published revision, for example https://eu.promethist.ai/a/bianka_ma931. Adding a revision number opens that specific revision instead, for example https://eu.promethist.ai/a/antonin_a07fk.6.

A Published link works for anyone.

A Preview link also works for anyone you send it to, even if they have no access to the project. If the project requires people to sign in, they will need to sign in first. This makes Preview the right state for leaving an agent available after a demo.

A Draft or Archived link only opens for people who have a role on the project, so neither is suitable for sharing outside your team.

Reverting to a Previous Version

If you need to restore your agent to an earlier configuration:

  1. Locate the revision you want to restore.

  2. Click the Revert button next to that revision.

Reverting archives all revisions created after the one you’re reverting to.