7en.ai

Navigation

agent

Agent ObjectCreate AgentUpdate AgentDelete AgentList All Agents

api reference

IntroductionError handling

agent

Agent ObjectCreate AgentUpdate AgentDelete AgentList All Agents

api reference

IntroductionError handling
Home / API / Create Agent

Create a new AI agent with custom configuration and knowledge sources. Agents can be configured with different models, prompts, and knowledge bases to handle specific use cases.

Overview

The Create Agent endpoint allows you to set up a new AI agent tailored to your specific needs. You can configure the agent's behavior, knowledge sources, and response characteristics to optimize performance for your use case.

Parameters

Request Body

name

string

Name of the agent. Example: "Innovated Agent"

description

string

Description of the agent's purpose. Example: "A new AI agent ready to be configured."

Request Header

Authorization

api key

Api key generation from 7en.i platform. eg. Api-Key 43NKLN3LKN4nlkn

Error Responses

json
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters",
"details": [
{
"field": "system_prompt",
"message": "System prompt is required"
}
]
}
}

401 Unauthorized

json
{
error: {
code: "authentication_required",
message: "Authentication fialed.",
status: 401,
fields: {
[]
}
}
}

Best Practices

  • System Prompts: Be specific and clear in your system prompts to get consistent behavior
  • Temperature: Use lower values (0.1-0.3) for factual responses, higher values (0.7-1.0) for creative tasks
  • Knowledge Sources: Ensure your knowledge sources are up-to-date and relevant to the agent's purpose
  • Testing: Test your agent thoroughly before deploying to production

Rate Limits

  • 100 requests per minute for free tier
  • 1000 requests per minute for pro tier
  • 10000 requests per minute for enterprise tier

Ready to transform your business?

Start building intelligent AI agents to engage with customers.

← Agent Object
Update Agent →
POST/v1/agents/

Request

curl -X POST 'https://{% api.7en.ai %}v1/agents/' -H 'Authorization: {% Api-Key YOUR_API_KEY %}'\ -H 'Content-Type: application/json'\ -d '{"name": "Updated Agent", "description": "An updated AI assistant", "systemPrompt": "You are an updated AI assistant. Provide concise and accurate responses."}'

Response Example

{
"status": "success",
"data": {
"id": 169,
"owner": 21,
"name": "Innovated Agent",
"description": "A new AI agent ready to be configured.",
"status": "Active",
"appearance": {
"avatar": {
"src": "",
"type": "default"
},
"position": "bottom-right",
"buttonText": "",
"fontFamily": "Inter",
"chatbotName": "Innovated Assistant",
"primaryColor": "#3b82f6",
"secondaryColor": "#ffffff",
"welcomeMessage": ""
},
"behavior": {
"guidelines": {
"dos": [],
"donts": []
},
"suggestions": [],
"showOnMobile": true,
"aiToAiHandoff": false,
"autoShowAfter": 30,
"expertHandoff": true,
"collectVisitorData": true,
"continuousLearning": false,
"conversationMemory": false,
"multilingualSupport": false
},
"knowledge_sources": [],
"model": {
"temperature": 0.7,
"token_length": 16000,
"response_model": "gpt-3.5-turbo"
},
"agentType": "general_assistant",
"systemPrompt": "You are a helpful AI assistant. Be friendly, professional, and provide accurate information.",
"created_at": "2025-08-04T11:18:38.934851Z",
"updated_at": "2025-08-05T07:38:35.903607Z"
}
}