Create Agent

Overview

Create a new AI agent with custom configuration. Agents can be set up as chatbots or assistants with tailored prompts, models, and appearance settings.

Request

Validations

Error Responses

400

{
    "error": {
        "code": "name_required",
        "message": "The name field is required.",
        "status": 400
    }
}

403

{
    "error": {
        "code": "invalid_api_key",
        "message": "The provided API key is invalid or has been revoked.",
        "status": 403
    }
}

400

{
    "error": {
        "code": "agent_limit_reached",
        "message": "Agent limit reached. Upgrade your plan or add seats.",
        "status": 400
    }
}

Best Practices

• System prompts: Be specific and concise. A well-scoped system prompt produces more consistent agent behavior.
• Temperature: Use 0.1–0.3 for factual/support agents, 0.7–1.0 for creative tasks.
• Required fields first: Always include name and agent_category — omitting any returns a 400 error.
• Retrain after adding knowledge: Creating an agent does not trigger training. Add knowledge sources and call Train Agent to activate them.