---
title: "Agents & deployments"
description: "Operate an agent from the Console — overview, playground, behavior, users, deployments and redeploys, sessions, logs, memory, and agent settings."
---

**Agents** in the Console's sidebar lists every agent in the active scope. **New agent** asks for exactly one thing — a name — creates the agent, and lands you on its overview; the definition itself comes from a deploy ([Studio](/studio/) or [`guuey deploy`](/cli/)).

Workspace agents follow workspace roles: members see these pages read-only; editing needs admin or above.

## Overview

The overview is the agent's front door:

- **Connect your agent** — a guide that walks the required steps (connect a deploy, get a first session), then collapses into a ship-it checklist (embed the widget, publish the listing, configure auth) once the agent works.
- **Live endpoint** — once the latest deploy is live, its endpoint URL sits at the top of the overview with a copy button, next to a **Test in playground** shortcut. Build progress lives on the Deployments tab.
- **Banners that matter** — if the app is on its [7-day trial](/plans-and-billing/#the-7-day-trial), a countdown banner shows here (and on the billing panel). At expiry the platform pauses the app — the pod stops serving — and choosing a plan resumes it within a few minutes, with no redeploy. A failed payment shows its own banner pointing at Billing.

## Playground

Chat with your deployed agent without leaving the Console. The playground talks to the same live endpoint your users reach, so what you see is what they get.

## Behavior

Sectioned configuration for how the agent thinks:

- **System prompt** — comes from your agent's own code today: `agent.systemPrompt` in `guuey.json`, inline or as a file path (see [Agents as code](/agents-as-code/)). A console editor is marked coming soon.
- **Model** — the **per-app BYOK keys** are live: add an Anthropic, OpenAI, or Google key for an agent deployed from code (the CLI's `guuey byok set` also accepts OpenRouter). Choosing the model itself from the Console is marked coming soon — the model comes from your `guuey.json`, or from Studio for no-code agents.
- **Generation, Tool use, Guardrails** — labelled coming soon, with the honest current state spelled out in each panel: every allowed tool runs automatically (the allowlist is the control), and Guuey adds no content-safety pass of its own — your model provider's safety layer and your system prompt are what apply.

Agents built in Studio are edited in Studio — this tab says so and links you there instead of showing dead controls.

## Users

Who may talk to the agent, and who has:

- **Authentication** — three modes: **Anonymous**, **Guuey sign-in**, or **Bring Your Own Auth** (your Auth0/Clerk/Firebase/any-OIDC issuer URL and audience; Guuey verifies your users' tokens against your provider's published keys, and shows the redirect URI to register at your IdP). See [Sign-in on the agent's page](/page-sign-in/) and [Sign in your own users](/surface-identity/) for how each mode reaches your users.
- **Directory** — the real end users who have talked to this agent, aggregated from sessions.

## Deployments

The active build sits on top, the full deploy history below. Each build walks `queued → building → pushing → deploying → live`; older builds become `superseded`, and failures say `failed`.

- **Redeploy** re-runs your most recent deploy server-side — it needs at least one prior deploy, and the button explains itself when disabled (no prior build, or a deploy already in flight).
- **Runtime size** is chosen on the deploy — `guuey deploy --size sm` — not in the Console yet.
- Click a build for its detail page: an Overview tab and the build's **Env** vars; Logs, Artifacts, and Diff tabs are marked "soon" right in the tab strip.

## Sessions, Logs, Memory

- **Sessions** — every conversation, with summary stats (including error rate), filters by status, identified vs anonymous, and date range. Click a session for its event timeline.
- **Logs** — live output from the running agent: pick a time range, search, and auto-follow the tail.
- **Memory** — not in the sidebar: reach it at `/apps/<app-id>/memory`, or from a session's thread-id link. It's the per-user view: a live directory of the agent's end users; browsing a user's threads from the Console is marked coming soon. What the agent actually remembers is described in [State & memory](/state-and-memory/).

## Agent Settings

Sectioned like the rest of the Console; the sidebar shows only sections that apply to the agent's hosting mode:

- **General** — name, description, default shell, welcome prompt, plus **Branding** and the **Standalone page** policy (covered in [Design & distribution](/console-design/)).
- **Deployment** — the app's **pod-count limit** (live — the runtime converges the running deployment onto it, up to your plan's ceiling; see [Plans & billing](/plans-and-billing/)) and its **environment variables**. Runtime size stays a deploy-time flag for now.
- **Tools** — the browser origins allowed to call your agent's endpoint. It's the same list the [embed](/embed/) reads, but with two readers: the endpoint's CORS check treats a bare domain as covering its subdomains, while the widget's frame check matches it to the apex only — see [Allow your site's domain](/embed/#1-allow-your-sites-domain).
- **App ID** — the agent's public identifier, the one you pass to the [SDK](/sdk/).
- **Adapters** — capability labels on the app today; they don't grant or block device access.
- **LLM, Data ownership, Source, Integrations, Webhooks** — coming-soon panels, each stating what to use instead today (BYOK lives under Behavior → Model; there is no webhook dispatcher yet, so poll Sessions or read thread history through the SDK).
- **Danger zone** — transfer the agent to a workspace, or delete it. Deletion stops serving and is **reversible for 30 days**: the settings page grows a restore card with the deadline, and only after that window is it permanent. Workspace apps: only admins can delete.