Get Agent

Retrieve detailed information about a specific agent.

This endpoint fetches complete configuration and metadata for an agent owned by the user.

Path Parameters:

• agent_id: Unique identifier of the agent to retrieve

Returns:

• data: Agent data object with the following fields:
  • 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”)
  • 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)
  • performance_metrics: Performance statistics
  • system_prompt: Full system instructions for the agent
  • uncertainty_threshold: Temperature setting (0.0-1.0)
  • conversation_saving_enabled: Whether conversations are saved

Raises:

• 404: Agent not found, inactive, or doesn’t belong to the user

Example Request:

GET /api/v3/agents/agent-abc123
Headers: {"Authorization": "Bearer <api_key>"}

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": 42,
    "last_used": "2024-01-20T15:45:00Z",
    "performance_metrics": {
      "total_requests": 42,
      "average_response_time": 1250,
      "success_rate": 0.98
    },
    "system_prompt": "You are a helpful customer support agent. Be empathetic and solution-oriented.",
    "uncertainty_threshold": 0.7,
    "conversation_saving_enabled": true
  }
}

Notes:

• Includes complete agent configuration and usage statistics
• Use this endpoint to get full details before updating an agent