Creating Prompts

Learn how to create effective prompts in Converra.

Via Dashboard

1. Go to converra.ai/prompts
2. Click New Prompt
3. Fill in the details:
   • Name: A descriptive name (e.g., "Customer Support Agent")
   • Model: The LLM you'll use (e.g., gpt-4o, claude-3-5-sonnet)
   • Content: Your system prompt
   • Description: What this prompt does (optional)
   • Tags: For organization (optional)

Via MCP (AI Assistant)

Tell your AI assistant:

Create a prompt called "Sales Assistant" for gpt-4o with this content:

You are a helpful sales assistant. Your goal is to understand customer
needs and recommend appropriate products. Be friendly but professional.
Always ask clarifying questions before making recommendations.

Via SDK

import { Converra } from 'converra';

const converra = new Converra({
  apiKey: process.env.CONVERRA_API_KEY
});

const prompt = await converra.prompts.create({
  name: 'Customer Support Agent',
  content: `You are a helpful customer support agent.
Your primary goals are:
1. Resolve issues quickly
2. Be empathetic and understanding
3. Escalate when necessary`,
  llmModel: 'gpt-4o',
  description: 'Main support chatbot',
  tags: ['support', 'production']
});

console.log('Created:', prompt.id);

Via API

curl -X POST https://converra.ai/api/v1/prompts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Customer Support Agent",
    "content": "You are a helpful customer support agent...",
    "llmModel": "gpt-4o"
  }'

Prompt Structure Tips

Be Specific About Role

✓ "You are a customer support agent for an e-commerce company..."
✗ "You are helpful..."

Include Behavioral Guidelines

When handling complaints:
1. Acknowledge the frustration
2. Apologize for the inconvenience
3. Offer a solution
4. Follow up to confirm resolution

Set Boundaries

You should NOT:
- Make promises about refunds without checking policy
- Share internal company information
- Provide legal or medical advice

Add Examples (Few-Shot)

Example interaction:
User: "My order hasn't arrived"
Agent: "I'm sorry to hear that. Let me look into this for you.
Could you please provide your order number?"

Supported Models

Model	Provider	Notes
gpt-4o	OpenAI	Recommended for most use cases
gpt-4	OpenAI	Previous generation
gpt-3.5-turbo	OpenAI	Fast and cost-effective
claude-3-5-sonnet	Anthropic	Excellent reasoning
claude-3-opus	Anthropic	Highest capability
o1	OpenAI	Reasoning model
o3	OpenAI	Advanced reasoning model
gemini-1.5-pro	Google	Long context

Next Steps

• Managing Prompts - Update and organize prompts
• Best Practices - Write better prompts
• Running Optimizations - Improve automatically