Agno · Schema

RunSchema

AI AgentsMulti-Agent SystemsPython FrameworkLLMMachine LearningAgentic AIOpen SourceAgent Runtime

Properties

Name Type Description
run_id string Unique identifier for the run
parent_run_id object Parent run ID if this is a nested run
agent_id object Agent ID that executed this run
user_id object User ID associated with the run
status object Run status (PENDING, RUNNING, COMPLETED, ERROR, etc.)
run_input object Input provided to the run
content object Output content from the run
run_response_format object Format of the response (text/json)
reasoning_content object Reasoning content if reasoning was enabled
reasoning_steps object List of reasoning steps
metrics object Performance and usage metrics
messages object Message history for the run
tools object Tools used in the run
events object Events generated during the run
created_at object Run creation timestamp
references object References cited in the run
citations object Citations from the model (e.g., from Gemini grounding/search)
reasoning_messages object Reasoning process messages
session_state object Session state at the end of the run
images object Images included in the run
videos object Videos included in the run
audio object Audio files included in the run
files object Files included in the run
response_audio object Audio response if generated
input_media object Input media attachments
View JSON Schema on GitHub

JSON Schema

agno-run-schema.json Raw ↑
{
  "properties": {
    "run_id": {
      "type": "string",
      "title": "Run Id",
      "description": "Unique identifier for the run"
    },
    "parent_run_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Parent Run Id",
      "description": "Parent run ID if this is a nested run"
    },
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Agent Id",
      "description": "Agent ID that executed this run"
    },
    "user_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "User Id",
      "description": "User ID associated with the run"
    },
    "status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Status",
      "description": "Run status (PENDING, RUNNING, COMPLETED, ERROR, etc.)"
    },
    "run_input": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Run Input",
      "description": "Input provided to the run"
    },
    "content": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Content",
      "description": "Output content from the run"
    },
    "run_response_format": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Run Response Format",
      "description": "Format of the response (text/json)"
    },
    "reasoning_content": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Reasoning Content",
      "description": "Reasoning content if reasoning was enabled"
    },
    "reasoning_steps": {
      "anyOf": [
        {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Reasoning Steps",
      "description": "List of reasoning steps"
    },
    "metrics": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Metrics",
      "description": "Performance and usage metrics"
    },
    "messages": {
      "anyOf": [
        {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Messages",
      "description": "Message history for the run"
    },
    "tools": {
      "anyOf": [
        {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Tools",
      "description": "Tools used in the run"
    },
    "events": {
      "anyOf": [
        {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Events",
      "description": "Events generated during the run"
    },
    "created_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Created At",
      "description": "Run creation timestamp"
    },
    "references": {
      "anyOf": [
        {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "References",
      "description": "References cited in the run"
    },
    "citations": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Citations",
      "description": "Citations from the model (e.g., from Gemini grounding/search)"
    },
    "reasoning_messages": {
      "anyOf": [
        {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Reasoning Messages",
      "description": "Reasoning process messages"
    },
    "session_state": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Session State",
      "description": "Session state at the end of the run"
    },
    "images": {
      "anyOf": [
        {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Images",
      "description": "Images included in the run"
    },
    "videos": {
      "anyOf": [
        {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Videos",
      "description": "Videos included in the run"
    },
    "audio": {
      "anyOf": [
        {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Audio",
      "description": "Audio files included in the run"
    },
    "files": {
      "anyOf": [
        {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Files",
      "description": "Files included in the run"
    },
    "response_audio": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Response Audio",
      "description": "Audio response if generated"
    },
    "input_media": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Input Media",
      "description": "Input media attachments"
    }
  },
  "type": "object",
  "required": [
    "run_id"
  ],
  "title": "RunSchema",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}