Playground Integration
When creating or editing a Playground, you can attach a Stored Agent so its credentials are automatically injected into the agent sidecar container.
How to Attach
- In the Playground form, select an Agent Provider
- A Stored Agent dropdown appears, listing your authenticated agents for that provider
- Select the agent — its credentials are automatically injected into the sidecar at deploy time
The agent sidecar runs alongside your other services and is accessible at its own subdomain: agent-{project}.{domain}.
Validations
| Rule | Description |
|---|---|
| Ownership | The Stored Agent must belong to you (prevents unauthorized access) |
| Provider match | The Stored Agent's provider must match the selected agent provider type |
| Authentication | The agent must be in authenticated status to be selectable |
How It Works
When a Playground with an attached Stored Agent is deployed:
- The platform reads the encrypted credentials from the agent record
- Credentials and configuration items (System Prompt, Custom MCP, Avatar) are injected into the agent sidecar container
- The agent sidecar starts with your configuration pre-loaded — no manual setup needed
Because these are your personal subscription credentials, all AI usage runs against your own provider quota — not any platform-provided tokens.
Next Steps
To see what your attached agent is doing during a deployment, check out Agent Artefacts and Activity.