Agent Prompt

The system prompt is the most important configuration for your agent. It defines how the agent thinks, what it knows, what it avoids, and how it responds to users.

The agent_prompt Field

Set the agent's system prompt using the agent_prompt field in the update-agent endpoint. Use the Authorization: Token prefix for API keys.

cURL
 
curl -X PUT https://backend.vozzo.ai/agent/update-agent/{agent_uuid}/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_prompt": "You are a helpful customer support agent for Acme Corp. Your job is to resolve billing, shipping, and product issues. Always be concise, empathetic, and professional. Never discuss competitor products."
  }'

Prompt Best Practices

AI Auto-Edit Prompt

Let Vozzo's AI suggest improvements to your prompt based on your feedback. Note the use of issue_description in the request body.

cURL
 
curl -X POST https://backend.vozzo.ai/agent/auto-edit-prompt/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_uuid": "{agent_uuid}",
    "issue_description": "The agent sounds too robotic. Make it warmer and more conversational."
  }'

Sub-Prompts & Snippets

Sub-prompts are reusable prompt snippets that get appended to the main prompt.

cURL
 
curl -X PUT https://backend.vozzo.ai/agent/update-agent/{agent_uuid}/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sub_prompt_data": [3, 7, 12]
  }'

Prompt History

Every update creates a new version. Retrieve history to track changes or audit outputs.

cURL
 
curl -X GET "https://backend.vozzo.ai/agent/get-prompt-history/{agent_uuid}?page=1&size=10" \
  -H "Authorization: Token YOUR_API_KEY"

Prompt Fields Reference