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
Complete agent configuration object Show system_config Properties
Agent name (used to derive agent_key)
Type of agent (e.g., “llm_agent”)
Instructions defining agent behavior
LLM configuration settings Show llm_config Properties
Model to use (e.g., “gpt-4o”)
Response randomness (0.0-1.0)
Connected knowledge bases for retrieval
Available tools (e.g., [“tavily_search”])
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.