Get Agent System Prompt
Agents
Get Agent System Prompt
Retrieve the complete system prompt and configuration for an agent.
This endpoint returns the full system prompt that defines the agent’s behavior, including its instructions, model configuration, and other parameters.
Path Parameters:
agent_id: Unique identifier of the agent
Returns:
data: Agent prompt data object with the following fields:system_prompt: Complete system prompt with instructions and demonstrationsmodel: Model ID used by the agenttemperature: Sampling temperature setting (0.0-2.0)agent_name: Name of the agentagent_description: Description of the agent
Raises:
404: Agent not found or doesn’t belong to the user
Example Request:
GET /api/v3/agents/agent-abc123/prompt
Headers: {"Authorization": "Bearer <api_key>"}
Example Response:
{
"data": {
"system_prompt": "You are a helpful customer support agent. Be empathetic and solution-oriented.
Examples:
User: How do I reset my password?
Assistant: I'd be happy to help you reset your password...",
"model": "nugen-flash-instruct",
"temperature": 0.7,
"agent_name": "customer_support_bot",
"agent_description": "Handles customer inquiries with empathy"
}
}
Notes:
- The system prompt includes both instructions and demonstrations formatted together
- Use this endpoint to inspect the complete prompt before running the agent
- The prompt may contain few-shot examples if demonstrations were provided during creation
GET
Get Agent System Prompt
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Response
Returns the complete system prompt and configuration for a specific agent, including instructions, demonstrations, and model settings
Response model for agent system prompt endpoint.
Agent prompt data model