GET
/
agent
/
status
/
{agent_id}
Python (SDK)
import os
from skylight_sdk import Skylight


with Skylight(
    apikey=os.getenv("SKYLIGHT_APIKEY", ""),
) as skylight:

    res = skylight.agent.status(agent_id="<id>")

    # Handle response
    print(res)
{
  "agent_id": "agent-123456",
  "agent_status": "running",
  "created_at": "2023-01-01T12:00:00Z",
  "files": [
    {
      "description": "Downloaded PDF",
      "filename": "C:/Users/Dekstop/document.pdf",
      "timestamp": "2023-01-01T12:00:00Z"
    }
  ],
  "final_summary": "Successfully completed all tasks",
  "human_input_request": {
    "context": "I found a 2GB file that matches your search criteria",
    "question": "Would you like me to download this large file?",
    "timestamp": "2023-01-01T12:05:00Z"
  },
  "is_running": true,
  "query": "Find and download information about Windows",
  "step_count": 5,
  "steps": [
    "Step 1: Search for information",
    "Step 2: Download file"
  ],
  "total_steps": 5
}

Authorizations

X-API-Key
string
header
required

API key authentication

Path Parameters

agent_id
string
required

Response

Agent status retrieved

agent_status
string
required

Current status of the agent

Example:

"running"

is_running
boolean
required

Whether the agent is currently running

Example:

true

total_steps
integer
required

Total number of steps executed

Example:

5

files
Files · object[]
required

List of files downloaded by the agent

messages
string[]
required

List of steps executed by the agent

created_at
string
required

Timestamp when the agent was created

query
string
required

Original query given to the agent

agent_id
string
required

Unique identifier for the agent

final_summary
string | null

Final summary of agent execution

human_input_request
object | null

Information about the human input being requested, if agent is waiting