Create Agent Endpoint

Create a new AI agent with custom configuration.

This endpoint creates a new agent that can be customized with specific instructions, demonstrations, and model parameters.

Request Body:

• agent_name: Name of the agent (will be normalized to URL-friendly format)
• agent_description: Description of the agent’s purpose
• model: Model ID (base model or organization’s aligned model)
• max_token: Maximum tokens for agent responses
• temperature: Sampling temperature for response generation (0.0-1.0)
• instructions: System prompt/instructions (defaults to “You are a helpful AI assistant.”)
• demonstrations (optional): List of example interactions for few-shot learning

Returns:

• data: Agent data object with the following fields:
  • id: Unique agent identifier
  • name: Normalized agent name (lowercase with underscores)
  • description: Agent description
  • base_model: Model ID used by the agent
  • base_model_name: Human-readable model name
  • created_date: ISO 8601 timestamp of creation
  • status: Agent status (e.g., “Active”)
  • creator: Username/email of the agent creator
  • endpoint: Full API endpoint URL for running the agent
  • usage_count: Initial count (0)
  • last_used: Last usage timestamp (null for new agents)
  • performance_metrics: Performance statistics
  • system_prompt: Agent instructions
  • uncertainty_threshold: Temperature setting for response generation
  • conversation_saving_enabled: Whether conversations are saved

Errors:

• 400: Requested model is not available to the user’s organization
• 401: User is not found or unauthorized

Example Request:

POST /api/v3/agents/create
Headers: {"Authorization": "Bearer <api_key>"}

{
  "agent_name": "Customer Support Bot",
  "agent_description": "Handles customer inquiries with empathy",
  "model": "nugen-flash-instruct",
  "max_token": 2000,
  "temperature": 0.7,
  "instructions": "You are a helpful customer support agent. Be empathetic and solution-oriented.",
  "demonstrations": [
    {
      "input": "How do I reset my password?",
      "output": "I'd be happy to help you reset your password..."
    }
  ]
}

Example Response:

{
  "data": {
    "id": "agent-abc123",
    "name": "customer_support_bot",
    "description": "Handles customer inquiries with empathy",
    "base_model": "nugen-flash-instruct",
    "base_model_name": "Nugen Flash Instruct",
    "created_date": "2024-01-15T10:30:00Z",
    "status": "Active",
    "creator": "user@example.com",
    "endpoint": "https://api.nugen.in/api/v3/agents/run-agents/customer_support_bot/run",
    "usage_count": 0,
    "last_used": null,
    "performance_metrics": {
      "total_requests": 0,
      "average_response_time": 0,
      "success_rate": 0
    },
    "system_prompt": "You are a helpful customer support agent. Be empathetic and solution-oriented.",
    "uncertainty_threshold": 0.7,
    "conversation_saving_enabled": false
  }
}