> ## 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.

# Browser Integration

> Open collections, rubrics, and results in the Docent web UI

The SDK can open Docent web pages directly in your default browser — useful when
working in notebooks or scripts.

## Open an Agent Run

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

client = Docent()

url = client.open_agent_run("my-collection-id", "run-id-123")
# Opens browser to the agent run detail page
print(url)
```

### Parameters

<ParamField body="collection_id" type="str" required>
  ID of the collection containing the run.
</ParamField>

<ParamField body="agent_run_id" type="str" required>
  ID of the agent run to open.
</ParamField>

### Returns

<ResponseField name="url" type="str">
  The URL that was opened.
</ResponseField>

***

## Open a Rubric

Open a rubric page, optionally focused on a specific agent run or judge result.

```python theme={null}
# Rubric overview
client.open_rubric("my-collection-id", "rubric-123")

# Specific agent run within the rubric
client.open_rubric("my-collection-id", "rubric-123", agent_run_id="run-456")

# Specific judge result
client.open_rubric(
    "my-collection-id",
    "rubric-123",
    agent_run_id="run-456",
    judge_result_id="result-789",
)
```

### Parameters

<ParamField body="collection_id" type="str" required>
  ID of the collection.
</ParamField>

<ParamField body="rubric_id" type="str" required>
  ID of the rubric.
</ParamField>

<ParamField body="agent_run_id" type="str | None">
  Optional agent run to focus on within the rubric view.
</ParamField>

<ParamField body="judge_result_id" type="str | None">
  Optional judge result to focus on. Requires `agent_run_id`.
</ParamField>

***

## Open a Result Set

```python theme={null}
url = client.open_result_set("my-collection-id", "analysis/experiment_1")
```

### Parameters

<ParamField body="collection_id" type="str" required>
  ID of the collection.
</ParamField>

<ParamField body="name_or_id" type="str" required>
  Name or UUID of the result set.
</ParamField>

***

## Start a Chat

Create an interactive chat session with agent runs or transcripts as context, and open it
in the browser.

```python theme={null}
run1 = client.get_agent_run("my-collection-id", "run-1")
run2 = client.get_agent_run("my-collection-id", "run-2")

session_id = client.start_chat([run1, run2])
# Opens browser to chat UI with both runs as context
```

### Parameters

<ParamField body="context" type="LLMContext | list[AgentRun | Transcript]" required>
  Objects to include as chat context. Can be a list of `AgentRun` or `Transcript`
  instances, or a pre-built `LLMContext`.
</ParamField>

<ParamField body="model_string" type="str | None">
  Optional model to use, in `"provider/model_name"` format.
</ParamField>

<ParamField body="reasoning_effort" type="Literal['minimal', 'low', 'medium', 'high'] | None">
  Optional reasoning effort hint passed to the LLM provider.
</ParamField>

### Returns

<ResponseField name="session_id" type="str">
  The session ID of the created chat session.
</ResponseField>