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

# SDK Overview

> Install and get started with the Docent Python SDK

The Docent Python SDK provides a high-level interface for logging, querying, and analyzing AI agent traces.

## Installation

```bash theme={null}
pip install docent-python
```

Requires Python 3.11 or higher.

## Quick Example

```python theme={null}
from docent import Docent

client = Docent(api_key="your-api-key")

# Create a collection
collection_id = client.create_collection(name="My Agent Runs")

# Query with DQL
result = client.execute_dql(collection_id, "SELECT id, name, metadata_json->>'model' AS model FROM agent_runs LIMIT 5")
rows = client.dql_result_to_dicts(result)
```

## What You Can Do

<CardGroup cols={2}>
  <Card title="Collections" icon="folder" href="/sdk/collections/manage">
    Create and manage collections of agent runs
  </Card>

  <Card title="Agent Runs" icon="play" href="/sdk/agent-runs/query">
    Query, retrieve, and manage agent run data
  </Card>

  <Card title="Rubrics & Evaluation" icon="scale-balanced" href="/sdk/rubrics/manage">
    Define rubrics, create judges, and run evaluations
  </Card>

  <Card title="DQL" icon="magnifying-glass" href="/sdk/dql/execute">
    Query your data with the Docent Query Language
  </Card>

  <Card title="Feedback & Labels" icon="tag" href="/sdk/feedback/labels">
    Annotate runs with labels, tags, and comments
  </Card>

  <Card title="Tracing" icon="route" href="/ingestion/tracing">
    Automatically capture LLM interactions
  </Card>
</CardGroup>

## Typical Workflow

1. **Create a collection** to organize your agent runs
2. **Ingest agent runs** via tracing, the SDK, or file upload
3. **Create rubrics** to define evaluation criteria
4. **Run evaluations** with LLM judges
5. **Query results** with DQL and export to DataFrames

## Next Steps

* [Authentication & Configuration](/sdk/authentication) — set up your API key and environment
* [Client Reference](/sdk/client) — full constructor documentation