Creating Your First Persona

{
  "name": "Customer Support Agent",
  "description": "Handles customer inquiries professionally and efficiently",
  "type": "CUSTOMER_SERVICE",
  "systemPrompt": "You are a helpful customer support agent..."
}

curl -X POST "https://aipersona.dsethiopia.org/api/trpc/persona.create" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -H "X-Organization-ID: your-org-id" \
  -d '{
    "json": {
      "name": "Claude-powered Assistant",
      "llmProvider": "ANTHROPIC",
      "model": "claude-3-sonnet-20240229",
      "systemPrompt": "You are a helpful assistant...",
      "temperature": 0.7,
      "maxTokens": 2000
    }
  }'

You are [role/identity] for [company/context]. Your primary goal is [main objective].

## Your Role
- [Core responsibility 1]
- [Core responsibility 2]
- [Core responsibility 3]

## Personality
- [Personality trait 1]
- [Personality trait 2]
- Communication style: [formal/casual/professional]

## Guidelines
- Always [important behavior]
- When uncertain, [fallback behavior]
- If asked about [topic], respond with [specific approach]

## Constraints
- Never [prohibited action]
- Do not [limitation]
- Always verify [important check]

{
  "systemPromptStructured": {
    "role": "You are a research assistant with expertise in data analysis and academic research. You have deep knowledge of research methodologies and citation practices.",
    "task": "Help users find, analyze, and synthesize information from various sources. Assist with literature reviews, data interpretation, and research methodology questions.",
    "context": "Users are researchers, students, and academics who need accurate, well-sourced information. They value thoroughness and proper attribution.",
    "reasoning": "Always verify information from multiple sources. Think critically about data quality and methodology. Consider potential biases and limitations in research.",
    "output": "Provide structured, well-organized responses with proper citations when referencing sources. Use bullet points for lists and clear headings for longer responses.",
    "stopping": "Conclude when the research question is fully addressed. If a question requires specialized expertise you don't have, recommend consulting domain experts."
  }
}

curl -X POST "https://aipersona.dsethiopia.org/api/trpc/persona.create" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -H "X-Organization-ID: your-org-id" \
  -d '{
    "json": {
      "name": "Research Assistant",
      "systemPrompt": "You are a research assistant...",
      "enabledTools": ["web_search", "calculator", "pdf_processor"],
      "useAgent": true
    }
  }'

const fs = require('fs');

// Read file and convert to base64
const fileBuffer = fs.readFileSync('product-manual.pdf');
const base64Content = fileBuffer.toString('base64');

// Upload to persona's knowledge base
const response = await fetch('https://aipersona.dsethiopia.org/api/trpc/persona.uploadDocuments', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': process.env.AIPERSONA_API_KEY,
    'X-Organization-ID': process.env.AIPERSONA_ORG_ID,
  },
  body: JSON.stringify({
    json: {
      personaId: 'clx1abc123xyz789',
      files: [{
        filename: 'product-manual.pdf',
        mimetype: 'application/pdf',
        encoding: 'base64',
        data: base64Content
      }]
    }
  })
});

{
  "embeddingModel": "text-embedding-3-small",
  "vectorDbProvider": "weaviate"
}

# 1. Create a chat session
curl -X POST "https://aipersona.dsethiopia.org/api/trpc/chat.createSession" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -H "X-Organization-ID: your-org-id" \
  -d '{"json": {"personaId": "clx1abc123xyz789", "title": "Test Session"}}'

# 2. Send test messages
curl -X POST "https://aipersona.dsethiopia.org/api/trpc/chat.sendMessage" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -H "X-Organization-ID: your-org-id" \
  -d '{"json": {"chatSessionId": "session_xyz", "content": "Hello! Can you help me?", "role": "USER"}}'