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

# Troubleshooting Playground

> Resolve common Playground access, response, and session issues

## Quick Diagnostic Flow

```mermaid theme={null}
flowchart TD
    A[Issue Observed] --> B{Access or Response?}
    B -->|Access| C[Check login/session token]
    B -->|Response| D[Check model binding + prompt]
    C --> E[Reload and re-authenticate]
    D --> F[Validate parameters and retry]
    E --> G[Still failing? Contact support]
    F --> G
```

<AccordionGroup>
  <Accordion title="Playground shows access denied">
    **Cause**: Session token is missing or expired.

    **Fix**:

    1. Re-authenticate in Bud Admin.
    2. Refresh the page.
    3. Verify you have permissions for the selected project.
  </Accordion>

  <Accordion title="No response from selected model">
    **Cause**: Incorrect model binding, unavailable endpoint, or invalid settings.

    **Fix**:

    1. Re-select model in the pane.
    2. Retry with default generation settings.
    3. Test with a shorter prompt.
  </Accordion>

  <Accordion title="Responses are inconsistent across retries">
    **Cause**: High temperature or prompt ambiguity.

    **Fix**:

    1. Lower temperature.
    2. Add explicit format constraints.
    3. Use a fixed prompt template for evaluation.
  </Accordion>

  <Accordion title="Chat history is hard to interpret">
    **Cause**: Sessions are not named consistently.

    **Fix**:

    1. Use a standard naming format (task-model-date).
    2. Keep notes on prompt versions and settings.
  </Accordion>
</AccordionGroup>

## When to Escalate

Escalate to platform support when:

* Access failures persist after re-login.
* Multiple models fail across projects.
* Response latency spikes suddenly for previously stable prompts.