A collection is a library of prompts used as input for Cannon test runs. You build a collection of the inputs you want to test, then send it through a profile to see how the guardrails respond across all of them. Collections are managed on two surfaces: the collections list, where you find and create collections, and the collection detail page, where you work with one collection's prompts.

Collections List

The collections list displays a searchable grid of collection cards. Each card shows the collection name, the number of prompts it contains, the date it was last fired, and its creator. Use the search field to find a collection by name. Clicking a card opens that collection's detail page.

Collection Detail Page

The detail page displays the collection name, an optional description, and the list of prompts in the collection. A prompt input bar at the bottom of the page lets you add prompts to the collection one at a time.

Prompts are sent to the analysis engine exactly as written. All prompt text is treated as plain text, so any formatting or placeholder syntax, such as double curly braces like {{Order Number}}, is sent as written rather than substituted or interpreted.

Toolbar

The toolbar holds the controls for working with the collection.

• CSV uploaded: Opens the CSV upload area, where you can add prompts by file and see the collection's upload history.
• View log history: Opens the Runs page filtered to this collection, showing the past Cannon runs of its prompts.
• Send to Cannon: Starts a Cannon run on the collection directly, without going to the Runs page first.
• Go to Monitoring: Opens the Results page filtered to this collection, where you can review the events from runs of the collection.
• Overflow menu: (1) Add from CSV, which uploads prompts from a CSV file; (2) Select prompts, which lets you choose prompts to delete; (3) Delete collection, which removes the collection.

Adding Prompts by CSV

A new collection with no prompts displays a CSV drop zone in place of the prompt list. On a collection that already has prompts, you can open the same drop zone at any time with the CSV uploaded button in the toolbar. Add prompts by dragging a CSV file onto the drop zone or clicking Browse your PC to select one.

Each upload is recorded in the Upload History section, which shows the status, prompt count, and start and finish times for each file added to the collection.

CSV files with more than 25,000 rows may time out. If an upload of a large file does not succeed, split it into smaller parts and try again.