List Agents

Retrieve all agents owned by the user.

This endpoint returns a comprehensive list of all agents created by the user, including their configuration, usage statistics, and conversation settings.

Query Parameters:

• include_inactive (optional): Set to true to include inactive agents. Default: false

Response includes:

• Usage statistics (total usage count and last used timestamp)
• Conversation saving status based on user settings
• Full endpoint URL for executing the agent

Returns:

• agents: List of agent objects, each containing:
  • id: Unique agent identifier
  • name: Agent name (normalized, URL-friendly)
  • 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”, “Inactive”)
  • creator: Username/email of the agent creator
  • endpoint: Full API endpoint URL for running the agent
  • usage_count: Total number of times the agent has been invoked
  • last_used: ISO 8601 timestamp of last usage (null if never used)
  • system_prompt: Full system instructions for the agent
  • uncertainty_threshold: Temperature setting (0.0-1.0)
  • conversation_saving_enabled: Whether conversations are saved

Example Response:

{
  "agents": [
    {
      "id": "agent-123",
      "name": "customer_support_bot",
      "description": "Handles customer inquiries",
      "base_model": "nugen-flash-instruct",
      "created_date": "2024-01-15T10:30:00Z",
      "status": "Active",
      "endpoint": "https://api.nugen.in/api/v3/agents/run-agents/customer_support_bot/run",
      "usage_count": 42,
      "last_used": "2024-01-20T15:45:00Z",
      "conversation_saving_enabled": true
    }
  ]
}