Skip to main content
Create a new agent configuration. All agent configuration must be provided within the system_config object. The name field in the config is required and will be used to derive the agent_key.

Request Body

system_config
object
required
Complete agent configuration object
curl -X POST https://api-be.atthene.com/api/v1/agent/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "system_config": {
      "name": "Support Agent",
      "agent_type": "llm_agent",
      "system_prompt": "You are a helpful customer support agent.",
      "llm_config": {
        "model": "gpt-4o",
        "temperature": 0.7
      }
    }
  }'

Response

Returns the created agent configuration:
{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "agent_key": "support_agent",
  "name": "Support Agent",
  "architecture": "llm_agent",
  "entry_point": "main",
  "is_public": false,
  "is_shared": false,
  "origin_url": null,
  "owner": "user_123",
  "company": "company_456",
  "system_config": {
    "name": "Support Agent",
    "agent_type": "llm_agent",
    "system_prompt": "You are a helpful customer support agent.",
    "llm_config": {
      "model": "gpt-4o",
      "temperature": 0.7,
      "max_tokens": 1000
    },
    "knowledge_bases": [
      {
        "name": "support_docs",
        "knowledge_base_type": "milvus",
        "knowledge_base_id": "kb_123"
      }
    ]
  },
  "version_number": "1.0.0",
  "config_hash": "b2c3d4e5f6a7",
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2025-01-15T10:30:00Z"
}
The agent_key is automatically derived from the agent name and serves as a unique identifier for the agent.