Organize Prompts

Organize using folders

All Prompts can be grouped under folders that map to your applications, projects or teams. This way, even with a large number of single Prompts, finding and iterating on Prompts is easy for any team member who joins your Maxim organization.

Create a new folder by clicking on the + icon on the Prompts sidebar. Give it a name. Start adding new Prompts to it via drag and drop or select the folder when creating a new Prompt.

Tag prompts

Tags act as custom metadata that can be used to identify and retrieve Prompts through the Maxim SDK. Add tags to a Prompt via the configuration section on the right side of the Prompt playground. Tags are simple key value pairs that can be defined and edited easily.

Fetch relevant Prompts in your code using the SDK and querying as per tag values as shown below:

import { Maxim, QueryBuilder } from "@maximai/maxim-js";
 
const maxim = new Maxim({
	apiKey: "",
});
 
const prompt = await maxim.getPrompt(
	promptId,
	new QueryBuilder()
		.and()
		.deploymentVar("Environment", "test")
		.tag("CustomerId", 1234)
		.tag("grade", "A")
		.tag("test", true)
		.exactMatch()
		.build(),
);

Prompt versions and sessions

Outside of folders or tags, iterations on your Prompts should also be organized effectively for insights on the impact of your changes. View details on how to version Prompts and use them for testing.