# DataRobot experimentation plugin

> DataRobot experimentation plugin - Install and use the DataRobot experimentation CLI plugin to
> visualize tracing and run data in a local dashboard.

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-07-08T13:08:31.516611+00:00` (UTC).

## Primary page

- [DataRobot experimentation plugin](https://docs.datarobot.com/en/docs/agentic-ai/cli/experimentation-plugin.html.md): Full documentation for this topic (Markdown sidecar).

## Sections on this page

- [Quick start](https://docs.datarobot.com/en/docs/agentic-ai/cli/experimentation-plugin.html.md#quick-start): In-page section heading.
- [Usage](https://docs.datarobot.com/en/docs/agentic-ai/cli/experimentation-plugin.html.md#usage): In-page section heading.
- [Environment variable fallbacks](https://docs.datarobot.com/en/docs/agentic-ai/cli/experimentation-plugin.html.md#environment-variable-fallbacks): In-page section heading.
- [Supported entity types](https://docs.datarobot.com/en/docs/agentic-ai/cli/experimentation-plugin.html.md#supported-entity-types): In-page section heading.

## Related documentation

- [Agentic AI](https://docs.datarobot.com/en/docs/agentic-ai/index.html.md): Linked from this page.
- [CLI](https://docs.datarobot.com/en/docs/agentic-ai/cli/index.html.md): Linked from this page.

## Documentation content

The DataRobot experimentation plugin is tooling that lets you view traces without leaving your local environment. It bridges local development and the DataRobot platform by bringing tracing and observability tools directly into your workspace, eliminating the need to deploy to the platform just to test agent behavior. The result is a shorter iteration cycle when building agentic applications: immediate insight into traces, logs, and spans without breaking your local development flow.

The plugin integrates with the DataRobot CLI as `dr xp` and runs a local dashboard for visualizing DataRobot tracing and run data. Use it to facilitate early-stage agent development.

## Quick start

```
# Install the plugin
dr plugin install xp

# Show available options
dr xp --help

# Start with a Use Case (the default entity type)
dr xp --entity-id <use-case-id>

# Start with a deployment on a custom port
dr xp --entity-type deployment --entity-id <deployment-id> --port 8091
```

## Usage

```
dr xp --entity-type [TYPE] --entity-id [ID] --port [PORT]
```

The server runs in the foreground and logs to your terminal. Stop it with `Ctrl+C`.

- --entity-id is required (falls back to DATAROBOT_USE_CASE_ID in pulumi_config.json if present).
- --entity-type defaults to Use Case ( use_case ). Also accepts the internal name experiment_container .
- Value precedence: flag > environment variable > config file ( .dr-xp.yaml ) > pulumi_config.json > default.

### Environment variable fallbacks

Add these variables to the `.env` file as needed.

- DR_EXPERIMENT_ENTITY_TYPE (default: use_case )
- DR_EXPERIMENT_ENTITY_ID
- DR_EXPERIMENT_PORT (default: 8090 )

## Supported entity types

| Entity type | Description |
| --- | --- |
| experiment_container (alias: use_case) | Use case experiment container (default). |
| deployment | Model deployment. |
| custom_application | Custom application. |
| workload | Workload. |