Personas

Customize AI behavior by assigning personas to each model. Personas define the perspective, tone, and focus of responses.

Overview

Personas allow you to shape how each AI model responds. Instead of getting generic answers, you can have models respond as a Technical Expert, Business Strategist, Devil's Advocate, or any other perspective you need.

Personas are especially powerful in multi-model patterns like Ensemble, Debate, and Council, where different perspectives can provide richer analysis.

Built-in Personas

General

default

Natural model response with no added flavor

technical_expert

Implementation focus, best practices, technical depth

business_strategist

Market impact, ROI, business implications

devils_advocate

Challenges assumptions, finds weaknesses

optimist

Opportunities, potential, positive outcomes

pragmatist

Real-world constraints, practical considerations

analyst

Data-driven analysis, metrics, evidence

Domain Experts

cto

Technology leadership, architecture decisions

cfo

Financial perspective, cost-benefit analysis

Debate

advocate

Argues in favor (Pro)

critic

Argues against (Con)

impartial_judge

Fair evaluation, declares winner

Red Team

attacker

Find vulnerabilities, exploit weaknesses

defender

Defend and remediate, security hardening

API Usage

Pass personas via the konnect.personas parameter. Each persona config includes a personaId and modelId.

JSON
{
  "model": "konnect-ensemble",
  "messages": [{"role": "user", "content": "Should we migrate to microservices?"}],
  "stream": true,
  "konnect.pattern": "ensemble",
  "konnect.models": ["gpt-4o", "claude-sonnet-4-5-20250929", "gemini-2.0-flash"],
  "konnect.aggregation": "synthesis",
  "konnect.personas": [
    {"personaId": "cto", "modelId": "gpt-4o"},
    {"personaId": "cfo", "modelId": "claude-sonnet-4-5-20250929"},
    {"personaId": "pragmatist", "modelId": "gemini-2.0-flash"}
  ]
}

The konnect.personas parameter is optional. If omitted, models use their default behavior.

Debate Mode Example

In debate mode, personas define the three roles: Pro (advocate), Con (critic), and Judge.

JSON
{
  "model": "konnect-debate",
  "messages": [{"role": "user", "content": "Is remote work better than office work?"}],
  "stream": true,
  "konnect.pattern": "debate",
  "konnect.models": ["gpt-4o", "gemini-2.0-flash", "claude-sonnet-4-5-20250929"],
  "konnect.personas": [
    {"personaId": "advocate", "modelId": "gpt-4o"},
    {"personaId": "critic", "modelId": "gemini-2.0-flash"},
    {"personaId": "impartial_judge", "modelId": "claude-sonnet-4-5-20250929"}
  ]
}

You can use any persona for any role—for example, use technical_expert as Pro and business_strategist as Con for a tech vs. business debate.

Council Mode Example

Council mode shines with diverse personas representing different expertise areas.

JSON
{
  "model": "konnect-council",
  "messages": [{"role": "user", "content": "Should we build or buy our analytics platform?"}],
  "stream": true,
  "konnect.pattern": "council",
  "konnect.models": ["gpt-4o", "claude-sonnet-4-5-20250929", "gemini-2.0-flash"],
  "konnect.personas": [
    {"personaId": "cto", "modelId": "gpt-4o"},
    {"personaId": "cfo", "modelId": "claude-sonnet-4-5-20250929"},
    {"personaId": "analyst", "modelId": "gemini-2.0-flash"}
  ]
}

Custom Personas

Pro and Power tier users can create custom personas tailored to their specific needs. Custom personas are managed via the dashboard or Personas API.

POST /api/personas
{
  "id": "security_auditor",
  "name": "Security Auditor",
  "description": "Focus on security vulnerabilities, compliance, and risk assessment",
  "systemPrompt": "You are a security auditor. Analyze all suggestions for security implications, identify potential vulnerabilities, and recommend security best practices."
}

Related