Sending Meter Events

value.send_action(
    agent_key="agent_abc123xyz",
    action_type="llm_call",
    metadata={
        "model": "gpt-4",
        "input_tokens": 1000,
        "output_tokens": 500,
        "cost_usd": 0.06,
        "latency_ms": 1250
    }
)

value.send_outcome(
    agent_key="agent_abc123xyz",
    outcome_type="successful_hire",
    value=1,
    metadata={
        "candidate_id": "cand_123",
        "position": "Software Engineer",
        "salary": 120000
    }
)

value.send_action(
    agent_key="agent_abc123xyz",
    action_type="llm_call",
    metadata={
        "model": "gpt-4",
        "provider": "openai",
        "input_tokens": 1000,
        "output_tokens": 500,
        "temperature": 0.7,
        "max_tokens": 2000,
        "cost_usd": 0.06,
        "latency_ms": 1250
    }
)

value.send_action(
    agent_key="agent_abc123xyz",
    action_type="tool_call",
    metadata={
        "tool_name": "stripe_api",
        "endpoint": "create_payment",
        "cost_usd": 0.05,
        "success": True
    }
)

value.send_action(
    agent_key="agent_abc123xyz",
    action_type="custom_action",
    metadata={
        "customer_id": "cust_123",
        "workflow_id": "wf_456",
        "custom_field": "custom_value",
        "any_data": {"nested": "structure"}
    }
)

actions = [
    {
        "agent_key": "agent_abc123xyz",
        "action_type": "llm_call",
        "metadata": {...}
    },
    {
        "agent_key": "agent_abc123xyz",
        "action_type": "tool_call",
        "metadata": {...}
    }
]

value.send_actions(actions)

await value.send_action(
    agent_key="agent_abc123xyz",
    action_type="llm_call",
    metadata={...}
)

try:
    value.send_action(
        agent_key="agent_abc123xyz",
        action_type="llm_call",
        metadata={...}
    )
except ValueError as e:
    # Invalid parameters
    print(f"Invalid action: {e}")
except ConnectionError as e:
    # Network error - event is buffered locally
    print(f"Connection error: {e}")
except Exception as e:
    # Other errors
    print(f"Error: {e}")