Agent Module

This module provides the core classes and data model of the agent.

Core Classes

AgentBase

PersonAgent

AgentBase directly owns generic capabilities such as workspace binding, the skill runtime, ReAct tool loop, TODO state, trace, and AGENT.json persistence. PersonAgent is a thin orchestrator on top that only implements person-oriented behavior. Agents are no longer constructed by passing parameters to __init__; instead, AgentBase.create() writes the workspace once and await AgentBase.from_workspace(path, service_proxy) rebuilds the agent (see Using Agents).

If you only want to extend agent behavior, prefer adding or modifying an Agent Skill; only inherit from AgentBase / PersonAgent to create a new class when you need to change the agent lifecycle, state machine, or external system interaction patterns. See Agent Skills for the skill system design guide, and see Skills Module for the API reference.