playground.mdx

title	Playground

Playground is an interactive sandbox to experiment with prompts, models, and tools—either from scratch or directly from traced spans.

What You Can Do

• Prompt experimentation: Test prompt variations and inputs with instant results.
• Open from spans: Reproduce exact configurations from any span with Open in Playground.
• Tool integration: Configure and test custom tools that models can call.
• Session history: Review and replay past runs with full context.

To access the playground:

1. In the Laminar dashboard, click New playground.
2. Choose a model and start experimenting—or open directly from a span.

Start from Scratch

• Create a new playground to iterate quickly.
• Send requests, view responses, and compare outputs side by side.
• Save versions to revisit later.

Start from a Span

Click Open in Playground on any LLM span; the playground inherits:

• Model settings (model, temperature, token limits, thinking tokens)
• Images and input formatting
• Tools and tool configuration
• System prompts and message history

This removes the need to recreate complex requests—tweak and rerun immediately.

Tools

Add tools so models can call functions during a session. Tools are defined as JSON with function names, descriptions, and parameter schemas; choose when tools are allowed (none, auto, required, or a specific function).

Example tool config

{
  "searchDatabase": {
    "description": "Search for information in the company database",
    "parameters": {
      "type": "object",
      "properties": {
        "query": { "type": "string", "description": "Search query or keywords" },
        "category": {
          "type": "string",
          "enum": ["users", "orders", "products"],
          "description": "Database category to search"
        },
        "limit": {
          "type": "number",
          "description": "Maximum number of results to return",
          "default": 10
        }
      },
      "required": ["query", "category"]
    }
  }
}

Learn more about tool choice options in the AI SDK documentation.

History

Every playground run is saved. The History tab shows:

• Full conversations (prompts and responses)
• Model configurations (model, temperature, tokens, etc.)
• Tool calls with inputs/outputs
• Performance metrics (latency, tokens, cost)
• Timestamps for each run

Open any past run to review, compare, or duplicate it for new experiments.