Agent Identity

ALM Instance Configuration

The ALM class is the main entry point. Configure your agent identity and versions when initializing:

alm = ALM(
    agent_id="unique-agent-id",       # Required: Unique identifier
    env="production",                 # Environment name
    mode="http",                      # "stdout" or "http"
    endpoint="https://api.example.com",  # Base URL for http mode
    api_key="your-api-key",           # Optional: Authorization header
    agent_version="1.2.3",            # Optional: Agent version
    policy_version="2.0.0",           # Optional: Policy version
)

Version Tracking

All events include version information for drift detection:

• schema_version – Event schema version
• sdk_version – SDK version
• agent_version – Your agent version
• policy_version – Your policy version

Event Correlation

Every event includes a unique event_id (UUID) for idempotency and deduplication. Events within a run share the same run_id.