Managing Prompts

Organize, update, and maintain your prompts over time.

Viewing Prompts

Dashboard

Visit converra.ai/prompts to see all your prompts with:

• Status (active, draft, archived)
• Last updated date
• Performance metrics
• Tags

Via MCP

Show me my prompts

List prompts tagged with "production"

Via SDK

const { data: prompts } = await converra.prompts.list();

prompts.forEach(p => {
  console.log(`${p.name} (${p.llmModel}) - ${p.status}`);
});

Updating Prompts

Dashboard

1. Click on a prompt to open it
2. Edit the content
3. Click Save

Previous versions are automatically saved.

Via MCP

Update my support prompt to be more friendly and add a greeting

Via SDK

await converra.prompts.update('prompt_123', {
  content: 'Updated prompt content...',
  description: 'Now with improved greeting'
});

Organizing with Tags

Tags help you filter and organize prompts:

await converra.prompts.update('prompt_123', {
  tags: ['production', 'support', 'v2']
});

Common tag patterns:

• Environment: production, staging, development
• Team: support, sales, marketing
• Version: v1, v2, experimental
• Status: active, deprecated, testing

Prompt Status

Status	Meaning
draft	In development, not used in production
active	Currently in use
deprecated	Scheduled for removal
archived	No longer in use, preserved for reference

Version History

Converra automatically tracks prompt versions:

• Every save creates a new version
• Applied optimization variants create versions
• You can view and compare versions in the dashboard

Duplicating Prompts

To create a copy of an existing prompt:

const original = await converra.prompts.get('prompt_123');

const copy = await converra.prompts.create({
  name: `${original.name} (Copy)`,
  content: original.content,
  llmModel: original.llmModel,
  tags: [...original.tags, 'copy']
});

Deleting Prompts

WARNING

Deleting a prompt is permanent and will affect any applications using it.

await converra.prompts.delete('prompt_123');

Consider archiving instead:

await converra.prompts.update('prompt_123', {
  status: 'archived'
});

Best Practices

1. Use descriptive names - Make it clear what each prompt does
2. Tag consistently - Establish a tagging convention with your team
3. Document changes - Use the description field to note why changes were made
4. Archive, don't delete - Keep history for reference
5. Review regularly - Check prompt performance monthly

Next Steps

• Best Practices - Write better prompts
• Running Optimizations - Improve prompts
• Logging Conversations - Track performance