academy.identifier

academy/identifier.py

EntityId module-attribute

EntityId = AgentId[Any] | UserId

EntityId union type for type annotations.

AgentId pydantic-model

Bases: BaseModel, Generic[AgentT]

Unique identifier for an agent entity in a multi-agent system.

Config:

• extra: forbid
• frozen: True
• validate_default: True

Fields:

• uid (UUID)
• name (str | None)
• role (Literal['agent'])

new classmethod

new(name: str | None = None) -> Self

Create a new identifier.

Parameters:

• name (str | None, default: None ) –

  Optional human-readable name for the entity.

Source code in academy/identifier.py

@classmethod
def new(cls, name: str | None = None) -> Self:
    """Create a new identifier.

    Args:
        name: Optional human-readable name for the entity.
    """
    return cls(uid=uuid.uuid4(), name=name)

UserId pydantic-model

Bases: BaseModel

Unique identifier for a user entity in a multi-agent system.

Config:

• extra: forbid
• frozen: True
• validate_default: True

Fields:

• uid (UUID)
• name (str | None)
• role (Literal['user'])

new classmethod

new(name: str | None = None) -> Self

Create a new identifier.

Parameters:

• name (str | None, default: None ) –

  Optional human-readable name for the entity.

Source code in academy/identifier.py

@classmethod
def new(cls, name: str | None = None) -> Self:
    """Create a new identifier.

    Args:
        name: Optional human-readable name for the entity.
    """
    return cls(uid=uuid.uuid4(), name=name)