> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# obs • AI Agent SDK

> Observability interface for PraisonAI Agents.

# obs

<Badge color="blue">AI Agent</Badge>

Observability interface for PraisonAI Agents.

This module provides the protocol and types for observability/tracing.
Implementations are provided by the wrapper layer (praisonai\_tools.observability).

Usage (simplest - recommended):
from praisonaiagents import Agent, obs

agent = Agent(
name="Assistant",
observability=obs.auto(),  # Auto-detect from env vars
)
agent.chat("Hello!")  # Auto-traces to configured provider

Alternative (explicit provider):
observability=obs.langfuse()     # Langfuse
observability=obs.langsmith()    # LangSmith
observability=obs.agentops()     # AgentOps
observability=obs.arize()        # Arize Phoenix
observability=obs.datadog()      # Datadog

## Import

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import obs
```

## Classes

<CardGroup cols={2}>
  <Card title="Span" icon="brackets-curly" href="../classes/Span">
    Represents a span in a trace.
  </Card>

  <Card title="Trace" icon="brackets-curly" href="../classes/Trace">
    Represents a complete trace.
  </Card>

  <Card title="ObservabilityAdapter" icon="brackets-curly" href="../classes/ObservabilityAdapter">
    Protocol for observability adapters.
  </Card>
</CardGroup>
